适合谁
- 正在开发或维护 MCP 服务器、需要验证协议行为的工程师
- 需要在 CI 中对 MCP 服务器做自动化回归测试的团队
- 需要深入排查 MCP 请求/响应细节（如自定义请求头、错误码）的高级用户
M
73FMRS · B
MCP Inspector 是 MCP 协议官方维护的开发调试工具，提供 Web、CLI、TUI 三种形态来检查任意 MCP 服务器的工具、资源、提示词及底层协议交互，适合协议开发和调试场景，但本身不是面向终端用户或 AI 客户端调用的业务型 MCP 服务器。
MCP Inspector 是 Model Context Protocol 官方仓库（modelcontextprotocol/inspector）维护的开发者工具，用于检查和调试 MCP 服务器，而非一个向 AI 客户端提供工具的 MCP 服务器本身。它以单一 npm 包 @modelcontextprotocol/inspector 发布，通过全局 mcp-inspector 命令提供三种使用形态：基于 Vite + React + Mantine 的 Web 界面（默认）、用于自动化和 CI 的可脚本化 CLI，以及基于 Ink 构建的交互式终端 UI（TUI）。三者共享 @inspector/core 中的连接逻辑、状态存储和 OAuth 实现，因此行为一致。项目当前处于 v2 主线（v2/main 分支），main 分支为仅修复缺陷的 v1 旧版本。仓库还内置了一套可组合的测试 MCP 服务器（test-servers/）及大量示例配置，用于演示分页、订阅、任务、日志、MRTR 多轮往返等协议特性。
工具能力
暂未整理工具清单。
安装接入
无需安装即可临时运行：npx @modelcontextprotocol/inspector（默认打开 Web UI），加 --cli 使用命令行模式，加 --tui 使用终端界面。若要从源码开发，需要 Node >=22.19.0，在仓库根目录运行 npm install（会级联安装到每个客户端子目录），再用 npm run build 构建，或在 clients/web 下用 npm run dev 进行 Web 端热更新开发。也可以使用官方发布的 Docker 镜像：docker run --rm -p 6274:6274 ghcr.io/modelcontextprotocol/inspector。
选型与风险
不适合谁
- 只想直接与 AI 助手对话、不关心底层协议的普通终端用户
- 需要托管式、免运维检查服务的场景（该工具需要本地或自建环境运行）
- 希望获得一个向 AI 客户端提供业务工具的 MCP 服务器（Inspector 本身是客户端/检查工具，不是被调用的工具服务器）
所需权限
- 运行 Node.js 进程并可能以子进程方式启动 stdio 类型的目标 MCP 服务器
- 对外发起网络连接，以 streamable-HTTP 等方式连接被检查的 MCP 服务器
- Web 模式下在本地绑定端口（默认 6274）并运行一个可发起进程的后端服务
- 读写本地配置文件（如 `--config`/`--catalog` 指定的 JSON 配置）
风险与副作用
- Web 后端具备进程派生能力，若通过 `DANGEROUSLY_BIND_ALL_INTERFACES=true` 绑定到 0.0.0.0，会将该后端暴露给本地网络，务必配合鉴权令牌使用
- 设置环境变量 `DANGEROUSLY_OMIT_AUTH=true` 会关闭鉴权，仅应在完全可信的环境中使用
- 通过 Inspector 连接不可信或恶意的 MCP 服务器时，其返回的工具调用结果会被代理展示，需自行判断被检查服务器的可信度
常见排障
- 确认本地 Node 版本 >=22.19.0，否则安装或运行会失败
- 首次克隆仓库或依赖变更后，需在根目录重新执行 `npm install` 以级联同步各客户端依赖
- 若通过 `-p` 重新映射 Docker 发布端口导致连接被拒（403），需设置 `ALLOWED_ORIGINS` 环境变量匹配浏览器实际访问的源
- 使用内置测试服务器配置前，需先执行 `npm run test-servers:build` 生成 `test-servers/build/`，否则会因找不到构建产物而无法以子进程方式启动
- 运行完整校验请使用 `npm run validate`（快速）或 `npm run coverage`（更严格的行/分支覆盖率门禁），而非查找不存在的根 `test` 脚本
使用场景
在开发过程中可视化查看某个 MCP 服务器暴露的工具、资源和提示词
通过 CLI 在 CI 流水线或自动化脚本中对 MCP 服务器做冒烟测试
使用 TUI 在终端中交互式地调用工具、观察日志和网络请求
调试协议细节，如分页、资源订阅、任务（tasks）、多轮往返（MRTR）等特性在新旧协议版本下的差异
支持客户端
暂未确认支持的客户端。