MCPJam 是用于 MCP 服务器、MCP 应用以及 ChatGPT 应用的开发平台。

• 调试：跨主机配置全面追踪，检查每一条 JSON-RPC 消息和 OAuth 交换。
• 聊天：与任意 LLM 对话，同时在代理、宿主应用和您的服务器之间全程跟踪工具调用及上下文信息。
• 检查：在一个地方探索您服务器的工具、资源和提示。
• 评估：在多个 LLM 上运行评估，并随时间跟踪准确率，以便尽早发现回归问题。
• CLI：直接从终端探测服务器、执行诊断检查、测试 OAuth 流程，并列出工具/资源/提示。
• SDK：以编程方式驱动检查、快照服务器能力，并在您自己的测试中断言工具/资源的结构。
• CI/CD：将 CLI 和 SDK 集成到 GitHub Actions（或任何流水线）中，以便在每次 PR 提交时运行端到端测试、评估、OAuth 检查以及规范符合性验证。

不再需要 ngrok 或 ChatGPT/Claude 订阅。MCPJam 是迭代任何 MCP 项目最快的方式。

🚀 快速入门

打开托管的 Web 应用程序，无需安装。

👉 app.mcpjam.com

或者在本地运行 MCPJam，适用于 HTTP/S 和本地 STDIO 服务器：

npx @mcpjam/inspector@latest

目录

• 安装指南
• 核心功能
  • 应用构建器
  • 聊天
  • OAuth 调试器
  • MCP 服务器调试
  • 技能
  • 工作空间
  • 评估
  • CLI
  • SDK
  • CI/CD
• 贡献
• 链接
• 社区
• 致谢
• 许可证

安装指南

MCPJam Inspector 可通过三种方式运行：托管 Web 应用、适用于 Mac 和 Windows 的桌面应用，或通过您的终端。Web 应用仅支持 HTTPS，无需安装。终端和桌面应用则支持 HTTP/S 和本地 STDIO 服务器。

系统要求

仅终端安装（npx）需要 Node.js 20 或更高版本。而托管 Web 应用和桌面应用则无需本地运行时环境。

托管 Web 应用

在浏览器中打开 app.mcpjam.com 即可使用。无需安装，始终为最新版本，您可以像分享 Google 文档一样与团队成员共享 MCP 服务器链接。

• 仅支持 HTTPS 的 MCP 服务器 URL（对于 HTTP 或本地 STDIO 服务器，请使用桌面版或终端版）。
• 不支持 STDIO、隧道、技能或任务等功能，这些功能需要本地检查器。

详细信息请参阅 托管应用文档。

大众桌面应用

下载适合您操作系统的安装程序。支持 HTTP/S 和本地 STDIO 服务器，无需 Node.js。

• Mac 版安装包
• Windows 版安装程序

终端版

通过 npx 运行检查器（支持 HTTP/S 和本地 STDIO）：

npx @mcpjam/inspector@latest

启动后，在浏览器中打开打印出的 localhost URL。

Docker 版

使用 Docker 运行 MCPJam Inspector，并将其绑定到 localhost 以确保安全：

docker run -p 127.0.0.1:6274:6274 mcpjam/mcp-inspector

应用程序可在 http://127.0.0.1:6274 访问。务必使用 -p 127.0.0.1:6274:6274（而非 -p 6274:6274），以确保检查器仅限于本地访问。在 macOS/Windows 上，连接到主机 MCP 服务器时，请使用 http://host.docker.internal:PORT 而不是 127.0.0.1。

核心功能

