面向 MCP 服务器的全栈调试与评估平台，提供 App 构建、多模型对比聊天、OAuth 合规验证及 CI/CD 自动化测试能力。
核心定位#
MCPJam Inspector 由 MCPJam Inc 维护，旨在解决 MCP 服务器开发中调试门槛高（通常需要 ngrok 或 ChatGPT/Claude 订阅）、OAuth 合规验证复杂、多模型工具调用对比缺乏免费工具、以及缺乏端到端回归测试手段等问题。
能力与特性#
开发与调试#
- App Builder：在面板内与 LLM 对话或手动调用工具，兼容 OpenAI Apps SDK 和 MCP app UIs。
- App UI 模拟器：Chrome DevTools 风格，支持桌面/平板/手机视图切换、locale 切换、CSP 模拟、暗色/亮色模式、hover & touch 交互、safe area insets 模拟。
- MCP Server Debugging：手动运行 tools / resources / resource templates / prompts / elicitation flows，提供完整 JSON-RPC 可观测性日志。
对话与模型评估#
- 多模型 Chat：支持多服务器多模型对话，内置免费前沿模型访问。提供 Chat / Trace / Raw 三种视图，最多 3 个模型并排对比，可查看 token 用量。
- Evals：定义带预期工具调用的测试用例，跨多个 LLM 运行并追踪准确率指标，用于回归检测。
安全与合规#
- OAuth Debugger：引导式 MCP OAuth 合规性检查，覆盖 OAuth spec 版本 03-26、06-18、11-25，支持 DCR（Dynamic Client Registration）、client pre-registration、CIMD（Client ID Metadata Documents）。
协作与扩展#
- Workspaces：服务器分组共享与团队实时同步。
- Skills：在 Chat 和 App Builder 中使用本地可复用行为扩展模型，数据不离开本机。
工程化集成#
- 通过 GitHub Actions / GitLab CI 等管线运行 conformance、E2E 测试和 evals，可作为 PR 门禁。
架构要点#
- 采用 npm workspaces 管理的 Monorepo 架构，包含 6 个子包：
sdk（@mcpjam/sdk）、cli（@mcpjam/cli）、mcpjam-inspector（@mcpjam/inspector）、design-system、soundcheck（评估/测试）、mcp。 - 核心包内部划分为
client/和server/目录，server 侧包含services/及特定路由。 - 通过
check:mcp-v1-runtime-imports脚本强制检查，确保运行时不依赖@modelcontextprotocol/sdk。 - 前端以 TypeScript (98.6%) 为主，基于 React 构建，引入
react-force-graph-2d等可视化库，抽离独立design-system包。 - 使用
@changesets/cli进行版本管理和发布。 - Docker 部署默认绑定
127.0.0.1:6274防止端口暴露；Web 端强制仅允许 HTTPS MCP 服务器 URL。
安装与快速开始#
托管 Web 应用（零安装）：直接访问 https://app.mcpjam.com（仅支持 HTTPS MCP 服务器 URL）
终端本地运行：
npx @mcpjam/inspector@latest
要求 Node.js 20+，启动后根据终端打印的 localhost URL 在浏览器中打开。
Docker 容器化：
docker run -p 127.0.0.1:6274:6274 mcpjam/mcp-inspector
桌面应用：提供 Mac 和 Windows 安装程序，支持 HTTP/S 和本地 STDIO 服务器连接，无需预装 Node.js（具体下载链接待确认）。
CLI 与 SDK#
- CLI (
@mcpjam/cli)：支持 probe 探测、OAuth 检查（doctor）、工具与资源检查、evals 评估。 - SDK (
@mcpjam/sdk)：编程式访问 MCPJam 检查和评估原语，便于集成到自定义工具链。 - 两者均可接入 GitHub Actions 或 GitLab CI 管线，实现自动化门禁。
生态伙伴#
与 Stytch（OAuth provider）、xMCP（TypeScript MCP framework）、Alpic（MCP server hosting）有合作提及。内置 railway.json 配置支持一键部署到 Railway 平台。
待确认信息#
- 具体版本号（仓库使用 changesets 管理，未在 README 标注）
- Docker Hub 镜像确切可用性
- 桌面应用具体下载链接
- evals 子模块独立许可证详情
- Discord 社区具体邀请链接