MCPJam Inspector Skill 技能

技能简介

MCPJam Inspector 是面向 MCP 服务器开发者的开源测试与评测平台。它能在 16 种客户端配置 + 170+ 模型组合下,统一调试工具、资源、提示词与授权流程,捕捉 ChatGPT、Claude、Cursor、Copilot 之间的差异,让 MCP 集成在每一次发布前都通过一致性回归测试。

核心能力

• 可视化调试 Playground:在同一界面浏览服务器的工具、资源、提示词,直接调真实 LLM,完整查看每次 JSON-RPC 消息与 OAuth 交换的 trace。
• 跨客户端评测:内置 16 套客户端配置(ChatGPT、Claude、Cursor、Copilot 等),同一用例自动跑遍所有组合,产出准确率、延迟、工具调用成功率等多维评分。
• OAuth 一致性检查:引导式 MCP OAuth 合规校验,覆盖 03-26、06-18、11-25、2026-07-28 协议版本,支持 DCR、客户端预注册、CIMD 流程可视化逐步排查。
• CI/CD 自动化回归:可作为流水线环节插入,跑 conformance 与行为检查,异常结果直接阻断发布。
• Skills 与 MCP Apps 沙盒:Playground 中可加载 OpenAI Apps SDK 与 MCP app UI,Chrome DevTools 风格的 widget 模拟器,无需真实客户端即可调试应用渲染。

安装配置

1. 安装 Node.js 18+ 与 npm,然后执行 npx @mcpjam/inspector@latest 启动本地 inspector。
2. 在 inspector 界面填写 MCP 服务器的 stdio 命令或 URL(支持 HTTP/S 与本地 stdio 两种协议)。
3. 选择 OAuth 模式,按需填入 client_id、scope、redirect_uri 等字段。
4. 关联 16 种客户端配置中的任意一种,系统自动同步协议版本与 token 存储。
5. 通过 app.mcpjam.com 在线使用免安装版本,适合快速调试。

使用步骤

1. 启动 inspector 后,在 Servers 面板添加待调试 MCP 服务器,选择 stdio/HTTP/S 协议。
2. 在 Tools 标签手动触发工具调用,实时查看 JSON-RPC 报文与 trace 时间轴。
3. 进入 OAuth Debugger,逐步执行授权流程,定位 token、scope、redirect 错误。
4. 切换 Eval 标签,选择 16 套客户端配置,导入测试用例,点击 Run 获取准确率与延迟矩阵。
5. 在 CI 中调用 inspector CLI 跑 conformance,把失败用例直接 fail 流水线。

适用场景

• MCP 服务器上线前回归:避免发布后某个客户端调用失败导致用户体验割裂。
• 跨客户端兼容性调试:当用户从 ChatGPT 切到 Claude 报工具调用错误时,定位差异点。
• OAuth 协议一致性扫描:为多版本 MCP 客户端用户提供统一登录体验。
• 研发团队评审工具:在 Code Review 中附带 inspector trace,辅助审核者理解真实协议行为。

适用人群

• MCP 服务器开发者与维护者
• 负责多模型客户端兼容性的平台工程师
• 安全与合规团队(OAuth 与权限边界审计)
• 关注 MCP 协议演进的协议研究者

工作原理

MCPJam Inspector 通过本地 Node 进程启动 MCP 服务器并以 MCP 客户端身份发起 JSON-RPC 调用,同时把每条请求/响应记录到 trace 数据库。当用户在 Eval 模式选择不同客户端配置时,inspector 切换对应的协议握手(03-26/06-18/11-25/2026-07-28)并按该客户端的字段命名规范(SSE vs streamable-http、cursor id 规范等)重放用例,差异点直接高亮在报告中。

官方链接

• GitHub: https://github.com/MCPJam/inspector
• 在线版: https://app.mcpjam.com
• 文档: https://docs.mcpjam.com/inspector/playground