功能	描述
应用构建器	使用工具调用或面板内聊天，结合“聊天”、“追踪”和“原始”视图，针对模型调试您的服务器。支持 OpenAI Apps SDK 和 MCP 应用 UI、文本工具以及 Chrome DevTools 风格的小部件模拟器。了解更多
聊天	在前沿模型上进行多服务器聊天（免费）。提供“聊天”、“追踪”、“原始”视图；可同时比较最多 3 个模型。了解更多
OAuth 调试器	引导式 MCP OAuth 兼容性检查：协议版本 03-26、06-18、11-25；DCR、客户端预注册、CIMD。了解更多
MCP 服务器调试	手动运行工具、资源、模板和诱导流程；提供完整的 JSON-RPC 日志。
技能	在聊天和应用构建器中使用技能；仅限本地文件系统。了解更多
工作空间	共享服务器组，支持团队实时同步。了解更多
评估	包含预期工具调用的测试用例，在不同 LLM 上运行，并生成指标。了解更多
CLI	从终端运行 MCPJam 检查、探测和评估。非常适合本地开发循环和 CI 流程。了解更多
SDK	通过编程方式访问 MCPJam，用于自定义工具、脚本编写和集成。了解更多
CI/CD	在 GitHub Actions 及其他 CI 系统中运行 MCPJam 检查和评估，以阻止包含回归问题的 PR 合并。了解更多

应用构建器

使用工具调用或面板内聊天，结合“聊天”、“追踪”和“原始”视图，针对模型调试您的服务器。支持 OpenAI Apps SDK 和 MCP 应用 UI、文本工具以及 Chrome DevTools 风格的小部件模拟器，方便您在本地迭代小部件。

• 手动调用工具即可立即查看小部件，或使用 LLM 与您的服务器聊天。
• 在日志中查看所有 JSON-RPC 消息和 window.openai 消息。
• 更改模拟器设备为桌面、平板或移动设备视图。
• 测试应用的区域设置变化、CSP 权限、浅色/深色模式、悬停与触控操作，以及安全区域边距。

追踪视图：每一条工具调用、代理步骤和 JSON-RPC 消息。

聊天

免费使用前沿模型进行多服务器聊天，或自行提供 API 密钥。提供“聊天”、“追踪”和“原始”视图；可并排比较最多 3 个模型。查看您的服务器的令牌使用情况。

OAuth 调试器

提供逐步解释的引导式 MCP OAuth 兼容性检查。可针对 OAuth 规范的各个版本（03-26、06-18 和 11-25）进行测试。支持客户端预注册、动态客户端注册 (DCR) 和客户端 ID 元数据文档 (CIMD)。

MCP 服务器调试

MCPJam 包含测试您的 MCP 服务器所需的所有工具。您可以手动运行工具、资源、资源模板、提示词和诱导流程，并获得完整的 JSON-RPC 可观测性。MCPJam 拥有原始检查器的所有功能，并在此基础上进行了扩展。

技能

在聊天和应用构建器中使用技能，以本地、可重用的行为扩展模型。仅限本地文件系统。您的数据绝不会离开您的机器。了解更多

工作空间

将您的服务器分组到共享的工作空间中，实现团队的实时同步，确保团队中的每个人都在相同的配置下进行测试。了解更多

评估

定义包含预期工具调用的测试用例，并在多个 LLM 上运行。随着时间的推移跟踪准确率指标，以便及早发现回归问题，并在每次迭代中改进您的服务器。了解更多

CLI

从终端运行 MCPJam，适用于快速的本地开发循环和 CI 集成。无需离开终端即可探测服务器、运行 OAuth 检查、检查工具和资源，并执行评估。了解更多

SDK

通过编程方式访问 MCPJam，用于自定义工具、脚本编写和集成。基于 MCPJam 的检查和评估原语构建您自己的工作流。了解更多

CI/CD

将 MCPJam 集成到 GitHub Actions、GitLab CI 或您选择的 CI 系统中，以便在每个 PR 上运行兼容性测试、端到端测试和评估。在 MCP 服务器出现回归问题之前将其拦截。了解更多

贡献 👨‍💻

我们非常感谢您考虑为 MCPJam 做出贡献。请阅读我们的贡献指南。

加入我们的Discord 社区，这里是贡献者们交流的地方。

链接 🔗

