MCPJam/inspector

Testing and evaluation platform to chat, inspect, and debug MCP servers, MCP apps, and ChatGPT apps.

MCPJam Inspector – 它是什么

MCPJam Inspector 是一个开源平台，协助 MCP servers（驱动 ChatGPT、Claude、Copilot、Cursor 等 AI 助理的后端）开发者进行测试、调试和评估其集成。它让您能在多种客户端配置下执行相同的服务器，检查每个 JSON-RPC 和 OAuth 交换，并在 CI/CD 管线中自动化回归测试。

核心功能（如 README 所述）

功能	您可以做什么
Playground	交互式网页 UI，模拟 16 种不同 AI 客户端的界面。您可以与模型对话、触发工具调用，并查看 JSON-RPC 消息、小工具渲染和 OAuth 流程的完整时间轴。
OAuth Debugger	针对多个规范版本（2025-03-26, 2025-06-18, 2025-11-25, 2026-07-28）的 MCP OAuth 流程进行逐步可视化。它会检查动态客户端注册、预注册和客户端元数据文件。
Server Debugging	手动调用工具、资源、模板、提示词和引导流程，同时观察完整的 JSON-RPC 日志。
Skills	从本地文件系统或托管账户加载可重复使用的“技能”（行为扩展），并在 Playground 中使用它们，无需将代码发送到云端。
Workspaces	将服务器分组到共享工作区中并进行实时同步，让整个团队可以一起测试相同的配置。
Evals	定义指定预期工具调用的测试案例，在多个 LLM 上执行它们，并随时间收集准确度、延迟和工具调用指标。
CLI	终端界面 (`npx @mcpjam/inspector`)，无需浏览器即可探测服务器、执行 OAuth 检查、列出工具/资源并执行评估。
SDK	TypeScript 库，让您可以编写检查脚本、获取服务器功能快照，并从您自己的测试套件中对工具/资源形状进行断言。
CI/CD integration	现成的 GitHub Actions（及通用 CI）步骤，可在每次 Pull Request 时执行一致性、端对端、评估和 OAuth 检查。

如何开始

方法	命令 / 链接	备注
托管网页应用	https://app.mcpjam.com	无需安装；可在任何浏览器中运行（仅限 HTTPS）。
桌面应用	从发布页面下载（macOS `.dmg` 或 Windows `.exe`）。	支持 HTTP/S 和本地 STDIO 服务器；无需 Node.js。
终端 (Node)	`npx @mcpjam/inspector@latest`	启动本地服务器并打印出您可以在浏览器中打开的私人 URL。
Docker	从源码构建 (`docker build …`) 并使用 `-p 127.0.0.1:6274:6274` 运行。	为了安全起见，将检查器限制在 localhost。

典型使用案例

调试客户端特定的错误 – 查看为什么工具调用在 ChatGPT 中有效但在 Claude 中失败。
OAuth 集成测试 – 验证您的服务器是否符合每个 MCP OAuth 草案版本。
回归测试 – 在 CI 中执行自动化评估套件，以便在发布前捕捉准确度或延迟下降。
团队协作 – 分享工作区链接，让所有工程师查看相同的服务器状态和测试结果。
技能开发 – 在发布到托管账户之前，先在本地原型化可重复使用的行为。

社区与支持

文档: https://docs.mcpjam.com
Discord: https://discord.gg/JEnDtz8X6z
授权: Apache 2.0 (根据仓库的 LICENSE 文件)。

总结: MCPJam Inspector 是一个全栈测试与评估套件，旨在协助开发者构建需要在多个前端客户端上可靠运行的 AI 助理后端。它提供了丰富的 UI 和程序化接口，使调试、性能追踪和 CI 集成变得简单直接。