← 返回目录

MCP Inspector

官方

非标准 Server

用于调试和可视化测试 MCP 服务器的开发者工具

这不是典型的可直接连接的 MCP Server，使用前请先阅读源仓库说明。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 10 / 438
Stars: ★ 11.2k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js >=22.19.0 · Docker
凭据: 可选 API Key
许可证: 其他 / 未声明
最近提交: 6 天前

73FMRS · B

MCP Inspector 是 MCP 协议官方维护的开发调试工具，提供 Web、CLI、TUI 三种形态来检查任意 MCP 服务器的工具、资源、提示词及底层协议交互，适合协议开发和调试场景，但本身不是面向终端用户或 AI 客户端调用的业务型 MCP 服务器。

最强项 · 文档质量 18/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

15/20

维护活跃度

17/20

文档质量

18/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: README 详细描述了构建/测试体系（validate、coverage 的按文件≥90%覆盖率门槛、smoke 端到端冒烟测试含无头 Chromium 启动检查、verify:build-gate、pack:verify 对打包后 tarball 的真实安装验证），并引用了 .github/workflows/main.yml 等真实工作流文件路径，这些描述具有较高可信度。但本次审查未提供服务器 manifest 或工具列表（标注为 not cached），无法核实 MCP 初始化/工具列表握手的真实行为；且 Inspector 本身是用于测试其它 MCP 服务器的工具，而非典型的单一工具 MCP 服务端，其'声明工具'与'真实行为'的对应关系无法从现有材料验证。按静态校准规则，未直接读取工作流与测试文件本身，只能依据 README 描述，因此保持保守评分，未给出可执行验证证据的加分。
安全与权限 15/20: 文档披露了较为审慎的默认安全姿态：默认拒绝绑定 0.0.0.0（所有网络接口），需要显式设置 DANGEROUSLY_BIND_ALL_INTERFACES=true 才能开启；认证默认开启，需要显式 DANGEROUSLY_OMIT_AUTH=true 才能关闭，且危险选项均以 'DANGEROUSLY_' 前缀明确标识；容器内以非 root 用户 node 运行；ALLOWED_ORIGINS 提供来源白名单机制。这些都体现了显式确认与最小权限意识，不构成红线风险。但同时也承认后端具备'进程生成'（process-spawning）能力并可暴露给本地网络，README 未详细说明生成子进程的沙箱隔离、权限限制或密钥（如 OAuth 令牌、API Token）在磁盘/日志中的具体保护方式，数据流披露不完整，故未给满分。
维护活跃度 17/20: 证据显示项目治理成熟：采用 v2/main 与 legacy main 分支策略、issue 驱动工作流（PR 需关联 Closes #issue）、AGENTS.md/CLAUDE.md 贡献规范、通过 GitHub Actions 实现基于 OIDC 的可信发布（trusted publishing，含 provenance 签名）、发布流程含标签与版本号校验，且正文多处引用具体 issue 编号（如 #1636、#1769、#1791、#1792 等）显示活跃的问题跟踪。README 明确包含 'License: MIT' 章节，但题目提供的仓库元数据字段标注 License 为 unknown，存在信息不一致，属轻微减分项；另外未见明确的安全响应渠道（如 SECURITY.md 或安全联系方式）说明，也做相应扣分。
文档质量 18/20: 文档层次丰富：主 README、各 client 独立 README、docs/ 目录下的任务导向指南（如 MCP 服务器配置、App 审查流程）、AGENTS.md 贡献契约、specification/ 规格与图示，以及针对测试服务器各类协议特性（分页、订阅、任务、日志、MRTR 等）的详尽示例配置表格与预期行为说明，体现出少见的技术深度和自证性。也披露了一些边界与已知限制（如浏览器环境下跳过 Mcp-Param 头镜像、SDK v2 移除 tasks 支持等）。轻微不足：缺少集中的'故障排查'章节和使用成本说明（虽然作为免费开源工具成本项相关性较低）。
安装易用性 13/20: 安装路径描述清晰：npx 一键运行三种模式（web/cli/tui）、Docker 运行示例及环境变量说明（含端口重映射导致的 origin 不匹配及解决方式），并有 pack:verify 脚本模拟真实 npx 安装流程用以验证发布产物。但按静态校准规则，未能直接读取工作流/测试文件加以核实，只能视为 README 自述，故不能给出高于 15 分的分数；同时该工具本身是独立的检测客户端，而非嵌入宿主应用（如 Claude Desktop）的典型 MCP 服务器，README 未提供'加入某主流客户端配置'的示例，与常规 setup 维度期待的场景略有偏差，因此适度扣分。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

正在开发或维护 MCP 服务器、需要验证协议行为的工程师
需要在 CI 中对 MCP 服务器做自动化回归测试的团队
需要深入排查 MCP 请求/响应细节（如自定义请求头、错误码）的高级用户

不适合谁

只想直接与 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.js >=22.19.0 · Docker

MCP_INSPECTOR_API_TOKEN 可选密钥 Web 后端 API 的认证令牌；不设置时自动生成并打印在容器日志中。

其他可选配置项（5 个）

DANGEROUSLY_OMIT_AUTH 可选设为 true 时禁用 Web UI 的身份验证，仅限本地调试。

DANGEROUSLY_BIND_ALL_INTERFACES 可选设为 true 才允许绑定 0.0.0.0 所有网卡，容器镜像中已默认开启。

ALLOWED_ORIGINS 可选覆盖默认的允许来源列表，端口重映射（如 -p 8080:6274）时需设置为浏览器的实际 origin。

CLIENT_PORT 可选指定客户端端口，用于与重映射端口保持一致。

INSPECTOR_SKIP_CLIENT_INSTALL 可选开发时设为 1 可跳过根安装级联到各客户端的 npm install。

无需安装即可临时运行：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。

验证是否装好

运行 npx @modelcontextprotocol/inspector，若 Web UI 在 http://localhost:6274 正常打开并显示身份令牌日志，或运行 npx @modelcontextprotocol/inspector --cli --help 正确分发命令，即说明安装成功。

常见排障

确认本地 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` 脚本

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 CLI 模式运行 npx @modelcontextprotocol/inspector --cli，列出我本地 MCP 服务器的工具
启动 Inspector 的 Web UI 并连接到我的 stdio MCP 服务器，查看它的资源和提示词
加载 test-servers 的 mrtr-showcase-http. 配置，演示一次 MRTR 多轮工具调用
用 TUI 模式打开 Inspector，检查一个 streamable-HTTP 服务器的分页工具列表

使用场景

在开发过程中可视化查看某个 MCP 服务器暴露的工具、资源和提示词

通过 CLI 在 CI 流水线或自动化脚本中对 MCP 服务器做冒烟测试

使用 TUI 在终端中交互式地调用工具、观察日志和网络请求

调试协议细节，如分页、资源订阅、任务（tasks）、多轮往返（MRTR）等特性在新旧协议版本下的差异

详细介绍

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 多轮往返等协议特性。