• 官网
• 博客
• 定价
• 文档

社区 🌍

• Discord
• 𝕏 (Twitter)
• LinkedIn

致谢 📣

我们的一些合作伙伴和喜爱的框架：

• Stytch。我们最喜欢的 MCP OAuth 提供商。
• xMCP。TypeScript 版本的 MCP 框架。可在 Vercel 上即时部署。
• Alpic。托管 MCP 服务器。不妨试试他们新推出的用于 ChatGPT 应用的 Skybridge 框架！

---

许可证 📄

本项目采用 Apache 2.0 许可证 许可。请参阅 LICENSE 文件。

MCPJam Inspector 快速上手指南

MCPJam Inspector 是专为 MCP（Model Context Protocol）服务器、应用及 ChatGPT 应用打造的开发平台。它提供了调试、聊天、评估、CLI 工具及 SDK 等全方位功能，帮助开发者无需 ngrok 或付费订阅即可高效迭代项目。

环境准备

系统要求

• 操作系统：macOS, Windows, Linux (支持 Docker)
• 浏览器：现代浏览器（Chrome, Edge, Firefox 等）

前置依赖

• Node.js: 版本 20+ (仅在使用终端命令 npx 或本地开发时需要)
• TypeScript: 版本 5+ (推荐，用于开发扩展)

注意：如果您使用托管版 Web 应用或桌面客户端，则无需在本地安装 Node.js 运行时。

安装步骤

您可以根据需求选择以下三种方式使用 MCPJam Inspector：

方式一：托管 Web 应用（无需安装）

最适合快速测试 HTTPS 协议的 MCP 服务器。

1. 直接访问官网：app.mcpjam.com
2. 无需任何安装步骤，打开即用。

方式二：桌面客户端（推荐本地开发）

适合需要调试本地 STDIO 服务器或 HTTP 服务器的用户，无需配置 Node 环境。

• macOS: 下载安装包 (.dmg)
• Windows: 下载安装包 (.exe)

方式三：终端运行 (CLI)

适合习惯命令行的开发者，支持 HTTP/S 和本地 STDIO 服务器。

确保已安装 Node.js 20+，然后运行：

npx @mcpjam/inspector@latest

启动后，终端会打印一个本地地址（如 http://localhost:xxxx），请在浏览器中打开该地址。

方式四：Docker 运行

适合容器化环境，默认绑定本地回环地址以确保安全。

docker run -p 127.0.0.1:6274:6274 mcpjam/mcp-inspector

启动后访问 http://127.0.0.1:6274。

提示：在 macOS/Windows 上连接宿主机运行的 MCP 服务器时，请使用 http://host.docker.internal:PORT 代替 127.0.0.1。

基本使用

以下以终端运行为例，演示最基础的调试流程：

1. 启动 Inspector

在终端执行启动命令：

npx @mcpjam/inspector@latest

2. 打开界面

在浏览器中访问终端输出的 localhost 地址。

3. 连接并调试服务器

• 添加服务器：在界面中输入您的 MCP 服务器地址（支持 http/https URL 或本地 stdio 命令）。
• 查看工具与资源：进入 "Inspect" 标签页，自动列出服务器暴露的所有 Tools（工具）、Resources（资源）和 Prompts（提示词）。
• 手动测试：点击任意工具，填入参数并运行，右侧将实时显示完整的 JSON-RPC 请求与响应日志。
• AI 对话调试：切换到 "Chat" 标签页，选择模型（支持免费的前沿模型或自定义 API Key），直接与您的服务器进行对话，观察 Agent 如何调用工具及上下文变化。

4. 进阶功能

• OAuth 调试：使用 "OAuth Debugger" 逐步验证 OAuth 流程合规性。
• 自动化评估：定义测试用例（Evals），批量在不同 LLM 上运行以检测回归问题。
• CI/CD 集成：利用生成的 CLI 命令或 SDK 将检查流程接入 GitHub Actions。