用于测试和调试 MCP 服务器的开发者工具,提供网页、命令行和终端界面三种使用方式。
MCPJam/inspector
开源的 MCP 服务器测试与评估平台,用于检查、对话和调试 MCP 服务器与应用。
- Star
- 2,274
- Fork
- 297
- 未关闭 Issue
- 316
- 最近提交
- 4小时前
这是什么?
MCPJam Inspector 是面向 MCP 服务器开发者的测试与评估平台。你可以手动调用工具、资源、提示词和 elicitation 流程,并查看完整的 JSON-RPC 日志与 OAuth 交互过程。Playground 支持让模型基于你的服务器进行对话,包括 OpenAI Apps SDK 和 MCP 应用界面,并内置组件模拟器,可在桌面、平板和手机尺寸下预览页面。
项目还覆盖评估与回归测试。你可以编写带有预期工具调用的测试用例,在多个 LLM 上运行,并随时间跟踪准确率。内置的引导式 OAuth 调试器可对照多个版本的 MCP 授权规范进行一致性检查,包括动态客户端注册和 CIMD。
在自动化方面,MCPJam 提供 CLI 和 SDK,可在 GitHub Actions 或其他 CI 系统中对每个 PR 运行一致性、端到端、评估和 OAuth 检查。它以托管网页应用、适用于 Mac 和 Windows 的桌面应用,以及 npx 或 Docker 的方式提供。
核心功能
- 01Playground 可基于 LLM 测试工具调用,并提供工具调用与 JSON-RPC 消息的完整追踪。
- 02为 OpenAI Apps SDK 和 MCP 应用界面提供组件模拟器,支持桌面、平板和手机尺寸预览。
- 03引导式 OAuth 调试器,覆盖多个 MCP 授权规范版本,并支持 DCR 和 CIMD。
- 04评估功能可设定预期工具调用,并跨多个 LLM 跟踪准确率。
- 05提供 CLI 和 SDK,可在终端或自有测试中探测服务器并运行检查。
- 06支持集成到 CI/CD,在每个 PR 上运行一致性、端到端和评估检查。
适用场景
- 在将 MCP 服务器接入 ChatGPT、Claude 或 Cursor 之前,调试其工具和提示词。
- 逐步检查 MCP 服务器的 OAuth 配置,定位授权错误。
- 工具定义变更时,在多个 LLM 上运行回归评估。
- 在 GitHub Actions 中通过 MCP 一致性测试来控制 PR 合并。
快速上手
- 1
在浏览器中打开托管应用(无需安装)
- 2
或使用 npx 在本地运行 MCPJam(需要 Node.js 20+)
npx @mcpjam/inspector@latest
使用前须知
- 托管网页应用仅支持 HTTPS 服务器地址,不支持 STDIO 服务器。
- 终端安装需要 Node.js 20 或更高版本。
- 桌面应用仅提供 Mac 和 Windows 版本。
- 仓库元数据未显示明确许可证(NOASSERTION),但 README 声明为 Apache 2.0。
标签
常见问题
- inspector 是什么?
- 开源的 MCP 服务器测试与评估平台,用于检查、对话和调试 MCP 服务器与应用。 MCPJam Inspector 是面向 MCP 服务器开发者的测试与评估平台。你可以手动调用工具、资源、提示词和 elicitation 流程,并查看完整的 JSON-RPC 日志与 OAuth 交互过程。Playground 支持让模型基于你的服务器进行对话,包括 OpenAI Apps SDK 和 MCP 应用界面,并内置组件模拟器,可在桌面、平板和手机尺寸下预览页面。
- inspector 可以免费使用吗?用的什么许可证?
- inspector 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
- inspector 还在维护吗?
- 活跃维护中。inspector 最近一次提交是在 2026年10月22日。
- inspector 适合用来做什么?
- 在将 MCP 服务器接入 ChatGPT、Claude 或 Cursor 之前,调试其工具和提示词。 逐步检查 MCP 服务器的 OAuth 配置,定位授权错误。 工具定义变更时,在多个 LLM 上运行回归评估。 在 GitHub Actions 中通过 MCP 一致性测试来控制 PR 合并。
- inspector 怎么安装和运行?
- 在浏览器中打开托管应用(无需安装) 或使用 npx 在本地运行 MCPJam(需要 Node.js 20+): npx @mcpjam/inspector@latest
- 在哪里获取 inspector?
- 源代码和安装说明在 GitHub 上:https://github.com/MCPJam/inspector
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
用于测试、调试和自动化 MCP 服务器的终端 UI 与命令行工具,支持 stdio、SSE 和 HTTP。
一个命令行工具,可将 MCP 服务器一键安装到 Claude Desktop、Cursor、VS Code 等多种 AI 客户端中。
用 TypeScript 构建 MCP 服务器、带 React 视图的 MCP 应用和客户端的全栈框架,内置调试器和 CLI。
用于测试 LLM 应用输出的 Python/TypeScript 评估库,提供现成评估器和 LLM-as-judge 打分。
用于编译、部署、测试和调试以太坊智能合约与去中心化应用的开发环境。