{"id":34040306,"url":"https://github.com/mcpjam/inspector","last_synced_at":"2026-03-15T03:31:12.061Z","repository":{"id":295106421,"uuid":"989134268","full_name":"MCPJam/inspector","owner":"MCPJam","description":"Build ChatGPT Apps and MCP servers locally.","archived":false,"fork":false,"pushed_at":"2025-12-15T15:36:28.000Z","size":229957,"stargazers_count":1491,"open_issues_count":36,"forks_count":160,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-12-15T18:18:21.638Z","etag":null,"topics":["chatgpt","mcp","mcp-apps","mcp-clients","mcp-tools","modelcontextprotocol","opensource"],"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":null,"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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-05-23T15:56:00.000Z","updated_at":"2025-12-15T13:22:16.000Z","dependencies_parsed_at":"2025-08-08T00:08:27.958Z","dependency_job_id":"06109a76-dfb7-4c25-96db-79b32aa391c8","html_url":"https://github.com/MCPJam/inspector","commit_stats":null,"previous_names":["mcpjam/inspector"],"tags_count":88,"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":27803754,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-18T02:00:09.725Z","response_time":55,"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":["chatgpt","mcp","mcp-apps","mcp-clients","mcp-tools","modelcontextprotocol","opensource"],"created_at":"2025-12-13T22:00:29.526Z","updated_at":"2026-01-16T08:49:41.180Z","avatar_url":"https://github.com/MCPJam.png","language":"TypeScript","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 Inspector is the local development client for ChatGPT apps, MCP ext-apps, and MCP servers. Build and test your apps with a full widget emulator, chat with any LLM, and inspect your server’s tools, resources, prompts, and OAuth flows.\n\nNo more ngrok or ChatGPT subscription needed. MCPJam is the fastest way to iterate on any MCP project.\n\n### 🚀 Quick Start\n\nStart up the MCPJam inspector:\n\n```bash\nnpx @mcpjam/inspector@latest\n```\n\n\u003cimg alt=\"MCPJam Inspector Demo\" src=\"./docs/images/mcpjam-banner.png\"\u003e\n\n# Table of contents\n\n- [Installation Guides](#installation-guides)\n- [Key Features](#key-features)\n  - [ChatGPT / MCP Apps Builder](#openai-apps--mcp-ui)\n  - [OAuth Debugger](#oauth-debugger)\n  - [LLM Playground](#llm-playground)\n- [Contributing](#contributing-)\n- [Links](#links-)\n- [Community](#community-)\n- [Shoutouts](#shoutouts-)\n- [License](#-license)\n\n# Installation Guides\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\n## Install MCPJam\n\nWe recommend starting MCPJam inspector via `npx`:\n\n```bash\nnpx @mcpjam/inspector@latest\n```\n\nWe have a Mac and Windows desktop app:\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\nRun MCPJam using Docker:\n\n```bash\ndocker run -p 6274:6274 mcpjam/mcp-inspector\n```\n\n# Key features\n\n| Capability           | Description                                                                                                                                                                                                                                                                                        |\n| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ChatGPT Apps SDK     | Local development for ChatGPT Apps SDK support. Full support for the `windows.openai` API: `widgetState`, `callTool`, `structuredContent`, `sendFollowUpMessage`, `displayMode`, CSP, and more. No more ngrok or ChatGPT subscription needed. [Read more](https://www.mcpjam.com/blog/app-builder) |\n| MCP ext-apps (Claude)   | Full local development for MCP Apps (SEP-1865). Support for all JSON-RPC message types, such as `tools/call`, `ui/initialize`, `ui/message`, `ui/open-link`, and more. [Read more](https://www.mcpjam.com/blog/mcp-apps-preview)                                                                   |\n| OAuth Debugger       | Debug your MCP server's OAuth implementation at every step. Visually inspect every network message. Supports all protocol versions (03-26, 06-18, and 11-25). Support for client pre-registration, DCR, and CIMD. [Read more](https://www.mcpjam.com/blog/oauth-debugger)                          |\n| LLM playground       | Chat with your MCP server against any LLM in the playground. We provide frontier models such as GPT-5 and Claude Sonnet for free, or bring your own API key. Playground supports ChatGPT apps and MCP Apps. [Read more](https://www.mcpjam.com/blog/frontier-models)                               |\n| MCP server debugging | Connect to and test any MCP server local or remote. Manually invoke MCP tools, resources, resource templates, and elicitation flows. View all JSON-RPC logs. Support for all features from the official MCP inspector.                                                                             |\n| Server info          | View server icons, version, capabilities, instructions, and ChatGPT widget metadata exposed by the server. [Read more](https://www.mcpjam.com/blog/server-instructions)                                                                                                                            |\n\n## ChatGPT Apps / MCP Apps Builder\n\nDevelop [ChatGPT apps](https://developers.openai.com/apps-sdk/) and [MCP apps (Claude)](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/1865) in MCPJam's Apps Builder. Apps Builder is a local emulator to quickly view and iterate on your widgets.\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, `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 LLM playground\" src=\"./docs/images/pizza-demo.png\"\u003e\n\n## OAuth Debugger\n\nView every step of the OAuth handshake in detail, with guided explanations. Test with 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## LLM Playground\n\nTry your server against any LLM model. We provide frontier models like GPT-5, Claude Sonnet, Gemini 2.5 for free, or bring your own API key. View your server's token usage.\n\n\u003cimg alt=\"MCPJam LLM playground\" src=\"./docs/images/playground.png\"\u003e\n\n## MCP Inspector\n\nMCPJam contains all of the tooling to test your MCP server. Test your server's tools, resources, prompts, templates, with full JSON-RPC observability. MCPJam has all features from the original inspector and more.\n\n\u003cimg alt=\"MCPJam LLM playground\" src=\"./docs/images/mcp-tools.png\"\u003e\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","funding_links":[],"categories":["The latest additions 🎉"],"sub_categories":[],"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"}