Repolode
MCPJam

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. 1

    在浏览器中打开托管应用(无需安装)

  2. 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 数据每日更新。

相关项目