MCPJam：MCP 服务器测试与评测平台

项目简介

MCPJam 是面向 MCP 服务器开发者的开源测试与评测平台。ChatGPT、Claude、Cursor 等客户端读取服务器的方式各不相同，MCPJam 帮你发现这些差异、定位服务器在哪里出问题，并给出修复方向。你可以在 16 种客户端配置和 170+ 个模型下交互式测试 tools、prompts、resources 与授权流程，运行评测用例，并把回归检查接入 CI/CD。

提供三种使用方式：托管网页版、Mac/Windows 桌面版、终端（npx）。

主要功能

• Playground：跨客户端聊天界面，模拟 UI、工具调用与 skills，并保留完整 trace。支持 OpenAI Apps SDK 与 MCP app UI、文本工具，以及 Chrome DevTools 风格的 widget 模拟器：可在 Desktop / Tablet / Mobile 之间切换，测试 locale 变化、CSP 权限、明暗模式、hover 与触摸、安全区内边距。
• OAuth Debugger：逐步可视化 OAuth 与 EMA 请求，找出错误来源。内置 MCP OAuth 一致性检查，覆盖 2025-03-26、2025-06-18、2025-11-25 及 2026-07-28 草案，支持客户端预注册、Dynamic Client Registration（DCR）与 Client ID Metadata Documents（CIMD）。
• Server Debugging：手动运行 tools、resources、resource templates、prompts 和 elicitation 流程，并查看完整 JSON-RPC 日志。
• Skills：在 Playground 中为模型扩展可复用行为。本地 skills 从文件系统读取，不会离开你的机器；开启该功能的账号还可使用项目携带的托管 skills。
• Workspaces：把服务器分组到共享工作区并实时团队同步，让所有人测试同一套配置。
• Evals：定义带预期工具调用的测试用例，跨多个 LLM 运行，并跟踪准确率随时间的变化。
• CLI 与 SDK：在终端里探测服务器、运行 doctor 检查、执行 OAuth 流程、列出 tools/resources/prompts；SDK 用于在自定义工具和测试中驱动检查与断言。
• CI/CD：接入 GitHub Actions、GitLab CI 或任意流水线，在每个 PR 上运行一致性检查、E2E 测试、评测与 OAuth 检查。

安装与使用

托管网页版：打开 app.mcpjam.com，无需安装，始终为最新版本，并可像 Google Doc 一样把服务器链接分享给同事。仅支持 HTTPS 服务器地址，不支持 STDIO、tunneling、skills 和 tasks（这些需要本地版）。

桌面版：下载安装包即可，支持 HTTP/S 与本地 STDIO，无需 Node.js。

• Mac：MCPJam.Inspector.dmg
• Windows：MCPJam-Inspector-Setup.exe

终端：需要 Node.js 20+，支持 HTTP/S 与本地 STDIO。启动后打开终端打印的 localhost 地址。

npx @mcpjam/inspector@latest

Docker：出于安全考虑绑定到 localhost，访问地址为 http://127.0.0.1:6274。

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

注意事项

• 启动器会自动打开一个私有访问链接；从其他浏览器登录时，使用终端打印的链接，Docker 用户可用 docker logs <container> 获取。请勿公开该链接，重启后会生成新链接，除非配置了 MCPJAM_SESSION_TOKEN。
• Docker 请始终使用 -p 127.0.0.1:6274:6274（而不是 -p 6274:6274），以保持 inspector 仅本机可访问。在 macOS/Windows 上，通过 http://host.docker.internal:PORT 访问宿主机上的 MCP 服务器。
• 远程地址和端口映射的说明见仓库中 mcpjam-inspector/README.md 的网络访问章节。
• 项目采用 Apache License 2.0 许可。

本作品整理自 GitHub 开源项目 MCPJam/inspector，原作者 @MCPJam。中文介绍由 AI 根据项目 README 整理，以原仓库为准。