适合谁
- 正在开发或维护 MCP 服务器、需要跨多种客户端验证行为一致性的开发者
- 需要将 MCP 一致性与回归测试纳入 CI/CD 流程的团队
- 需要调试 OAuth/DCR/CIMD 授权流程的开发者
- 需要本地预览和迭代 Apps SDK / MCP 应用组件 UI 的开发者
M
58FMRS · C
MCPJam Inspector 是一个成熟的开源 MCP 测试与调试平台，覆盖工具调用、OAuth 流程、跨客户端评测和 CI/CD 集成，README 文档详尽且提供多种部署方式，是 MCP 服务器开发者在开发和发布流程中值得考虑的调试与质量保障工具。
MCPJam Inspector 是一个开源的测试与评估平台，用于交互式检查和调试 MCP（Model Context Protocol）服务器、MCP 应用以及 ChatGPT 应用。它本身不是一个提供工具的 MCP 服务器，而是一个 MCP 客户端/调试工具：可以连接到本地（STDIO）或远程（HTTP/S）的 MCP 服务器，手动运行工具、资源、资源模板、提示词和 elicitation 流程，并查看完整的 JSON-RPC 日志。它支持在 16 种客户端配置（如 ChatGPT、Claude、Cursor、Copilot 等）和 170 多个模型上进行跨客户端评测，提供 OAuth 调试器（覆盖 2025-03-26、2025-06-18、2025-11-25 及 2026-07-28 draft 等多个协议版本，支持 DCR、客户端预注册和 CIMD）、带追踪的 Playground 聊天界面（支持 OpenAI Apps SDK 和 MCP 应用 UI 的组件模拟器）、技能（Skills）、团队工作区（Workspaces）、测试用例评测（Evals），以及可用于 CI/CD 流水线的命令行工具和 SDK。可通过托管网页应用（app.mcpjam.com）、Mac/Windows 桌面应用，或 npx @mcpjam/inspector@latest 在终端本地运行；也可从源码构建 Docker 镜像。
工具能力
暂未整理工具清单。
安装接入
根据使用场景选择安装方式：1) 托管网页版：直接打开 app.mcpjam.com，无需安装，仅支持 HTTPS 服务器地址，不支持 STDIO、隧道、技能或任务功能；2) 桌面应用：从 GitHub Releases 下载 Mac (.dmg) 或 Windows (.exe) 安装包，支持 HTTP/S 和本地 STDIO 服务器，无需安装 Node.js；3) 终端运行：需要 Node.js 20+，执行 npx @mcpjam/inspector@latest，启动后打开终端输出的 localhost 地址，支持 HTTP/S 和本地 STDIO；4) Docker：官方未发布镜像，需先克隆仓库并用仓库内的 Dockerfile 自行构建（docker build -t mcpjam/mcp-inspector:local -f mcpjam-inspector/Dockerfile .），运行时务必使用 -p 127.0.0.1:6274:6274 而非 -p 6274:6274，以确保仅本机可访问；在 macOS/Windows 上可通过 http://host.docker.internal:PORT 访问宿主机上的 MCP 服务器。
选型与风险
不适合谁
- 只想直接把 MCP 服务器接入终端使用的普通最终用户（这是开发调试工具，而非面向最终用户的 MCP 服务器）
- 需要在完全离线、无法访问网络的环境中使用托管版功能（如技能同步、任务）的用户，因为托管应用仅支持 HTTPS 且部分功能仅限本地版本
- 寻找会向 AI 助手暴露工具（tools）的 MCP 服务器实现的用户
所需权限
- 需要网络访问权限以连接目标 MCP 服务器（本地 STDIO 进程或远程 HTTP/S 端点）
- 本地/桌面版会启动并与本机 STDIO 子进程通信，具备执行本地命令的能力
- OAuth 调试功能需要访问和处理授权凭据、令牌交换过程
- 若自建 Docker 镜像，容器默认绑定到 127.0.0.1，需要本机端口访问权限
风险与副作用
- 作为调试工具，会记录并展示完整的 JSON-RPC 消息和 OAuth 交换细节，需注意日志中可能包含敏感令牌或凭据
- Docker 部署若错误地使用 `-p 6274:6274` 而非 `-p 127.0.0.1:6274:6274`，可能将调试端口暴露到公网
- 托管网页版对无法通过 HTTPS 访问、需要 STDIO 连接的服务器不适用
- 官方仓库未声明明确许可证（NOASSERTION），README 中提及 Apache 2.0，实际使用前应自行核实许可证条款
常见排障
- 确认使用的安装方式是否支持所需传输协议：托管版仅支持 HTTPS，STDIO 服务器需使用桌面版或终端 `npx` 方式
- 终端方式需要 Node.js 20 及以上版本，版本过低会导致 npx 启动失败
- Docker 部署时确认端口映射使用 `127.0.0.1:6274:6274`，并在 macOS/Windows 上用 `host.docker.internal` 而非 `localhost` 访问宿主机服务
- OAuth 调试报错时，对照文档中列出的协议版本（2025-03-26、2025-06-18、2025-11-25、2026-07-28 draft）确认目标服务器实现的协议版本是否匹配
- 遇到功能缺失（如技能、任务、隧道）时检查是否在托管网页版下运行，这些功能仅在本地/桌面版可用
使用场景
在开发过程中手动调用并调试 MCP 服务器的工具、资源和提示词，查看完整 JSON-RPC 消息
调试和验证 MCP OAuth / EMA 认证流程，排查跨协议版本的授权错误
在多个 LLM 客户端配置下运行评测用例，追踪工具调用准确率随时间的变化
在 CI/CD 流水线中自动运行一致性检查、端到端测试和评测，防止发布前出现回归
本地迭代开发支持 OpenAI Apps SDK 或 MCP 应用 UI 组件的服务器
支持客户端
暂未确认支持的客户端。