SOLFIND
Web Lens
Portal home

GitHub - MCPJam/inspector: Testing and evaluation platform to chat, inspect, and debug MCP servers, MCP apps, and ChatGPT apps. · GitHub

https://github.com/MCPJam/inspector • 382 KB fetched
Open original page


GitHub - MCPJam/inspector: Testing and evaluation platform to chat, inspect, and debug MCP servers, MCP apps, and ChatGPT apps. · GitHub Skip to content Navigation Menu Sign in Appearance settings * Platform * AI CODE CREATION * GitHub Copilot Write better code with AI * GitHub Copilot app Direct agents from issue to merge * MCP Registry Integrate external tools * DEVELOPER WORKFLOWS * Actions Automate any workflow * Codespaces Instant dev environments * Issues Plan and track work * Code Review Manage code changes * Code Quality Enforce quality at merge * APPLICATION SECURITY * GitHub Advanced Security Find and fix vulnerabilities * Code security Secure your code as you build * Secret protection Stop leaks before they start * EXPLORE * Why GitHub * Documentation * Blog * Changelog * Marketplace View all features * Solutions * BY COMPANY SIZE * Enterprises * Small and medium teams * Startups * Nonprofits * BY USE CASE * App Modernization * DevSecOps * DevOps * CI/CD * View all use cases * BY INDUSTRY * Healthcare * Financial services * Manufacturing * Government * View all industries View all solutions * Resources * EXPLORE BY TOPIC * AI * Software Development * DevOps * Security * View all topics * EXPLORE BY TYPE * Customer stories * Events & webinars * Ebooks & reports * Business insights * GitHub Skills * SUPPORT & SERVICES * Documentation * Customer support * Community forum * Trust center * Partners View all resources * Open Source * COMMUNITY * GitHub Sponsors Fund open source developers * PROGRAMS * Security Lab * Maintainer Community * GitHub Stars * Archive Program * REPOSITORIES * Topics * Trending * Collections * Enterprise * ENTERPRISE SOLUTIONS * Enterprise platform AI-powered developer platform * AVAILABLE ADD-ONS * GitHub Advanced Security Enterprise-grade security features * Copilot for Business Enterprise-grade AI features * Premium Support Enterprise-grade 24/7 support * Pricing Search / Sign in Sign up Appearance settings You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert Uh oh! There was an error while loading. Please reload this page . MCPJam / inspector Public * Uh oh! There was an error while loading. Please reload this page . * Notifications You must be signed in to change notification settings * Fork 275 * Star 2.2k * Code * Issues 51 * Pull requests 242 * Discussions * Actions * Projects * Security and quality 1 * Insights Additional navigation options * Code * Issues * Pull requests * Discussions * Actions * Projects * Security and quality * Insights main Branches Tags Go to file Code Open more actions menu Latest commit   History 5,697 Commits 5,697 Commits Folders and files Name Name Last commit message Last commit date .changeset .changeset     .github .github     .release-plan .release-plan     .spike-codex-appserver .spike-codex-appserver     chat-ui chat-ui     cli cli     design-explorations design-explorations     design-system design-system     discord-app discord-app     docs docs     examples examples     mcp mcp     mcpjam-inspector mcpjam-inspector     ops/ axiom-monitors ops/ axiom-monitors     scripts scripts     sdk sdk     skills skills     slack-app slack-app     soundcheck soundcheck     surface-core surface-core     vitest vitest     widget-react widget-react     .gitattributes .gitattributes     .gitignore .gitignore     AGENTS.md AGENTS.md     CONTRIBUTING.md CONTRIBUTING.md     DESIGN.md DESIGN.md     LICENSE LICENSE     NOTES-item-2.md NOTES-item-2.md     NOTES-item-3.md NOTES-item-3.md     README.md README.md     SECURITY.md SECURITY.md     package-lock.json package-lock.json     package.json package.json     railway.json railway.json     View all files Repository files navigation * * README * Contributing * License * Security More items MCPJam Hosted app  ·  Docs  ·  Website MCPJam is the open-source testing & evaluations platform for MCP server developers who ship. Interactively test tools, prompts, resources, and authorization across 16 client configurations and 170+ models. Run evals on test cases, get insights on what's breaking, and gate regressions to secure every deployment. 🚀 Quick start Open the hosted app. No install needed. 👉 app.mcpjam.com ... or run MCPJam locally for HTTP/S and local STDIO servers: npx @mcpjam/inspector@latest 👋🏽 Why MCPJam Clients like ChatGPT, Claude, and Cursor all read your server differently. MCPJam catches those differences, shows where your server breaks, and tells you how to fix it: * Inspect & debug : Explore your server's tools, resources, and prompts in one place. Test prompts from real LLMs, with full visibility & traces on every JSON-RPC message and OAuth exchange. * Cross-client evals : Score agent behavior across 16 client configurations — ChatGPT, Claude, Cursor, Copilot, and more — to understand how your MCP integrations perform across all users. Track accuracy, latency, and tool-call performance over time. * Security & reliability : Automate conformance & behavior checks in CI/CD to catch regressions before they reach production. 🔨 Features Capability What it does Playground Cross-client chat interface that emulates UIs, tool calls, and skills (with full traces). OpenAI Apps SDK and MCP app UIs, text tools, and a Chrome DevTools-style widget emulator. Read more Chat Multi-server chat on frontier models for free, or bring your own API key. Compare up to 3 models side by side. Read more OAuth Debugger Visualize your OAuth & EMA requests step-by-step to find the source of errors. Guided MCP OAuth conformance checks across protocol versions 03-26, 06-18, 11-25, and 2026-07-28; DCR, client pre-registration, and CIMD. Read more Server Debugging Manually run tools, resources, templates, prompts, and elicitation flows with full JSON-RPC logs. Skills Extend models with reusable behaviors in Chat and Playground. Local skills are read from your filesystem and never leave your machine; a project can also carry hosted skills, available on accounts where that is enabled. Read more Workspaces Shared server groups with real-time team sync, so everyone tests the same config. Read more Evals Test cases with expected tool calls, run across LLMs, with accuracy metrics over time. Read more CLI Probe servers, run doctor checks, exercise OAuth, and list tools/resources/prompts from your terminal. Read more SDK Programmatically drive inspections, snapshot capabilities, and assert on tool/resource shapes from your own tests. Read more CI/CD Run conformance, E2E tests, evals, and OAuth checks on every PR in GitHub Actions or any pipeline. Read more Playground Debug your server against a model using tool calls or in-panel chat, with Chat, Trace, and Raw views. Supports the OpenAI Apps SDK and MCP app UIs, text tools, and a Chrome DevTools-style widget emulator so you can iterate on widgets locally. * Invoke a tool to render its widget instantly, or drive your server with an LLM. * Watch all JSON-RPC and window.openai messages in the logs. * Switch the emulator between Desktop, Tablet, and Mobile. * Test locale changes, CSP permissions, light/dark mode, hover & touch, and safe-area insets. Trace view: every tool call, agent step, and JSON-RPC message in one timeline. Chat Multi-server chat on frontier models for free, or bring your own API key. Chat, Trace, and Raw views; compare up to 3 models side by side and watch each server's token usage. OAuth Debugger Guided MCP OAuth conformance checks with step-by-step explanations. Test against every version of the OAuth spec (2025-03-26, 2025-06-18, 2025-11-25, and the 2026-07-28 draft), with support for client pre-registration, Dynamic Client Registration (DCR), and Client ID Metadata Documents (CIMD). Server Debugging Everything you need to test an MCP server by hand: run tools, resources, resource templates, prompts, and elicitation flows with full JSON-RPC observability. Every feature of the original inspector, and more. Skills Use Skills in Chat and Playground to extend models with reusable behaviors. Local skills are read from your filesystem and never leave your machine; a project can also carry hosted skills, available on accounts where that is enabled. Read more Workspaces Group servers into shared workspaces with real-time team sync, so everyone on your team tests against the same configuration. Read more Evals Define test cases with expected tool calls and run them across multiple LLMs. Track accuracy over time to catch regressions early and improve your server with every iteration. Read more CLI Run MCPJam from the terminal for fast local dev loops and CI. Probe servers, run OAuth checks, inspect tools and resources, and execute evals without leaving your shell. Read more SDK Programmatic access to MCPJam for custom tooling, scripting, and integrations. Build your own workflows on top of MCPJam's inspection and evaluation primitives. Read more CI/CD Wire MCPJam into GitHub Actions, GitLab CI, or any CI system to run conformance, E2E tests, and evals on every PR — and catch MCP server regressions before they ship. Read more 🔌 Install MCPJam Inspector runs three ways: a hosted web app, a desktop app for Mac and Windows, or via your terminal. The web app is HTTPS-only and has no install. Terminal and Desktop support HTTP/S and local STDIO servers. Node.js 20+ is only required for the terminal install ( npx ). The hosted and desktop apps have no local runtime requirements. Hosted web app : Open app.mcpjam.com . No install, always latest, and you can share server links with teammates like a Google Doc. HTTPS server URLs only; no STDIO, tunneling, skills, or tasks (those need the local inspector). Hosted docs Desktop app : Download the installer. Supports HTTP/S and local STDIO, no Node.js required. Install Mac · Install Windows Terminal : Supports HTTP/S and local STDIO. Open the printed localhost URL after it starts. npx @mcpjam/inspector@latest Docker : There is no published image, so build one from source first. Bound to localhost for security. Available at http://127.0.0.1:6274 . Always use -p 127.0.0.1:6274:6274 (not -p 6274:6274 ) to keep the inspector local-only. On macOS/Windows, reach host MCP servers via http://host.docker.internal:PORT . git clone https://github.com/MCPJam/inspector.git cd inspector docker build -t mcpjam/mcp-inspector:local -f mcpjam-inspector/Dockerfile . docker run -p 127.0.0.1:6274:6274 mcpjam/mcp-inspector:local 👨‍💻 Contributing We're grateful you're considering it. Read the contributing guide to get started, and come say hi in Discord . 🌍 Community & links Website · Blog · Pricing · Docs · Discord · 𝕏 (Twitter) · LinkedIn 📄 License Licensed under the Apache License 2.0 . See LICENSE . About Testing and evaluation platform to chat, inspect, and debug MCP servers, MCP apps, and ChatGPT apps. www.mcpjam.com/ Topics anthropic chatgpt cicd debugger evals evaluation inspector mcp mcp-apps mcp-clients mcp-inspector mcp-server mcp-tools modelcontextprotocol oauth oauth2 openai openai-apps-sdk opensource tracing Resources Readme License Contributing Contributing Security policy Security policy Activity Custom properties Stars 2.2k stars Watchers 12 watching Forks 275 forks Report repository Sponsor this project Used by Contributors Languages Footer (c) 2026 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Community * Docs * Contact * Manage cookies * Do not share my personal information You can’t perform that action at this time.

