MCPJam/inspector · 上手攻略
- 仓库：MCPJam/inspector
- 链接：https://github.com/MCPJam/inspector
- 分类：工具 · MCP 开发调试
- 作者：Tom
- 更新：2026-10-13
这是什么
MCPJam Inspector 是 MCP（Model Context Protocol）服务器开发商专用的测试与评估平台。简单说：它让你在一个界面里完成 MCP 服务器的手动调试、跨客户端行为评测、OAuth 合规检查，以及 CI/CD 流水线中的自动化回归测试。
核心解决的问题是：不同 MCP 客户端（ChatGPT、Claude、Cursor、Copilot 等）对同一个 MCP 服务器的读取方式存在差异，服务器在一个客户端上正常，在另一个客户端上报错。Inspector 能同时在 16 种客户端配置下测试同一个服务器，告诉你哪里断了、为什么断、怎么修。
解决什么问题
MCP 服务器开发完，投到生产环境，发现 Copilot 能用、Claude 不能用，或者桌面版正常、手机版报权限错误——这类跨客户端的兼容性问题很难定位，因为每个客户端的日志各自封闭。
MCPJam Inspector 把这个问题变成可视化的：每个工具调用、每个 JSON-RPC 消息、每次 OAuth 交换，都在同一个面板里按时间线展开，差异一目了然。同时它提供了真正的评估能力（Evals）：用测试用例定义"调用这个工具应该返回什么"，然后批量跑在 170+ 模型上，持续追踪准确率变化，在每次 PR 中拦住退化。
快速安装
零安装选项：直接打开 https://app.mcpjam.com 用网页版，不需要任何本地环境。
网页版
仅支持 HTTPS 服务器 URL，不支持本地 STDIO、隧道、Skills、Tasks 功能。适合快速验证远程 MCP 服务端点。
桌面应用（Mac / Windows）
无需 Node.js，下载即可运行：
- Mac：MCPJam.Inspector.dmg
- Windows：MCPJam-Inspector-Setup.exe
支持 HTTP/S 和本地 STDIO 两种服务器连接方式。
终端（需要 Node.js）
npx @mcpjam/inspector@latest
启动后终端会打印一个 localhost URL，在浏览器打开即可。启动时也会自动打开一个私有访问链接，可在其他浏览器登录使用。如需从远程访问，参见仓库的 网络访问说明。
⚠️ 私有访问链接每次重启会重新生成（除非配置
MCPJAM_SESSION_TOKEN环境变量），请妥善保管。
Docker
docker run -p 3000:3000 mcpjam/inspector
核心用法
Playground（主要工作区）
集成了聊天、工具手动调用、Widget 渲染、Trace 和 JSON-RPC 日志的 IDE 风格界面：
# Playground 支持的操作
# 1. 和 MCP 服务器对话（可同时对话最多3个模型，对比输出）
# 2. 手动调用任意工具，输入自定义参数
# 3. 渲染 Widget（openai/outputTemplate / ui.resourceUri）
# 4. 在 Chat / Trace / Raw 三个视图间切换
# - Chat：会话视图
# - Trace：每个步骤的时间线（含延迟和 token 消耗）
# - Raw：实际发给模型的完整 JSON payload
多客户端对比：Playground 可以同时在 ChatGPT、Claude、Cursor 三个客户端配置下渲染同一个工具调用，观察差异。可以切换设备尺寸（桌面/平板/手机）、主题、区域设置、CSP 权限模式。
Server Debugging（服务器调试）
手动运行工具、资源、资源模板、Prompts 和 elicitation 流程，每个 JSON-RPC 消息实时可见，适合逐请求排查问题。
OAuth Debugger
可视化的 OAuth 与 EMA 请求调试器，带引导式 MCP OAuth 合规检查。支持协议版本：2025-03-26、2025-06-18、2025-11-25、2026-07-28（草案），以及 DCR、客户端预注册、CIMD。
CLI（命令行）
不需要图形界面时的快速调试方式：
# 探测服务器可用工具
npx @mcpjam/inspector@latest tools <server-url>
# 健康检查
npx @mcpjam/inspector@latest doctor <server-url>
# 列出所有资源
npx @mcpjam/inspector@latest resources <server-url>
# 执行 OAuth 检查
npx @mcpjam/inspector@latest oauth <server-url>
Evals（评估）
- 定义测试用例，指定期望的 tool calls
- 选择跑在哪些 LLM 上
- 批量运行，追踪准确率随时间变化
- 在 CI 中配置阈值，PR 低于阈值则阻止合并
CI/CD 集成
# GitHub Actions 示例
- name: Run MCPJam conformance checks
uses: mcpjam/inspector-action@v1
with:
server-url: ${{ env.MCP_SERVER_URL }}
checks: conformance,e2e,oauth
典型适用场景
- MCP 服务器开发调试：写完一个工具，手动在 Playground 里调用看返回，不用切到实际应用里复现。
- 跨客户端兼容性验证：在发布前，确认服务器在 ChatGPT App、Claude Desktop、Cursor 三种主流客户端下都能正常工作。
- OAuth 集成开发：用 OAuth Debugger 可视化走完整个授权流程，定位是哪一步出错。
- CI 回归拦截：每次 PR 自动跑测试用例集合，准确率低于阈值就打回，防止新代码破坏已有功能。
- Widget 开发：用 Widget Emulator 在本地渲染 openai/outputTemplate，不用实际打开 ChatGPT App。
坑与注意
网页版不支持 STDIO 服务器。本地开发的 MCP 服务器如果是 STDIO 模式，必须用桌面应用或终端方式运行，网页版无法连接。
私有访问链接每次重启变：终端启动时打印的那个访问链接，不要随手关掉终端。如果需要持久化登录状态，使用 MCPJAM_SESSION_TOKEN 环境变量配置（参见仓库文档）。
Skills 功能需要本地文件系统。Playground 里的 Skills 功能会读取本机文件系统，本地桌面应用可用，网页版受限。
16 种客户端配置是预置的。目前 Playground 默认预选了 ChatGPT、Claude、Cursor 三种，如需测试 Copilot 等其他客户端，需要在 Workspace 设置里手动添加配置。
版本号与 Node.js 要求：终端方式（npx）需要 Node.js 20+；桌面应用本身无此要求，自带运行时。
与同类对比
| 工具 | 跨客户端测试 | OAuth 调试 | CLI | CI/CD 集成 | 托管版 |
|---|---|---|---|---|---|
| MCPJam Inspector | ✅ 16 种配置 | ✅ 可视化 | ✅ | ✅ Actions | ✅ 免费网页版 |
| MCP官方 Inspector | ✅ 只官方实现 | ❌ | ❌ | ❌ | ❌ |
| Postman / Hoppscotch | 手动配置 | ❌ | ❌ | ❌ | 看托管方案 |
MCPJam Inspector 是目前唯一一个同时具备跨客户端评估、可视化 OAuth 调试、CLI、CI/CD 集成的 MCP 全栈调试平台，而且有免费托管版可以直接用。
一句话推荐结论
如果你在认真做 MCP 服务器开发，Inspector 几乎是必装的——用它做日常调试能省大量时间，用它的 Evals 功能给每次 PR 加回归拦截，比上线后才发现跨客户端挂掉要划算得多。