项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2305
技术标签
使用教程
环境要求
- 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
下一篇：langflow
同类项目推荐
tinyflow
开源
几行代码把 AI 智能体嵌进网页，前端轻量不折腾
Tinyflow is a lightweight AI agent solution.
mcp-server-chart
开源
让 AI 一句话生成 25+ 种专业图表，数据分析可视化一步到位
A visualization mcp & skills contains 25+ visual charts using @antvis. Using for cha···
jupyter-ai-agents
开源
在 JupyterLab 里和 AI 对话，自动写代码跑数据
AI Agents with MCP tools and Skills for JupyterLab — Chat with your Notebook and ···
COG-second-brain
开源
让 AI 自建知识库，闭环验证不糊弄
Self-evolving second brain with 35 AI skills, 10 agents, and people CRM. Closed-loop···
scope-recall-hermes
开源
给 Hermes Agent 装上精准记忆，混合检索让召回更聪明。
Local long-term memory for Hermes, Codex, Claude Code, WorkBuddy and dsh agents: one···
Lexora
开源
让 AI 住进你的桌面，自己动手把活干完
A self-evolved, sovereign desktop AI agent built for real-world action — beyond mod···
xiaomo-starter-kit
开源
5分钟搭好中文AI私人助手，开箱即用
⬛ OpenClaw 中文 AI 助手模板 | 5分钟拥有你的 AI 私人助手
airbyte-agent-sdk
开源
让AI代理安全可靠地接入外部系统，开箱即用
Drop-in tools that give AI agents reliable, permission-aware access to external syst···
agenthatch
开源
把任意技能一键封装成能检索的 AI 智能体，命令行直接跑
Turn any skill into a standalone, runnable RAG-native AI Agent