Links found on this page

  1. Skip to content [direct]
  2. Sign in [direct]
  3. GitHub Copilot Write better code with AI [direct]
  4. GitHub Copilot app Direct agents from issue to merge [direct]
  5. MCP Registry Integrate external tools [direct]
  6. Actions Automate any workflow [direct]
  7. Codespaces Instant dev environments [direct]
  8. Issues Plan and track work [direct]
  9. Code Review Manage code changes [direct]
  10. Code Quality Enforce quality at merge [direct]
  11. GitHub Advanced Security Find and fix vulnerabilities [direct]
  12. Code security Secure your code as you build [direct]
  13. Secret protection Stop leaks before they start [direct]
  14. Why GitHub [direct]
  15. Documentation [direct]
  16. Blog [direct]
  17. Changelog [direct]
  18. Marketplace [direct]
  19. View all features [direct]
  20. Enterprises [direct]
  21. Small and medium teams [direct]
  22. Startups [direct]
  23. Nonprofits [direct]
  24. App Modernization [direct]
  25. DevSecOps [direct]
  26. DevOps [direct]
  27. CI/CD [direct]
  28. View all use cases [direct]
  29. Healthcare [direct]
  30. Financial services [direct]
  31. Manufacturing [direct]
  32. Government [direct]
  33. View all industries [direct]
  34. View all solutions [direct]
  35. AI [direct]
  36. Software Development [direct]
  37. DevOps [direct]
  38. Security [direct]
  39. View all topics [direct]
  40. Customer stories [direct]
  41. Events & webinars [direct]
  42. Ebooks & reports [direct]
  43. Business insights [direct]
  44. GitHub Skills [direct]
  45. Customer support [direct]
  46. Community forum [direct]
  47. Trust center [direct]
  48. Partners [direct]
  49. View all resources [direct]
  50. GitHub Sponsors Fund open source developers [direct]
  51. Security Lab [direct]
  52. Maintainer Community [direct]
  53. GitHub Stars [direct]
  54. Archive Program [direct]
  55. Topics [direct]
  56. Trending [direct]
  57. Collections [direct]
  58. Copilot for Business Enterprise-grade AI features [direct]
  59. Premium Support Enterprise-grade 24/7 support [direct]
  60. Pricing [direct]
  61. Sign up [direct]
  62. MCPJam [direct]
  63. Notifications [direct]
  64. Issues 51 [direct]
  65. Pull requests 242 [direct]
  66. Discussions [direct]
  67. Actions [direct]
  68. Projects [direct]
  69. Security and quality 1 [direct]
  70. Insights [direct]
  71. Branches [direct]
  72. Tags [direct]
  73. 5,697 Commits [direct]
  74. .changeset [direct]
  75. .github [direct]
  76. .release-plan [direct]
  77. .spike-codex-appserver [direct]
  78. chat-ui [direct]
  79. cli [direct]
  80. design-explorations [direct]