Skip to main content
MCP Inspector 是用于测试和调试 MCP 服务器 的参考开发者工具。它以单个软件包 @modelcontextprotocol/inspector 的形式发布，通过一个二进制文件提供三个客户端： 三者都构建于同一个共享核心之上，因此在不同客户端中的连接行为完全一致：使用相同的传输方式、相同的配置文件、磁盘上相同的 OAuth 状态，以及相同的协议时代协商机制（旧版与现代版 2026-07-28）。 该软件包还会安装 mcpdo，这是一个实验性的连接客户端，它使用同一个核心连接服务器一次，并在多次命令之间保持连接。

MCP Inspector Web 客户端在一次工具调用后已连接到服务器，并固定且加宽监控侧边栏，以便你在工作时持续查看清晰的 JSON-RPC 交换。

​
快速入门

Inspector 要求使用 Node 22.19.0 或更高版本，并可直接通过 npx 运行。无需安装：
该命令会输出一个带有每次启动专用 API 令牌的 URL，并在浏览器中打开它（设置 MCP_AUTO_OPEN_ENABLED=false 可阻止自动打开）。请参阅网页客户端。

​
检查已发布的服务器

将启动服务器的命令作为 Inspector 的参数传入，或使用 --server-url 指向远程服务器：
请始终先阅读服务器自身的 README，因为每个服务器所需的命令和参数都不同。
Inspector 会在操作系统钥匙串可用时将机密信息（OAuth 令牌、OAuth 客户端密钥和 stdio env: 值）存入钥匙串。 在没有钥匙串的机器上（没有 libsecret 或 Secret Service 的 Linux、无图形界面的 headless 或 SSH 会话、Termux，以及挂载了卷的容器），这些信息会改为保存到 ~/.mcp-inspector/secrets.json，除非提供密钥，否则不会加密。请参阅机密信息存储位置，了解如何恢复钥匙串、加密文件或仅将机密信息保留在内存中。

​
启动器标志与客户端标志

mcp-inspector 是 npx @modelcontextprotocol/inspector 运行的二进制程序，也是一个轻量级启动器。它只负责两件事：
  1. 模式标志：--web（默认）、--cli 或 --tui。最多只能指定一个；同时传入两个会报错：Specify at most one of --web, --cli, or --tui.
  2. -h / --help。
其他所有选项（--catalog、--config、--server-url、--transport、--method 以及 OAuth 标志）都由_客户端_定义，而不是由启动器定义，并且不同客户端定义的选项集合并不完全相同。配置与标志页面按照所属方组织了这些内容。
模式标志仅在命令行开头部分被识别：第一个不是 --web / --cli / --tui 的标记会结束启动器解析，之后的所有内容都会原样转发给客户端。这样就可以将字面量 --cli 放在后面，作为服务器自身的参数：
--help 在有无模式标志时的行为不同。未指定模式标志时，命令行中任意位置（即使位于服务器命令之后）的 -h / --help 都会打印启动器的帮助信息并退出。指定模式标志后，它会被转发，因此 mcp-inspector --cli --help 会改为打印 CLI 的完整标志参考。

​
接下来去哪里

Web 客户端

图形化检查器的逐标签页操作指南。

CLI 客户端

方法参考、输出格式、退出代码以及 CI 配方。

TUI 客户端

终端导航和键盘参考。

配置和标志

Catalog 与配置文件、完整的各客户端标志参考以及环境变量。

授权

OAuth 流程端到端说明、会话中途重新授权以及回环回调。

协议时代

旧版与现代版（2026-07-28）操作方式，以及每个标签页在不同协议时代之间的变化。

mcpdo 连接客户端

连接一次，然后针对命名连接运行多条命令。

安全性

威胁模型：Web 后端令牌、Docker、机密信息存储、stdio 服务器和 mcpdo 守护进程。

配方

导入客户端配置、审查 MCP Apps、Docker 以及网络托管。

调试指南

Inspector 之外更广泛的调试策略。