inspector

像调试代码一样调试 MCP 工具，让 AI 应用开发不再黑盒。

inspector 是一个用于测试和评估 MCP（模型上下文协议）服务器、MCP 应用及 ChatGPT 应用的调试与验证平台。它主要解决开发者在构建基于 MCP 的 AI 应用时，缺乏直观工具来查看、调试和评估工具调用链路的问题。核心能力包括：提供交互式聊天界面以实时测试 MCP 工具调用，支持对 MCP 服务器返回的上下文进行逐步检查，集成评估（evals）功能以量化模型输出质量，并支持与 CI/CD 流程集成，实现自动化回归测试。项目采用 TypeScript 编写，基于 Anthropic 和 OpenAI 的生态，为开发者提供从开发调试到上线评估的一体化工作流。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2222

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队MCPJam

所属国家

官网地址https://www.mcpjam.com

GitHubhttps://github.com/MCPJam/inspector

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言TypeScript

技术栈/模型anthropic,chatgpt,cicd,debugger,evals,evaluation,inspector,mcp,mcp-apps,mcp-clients,mcp-inspector,mcp-server,mcp-tools,modelcontextprotocol,oauth,oauth2,openai,openai-apps-sdk,opensource,tracing

GitHub 星标★ 2222

30天Star增速

HF 下载量

上线时间2025-05-23 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Node.js 20+（仅终端 npx 安装方式需要）
Docker（选择自行构建镜像时需要）
Git（选择 Docker 方式时用于克隆仓库）
桌面应用与托管网页无需本地 Node.js 运行时

安装与启动步骤

1选择运行方式

MCPJam Inspector 有三种用法：托管网页（免安装、仅 HTTPS）、Mac/Windows 桌面应用、终端或 Docker。按需选一种即可。
2终端一键启动

终端方式支持 HTTP/S 与本地 STDIO 服务器，首次运行会自动拉取包并启动服务。需 Node.js 20+。
```
npx @mcpjam/inspector@latest
```
3打开本地界面

启动后终端会打印一个 localhost 地址，在浏览器中打开该地址即可进入交互式调试界面。
4克隆源码仓库

Docker 方式没有官方镜像，必须先克隆源码再本地构建，因此先拉取仓库并进入目录。
```
git clone https://github.com/MCPJam/inspector.git
cd inspector
```
5构建 Docker 镜像

使用仓库内的 Dockerfile 构建本地镜像，镜像名可自定义，示例为 mcpjam/mcp-inspector:local。
```
docker build -t mcpjam/mcp-inspector:local -f mcpjam-inspector/Dockerfile .
```
6启动容器

端口映射必须带 127.0.0.1 前缀，让服务只监听本机；容器启动后访问 http://127.0.0.1:6274。
```
docker run -p 127.0.0.1:6274:6274 mcpjam/mcp-inspector:local
```
7或用桌面应用

不想装 Node.js 可直接下载安装包：Mac 下载 MCPJam.Inspector.dmg，Windows 下载 MCPJam-Inspector-Setup.exe。

关键配置

配置项	必填	说明	示例
`6274`	是	本地 inspector 的默认监听端口，Docker 映射时使用	`-p 127.0.0.1:6274:6274`
`host.docker.internal`	否	macOS/Windows 下容器访问宿主机 MCP 服务器的地址	`http://host.docker.internal:3000`

如何确认成功

终端启动后打开打印出的 localhost 地址；Docker 方式访问 http://127.0.0.1:6274 能看到调试界面即成功。

常见问题

Q：托管网页版能连本地 STDIO 服务器吗？

A：不能。托管网页只支持 HTTPS 服务器 URL，没有 STDIO、隧道、skills 和 tasks，这些必须使用本地 inspector。

Q：可以直接 docker pull 官方镜像吗？

A：不能，官方没有发布镜像，需要先 git clone 源码，再用仓库里的 Dockerfile 自行 build。

Q：运行 npx 命令报环境错误怎么办？

A：确认 Node.js 版本为 20 或以上；托管网页与桌面应用无需 Node.js，也可改用这两种方式。

Q：Docker 容器里怎么连宿主机的 MCP 服务？

A：在 macOS/Windows 上通过 http://host.docker.internal:PORT 访问宿主机端口，把 PORT 换成实际端口。

Q：端口映射为什么不能写成 -p 6274:6274？

A：那样会监听所有网卡，可能把调试界面暴露到公网；必须用 -p 127.0.0.1:6274:6274 保持仅本机可访问。

注意事项

托管网页版始终是最新版，可分享服务器链接给同事，但仅限 HTTPS 服务器地址。
Docker 端口映射务必保留 127.0.0.1 前缀，避免把 inspector 暴露到外部网络。
桌面应用支持 HTTP/S 和本地 STDIO，且不依赖 Node.js，适合不想配置命令行的用户。

核心亮点

提供可视化聊天界面，可实时调用并检查 MCP 工具返回的原始上下文，问题定位直观。
内置评估（evals）框架，可对模型输出进行自动化质量打分，便于回归测试。
支持与 CI/CD 集成，能无缝嵌入现有开发流程，提升迭代效率。

不足之处

主要面向 MCP 生态，对非 MCP 或传统 API 的调试支持有限。
文档/社区待观察，项目处于成长阶段，中文资料和案例较少。

适用场景

开发 MCP 服务器时，需要调试工具调用参数和返回结果。
为基于 MCP 的 AI 应用编写自动化评估用例，确保输出质量。
在 CI 流水线中集成 MCP 应用的冒烟测试和回归测试。

替代项目

MCP Inspector（官方工具）、LangSmith、Promptfoo

项目介绍

inspector 是智能体领域的开源项目，由 MCPJam 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,222）位列前 30%，在智能体分类中处于中上游。

近 45 天，它的 GitHub 星标从 2,120 增加到 2,222，净增 102。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：开发MCP服务器时，需要调试工具调用参数和返回结果。同类可对比的替代方案包括 MCP Inspector（官方工具）、LangSmith、Promptfoo。

上一篇：awesome-codex-pet

下一篇：langflow