Skip to main content
MCP Inspector 是用于测试和调试 MCP 服务器 的参考开发者工具。它以单个软件包 @modelcontextprotocol/inspector 的形式发布,通过一个二进制文件提供三个客户端 三者都构建于同一个共享核心之上,因此在不同客户端中的连接行为完全一致:使用相同的传输方式、相同的配置文件、磁盘上相同的 OAuth 状态,以及相同的协议时代协商机制(旧版与现代版 2026-07-28)。

MCP Inspector Web 客户端已连接到服务器,并固定显示监控侧边栏,以便你在工作时持续查看协议流量。

快速入门

Inspector 要求使用 Node 22.19.0 或更高版本,并可直接通过 npx 运行。无需安装:
该命令会输出一个包含一次性会话令牌的 URL;请在浏览器中打开它。请参阅网页客户端

检查已发布的服务器

将启动服务器的命令作为 Inspector 的参数传入,或使用 --server-url 指向远程服务器:
请始终先阅读服务器自身的 README,因为每个服务器所需的命令和参数都不同。

启动器标志与客户端标志

mcp-inspectornpx @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 在有无模式标志时的行为不同。单独使用 mcp-inspector --help 时,会打印启动器的帮助信息并退出。指定模式标志后,它会被转发,因此 mcp-inspector --cli --help 会改为打印 CLI 的完整标志参考。

接下来去哪里

Web 客户端

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

CLI 客户端

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

TUI 客户端

终端导航和键盘参考。

配置和标志

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

授权

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

协议时代

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

配方

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

调试指南

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