{"id":34040306,"url":"https://github.com/mcpjam/inspector","last_synced_at":"2026-06-09T08:01:17.336Z","repository":{"id":295106421,"uuid":"989134268","full_name":"MCPJam/inspector","owner":"MCPJam","description":"Testing and evaluation platform to chat, inspect, and debug MCP servers, MCP apps, and ChatGPT apps.","archived":false,"fork":false,"pushed_at":"2026-06-03T00:14:11.000Z","size":144208,"stargazers_count":1984,"open_issues_count":187,"forks_count":233,"subscribers_count":12,"default_branch":"main","last_synced_at":"2026-06-03T00:17:53.338Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://www.mcpjam.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"modelcontextprotocol/inspector","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MCPJam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["mcpjam"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2025-05-23T15:56:00.000Z","updated_at":"2026-06-02T22:52:18.000Z","dependencies_parsed_at":"2026-02-18T03:06:53.717Z","dependency_job_id":"46f1c476-84a6-47e4-bb18-1f72fbca64de","html_url":"https://github.com/MCPJam/inspector","commit_stats":null,"previous_names":["mcpjam/inspector"],"tags_count":160,"template":false,"template_full_name":null,"purl":"pkg:github/MCPJam/inspector","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCPJam%2Finspector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCPJam%2Finspector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCPJam%2Finspector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCPJam%2Finspector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MCPJam","download_url":"https://codeload.github.com/MCPJam/inspector/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCPJam%2Finspector/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34096955,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2025-12-13T22:00:29.526Z","updated_at":"2026-06-09T08:01:17.317Z","avatar_url":"https://github.com/MCPJam.png","language":"TypeScript","funding_links":["https://github.com/sponsors/mcpjam"],"categories":["The latest additions πŸŽ‰"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cpicture\u003e\n \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./mcpjam-inspector/client/public/mcp_jam_dark.png\"\u003e\n \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"./mcpjam-inspector/client/public/mcp_jam_light.png\"\u003e\n \u003cimg width=\"250\" alt=\"MCPJam Inspector V1 logo\" src=\"./mcpjam-inspector/client/public/mcp_jam_light.png\"\u003e\n\u003c/picture\u003e\n\n\u003cbr/\u003e\n\nwww.mcpjam.com\n\n[![npm version](https://img.shields.io/npm/v/@mcpjam/inspector?style=for-the-badge\u0026color=blue)](https://www.npmjs.com/package/@mcpjam/inspector)\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge)](https://opensource.org/licenses/Apache-2.0)\n[![Discord](https://img.shields.io/badge/Discord-Join%20Server-5865F2.svg?style=for-the-badge\u0026logo=discord\u0026logoColor=white)](https://discord.gg/JEnDtz8X6z)\n\n\u003c/div\u003e\n\nMCPJam is the development platform for MCP servers, MCP apps, and ChatGPT apps.\n\n- **Debug**: Inspect every JSON-RPC message and OAuth exchange across host configurations with full traces.\n- **Chat**: Talk to any LLM against your server with full trace visibility into tool calls and context across agent, host app, your server.\n- **Inspect**: Explore your server’s tools, resources, and prompts in one place.\n- **Evaluate**: Run evals across multiple LLMs and track accuracy over time so you catch regressions early.\n- **CLI**: Probe servers, run doctor checks, exercise OAuth flows, and list tools/resources/prompts straight from your terminal.\n- **SDK**: Programmatically drive inspections, snapshot server capabilities, and assert on tool/resource shapes from your own tests.\n- **CI/CD**: Wire the CLI and SDK into GitHub Actions (or any pipeline) to run e2e tests, evals, OAuth checks, and spec conformance on every PR.\n\nNo more ngrok or ChatGPT/Claude subscription needed. MCPJam is the fastest way to iterate on any MCP project.\n\n### πŸš€ Quick Start\n\nOpen the hosted web app. No install needed.\n\nπŸ‘‰ [app.mcpjam.com](https://app.mcpjam.com)\n\nOr run MCPJam locally for HTTP/S and local STDIO servers:\n\n```bash\nnpx @mcpjam/inspector@latest\n```\n\n\u003cimg alt=\"MCPJam Inspector Demo\" src=\"./docs/images/mcpjam-new-banner.png\"\u003e\n\n# Table of contents\n\n- [Installation Guides](#installation-guides)\n- [Key Features](#key-features)\n - [App Builder](#app-builder)\n - [Chat](#chat)\n - [OAuth Debugger](#oauth-debugger)\n - [MCP Server Debugging](#mcp-server-debugging)\n - [Skills](#skills)\n - [Workspaces](#workspaces)\n - [Evals](#evals)\n - [CLI](#cli)\n - [SDK](#sdk)\n - [CI/CD](#cicd)\n- [Contributing](#contributing-)\n- [Links](#links-)\n- [Community](#community-)\n- [Shoutouts](#shoutouts-)\n- [License](#-license)\n\n# Installation Guides\n\nMCPJam 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.\n\n### Requirements\n\n[![Node.js](https://img.shields.io/badge/Node.js-20+-green.svg?style=for-the-badge\u0026logo=node.js)](https://nodejs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5+-blue.svg?style=for-the-badge\u0026logo=typescript)](https://www.typescriptlang.org/)\n\nNode.js 20+ is only required for the terminal install (`npx`). The hosted web app and desktop apps have no local runtime requirements.\n\n## Hosted Web App\n\nOpen [app.mcpjam.com](https://app.mcpjam.com) in your browser. No install required. Always on the latest version, and you can share MCP server links with teammates the same way you'd share a Google Doc.\n\n- HTTPS MCP server URLs only (for HTTP or local STDIO servers, use Desktop or Terminal).\n- No STDIO, tunneling, skills, or tasks. Those require the local inspector.\n\nSee [Hosted App docs](https://docs.mcpjam.com/hosted/overview) for details.\n\n## Desktop App\n\nDownload the installer for your OS. Supports HTTP/S and local STDIO servers. No Node.js required.\n\n- [Install Mac](https://github.com/MCPJam/inspector/releases/latest/download/MCPJam.Inspector.dmg)\n- [Install Windows](https://github.com/MCPJam/inspector/releases/latest/download/MCPJam-Inspector-Setup.exe)\n\n## Terminal\n\nRun the inspector via `npx` (supports HTTP/S and local STDIO):\n\n```bash\nnpx @mcpjam/inspector@latest\n```\n\nAfter it starts, open the printed `localhost` URL in your browser.\n\n## Docker\n\nRun MCPJam Inspector using Docker, bound to localhost for security:\n\n```bash\ndocker run -p 127.0.0.1:6274:6274 mcpjam/mcp-inspector\n```\n\nThe app is 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, connect to host MCP servers via `http://host.docker.internal:PORT` instead of `127.0.0.1`.\n\n# Key features\n\n| Capability | Description |\n| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| App Builder | Debug your server against a model: tool calls or in-panel chat, with Chat, Trace, and Raw. OpenAI Apps SDK and MCP app UIs, text tools, Chrome DevTools-style widget emulator. [Read more](https://docs.mcpjam.com/inspector/app-builder) |\n| Chat | Multi-server chat on frontier models (free). Chat, Trace, Raw; compare up to 3 models. [Read more](https://docs.mcpjam.com/inspector/chat) |\n| OAuth Debugger | Guided MCP OAuth conformance checks: protocol versions 03-26, 06-18, 11-25; DCR, client pre-registration, CIMD. [Read more](https://docs.mcpjam.com/inspector/guided-oauth) |\n| MCP Server Debugging | Manually run tools, resources, templates, and elicitation; full JSON-RPC logs. |\n| Skills | Skills in Chat and App Builder; local filesystem only. [Read more](https://docs.mcpjam.com/inspector/skills) |\n| Workspaces | Shared server groups with real-time team sync. [Read more](https://docs.mcpjam.com/inspector/workspaces) |\n| Evals | Test cases with expected tool calls, run across LLMs, metrics. [Read more](https://docs.mcpjam.com/inspector/test-cases) |\n| CLI | Run MCPJam checks, probes, and evals from the terminal. Perfect for local dev loops and CI. [Read more](https://docs.mcpjam.com/cli/overview) |\n| SDK | Programmatic access to MCPJam for custom tooling, scripting, and integrations. [Read more](https://docs.mcpjam.com/sdk) |\n| CI/CD | Run MCPJam checks and evals in GitHub Actions and other CI systems to gate PRs on regressions. [Read more](https://docs.mcpjam.com/cli/ci) |\n\n## App Builder\n\nDebug your server against a model using tool calls or in-panel chat, with Chat, Trace, and Raw views. Supports OpenAI Apps SDK and MCP app UIs, text tools, and a Chrome DevTools-style widget emulator to iterate on widgets locally.\n\n- Manually invoke a tool to instantly view the widget, or chat with your server using an LLM.\n- View all JSON-RPC messages and `window.openai` messages in the logs.\n- Change emulator device to Desktop, Tablet, or Mobile views.\n- Test your app's locale change, CSP permissions, light / dark mode, hover \u0026 touch, and safe area insets.\n\n\u003cimg alt=\"MCPJam App Builder\" src=\"./docs/images/pizza-demo.png\"\u003e\n\n\u003cimg alt=\"MCPJam App Builder trace view\" src=\"./docs/images/app-builder-trace.png\"\u003e\n\n_Trace view: every tool call, agent step, and JSON-RPC message._\n\n## Chat\n\nMulti-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. View your server's token usage.\n\n\u003cimg alt=\"MCPJam Chat comparing frontier models side by side\" src=\"./docs/images/side-bears.png\"\u003e\n\n## OAuth Debugger\n\nGuided MCP OAuth conformance checks with step-by-step explanations. Test against every version of the OAuth spec (03-26, 06-18, and 11-25). Support for client pre-registration, Dynamic Client Registration (DCR), and Client ID Metadata Documents (CIMD).\n\n\u003cimg alt=\"MCPJam OAuth Flow Debugger\" src=\"./docs/images/oauth-debugger.png\"\u003e\n\n## MCP Server Debugging\n\nMCPJam contains all of the tooling to test your MCP server. Manually run tools, resources, resource templates, prompts, and elicitation flows, with full JSON-RPC observability. MCPJam has all features from the original inspector and more.\n\n\u003cimg alt=\"MCPJam MCP Tools\" src=\"./docs/images/mcp-tools.png\"\u003e\n\n## Skills\n\nUse Skills in Chat and App Builder to extend models with local, reusable behaviors. Local filesystem only. Your data never leaves your machine. [Read more](https://docs.mcpjam.com/inspector/skills)\n\n## Workspaces\n\nGroup your servers into shared workspaces with real-time team sync, so everyone on your team is testing against the same configuration. [Read more](https://docs.mcpjam.com/inspector/workspaces)\n\n## Evals\n\nDefine test cases with expected tool calls and run them across multiple LLMs. Track accuracy metrics over time to catch regressions early and improve your server with every iteration. [Read more](https://docs.mcpjam.com/inspector/test-cases)\n\n## CLI\n\nRun MCPJam from the terminal for fast local dev loops and CI integration. Probe servers, run OAuth checks, inspect tools and resources, and execute evals without leaving your shell. [Read more](https://docs.mcpjam.com/cli/overview)\n\n## SDK\n\nProgrammatic access to MCPJam for custom tooling, scripting, and integrations. Build your own workflows on top of MCPJam's inspection and evaluation primitives. [Read more](https://docs.mcpjam.com/sdk)\n\n## CI/CD\n\nWire MCPJam into GitHub Actions, GitLab CI, or your CI system of choice to run conformance, E2E tests, and evals on every PR. Catch MCP server regressions before they ship. [Read more](https://docs.mcpjam.com/cli/ci)\n\n# Contributing πŸ‘¨β€πŸ’»\n\nWe're grateful for you considering contributing to MCPJam. Please read our [contributing guide](CONTRIBUTING.md).\n\nJoin our [Discord community](https://discord.gg/JEnDtz8X6z) where the contributors hang out at.\n\n# Links πŸ”—\n\n- [Website](https://www.mcpjam.com/)\n- [Blog](https://www.mcpjam.com/blog)\n- [Pricing](https://www.mcpjam.com/pricing)\n- [Docs](https://docs.mcpjam.com/)\n\n# Community 🌍\n\n- [Discord](https://discord.gg/JEnDtz8X6z)\n- [𝕏 (Twitter)](https://x.com/mcpjams)\n- [LinkedIn](https://www.linkedin.com/company/mcpjam)\n\n# Shoutouts πŸ“£\n\nSome of our partners and favorite frameworks:\n\n- [Stytch](https://stytch.com). Our favorite MCP OAuth provider.\n- [xMCP](https://xmcp.dev/). The Typescript MCP framework. Ship on Vercel instantly.\n- [Alpic](https://alpic.ai/). Host MCP servers. Try their new [Skybridge framework](https://github.com/alpic-ai/skybridge) for ChatGPT apps!\n\n---\n\n# License πŸ“„\n\nThis project is licensed under the **Apache License 2.0**. See the [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcpjam%2Finspector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmcpjam%2Finspector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcpjam%2Finspector/lists"}