@modelcontextprotocol/inspector 的形式发布,通过一个二进制文件提供三个客户端:
三者都构建于同一个共享核心之上,因此在不同客户端中的连接行为完全一致:使用相同的传输方式、相同的配置文件、磁盘上相同的 OAuth 状态,以及相同的协议时代协商机制(旧版与现代版 2026-07-28)。
MCP Inspector Web 客户端已连接到服务器,并固定显示监控侧边栏,以便你在工作时持续查看协议流量。
快速入门
Inspector 要求使用 Node 22.19.0 或更高版本,并可直接通过npx 运行。无需安装:
- 网页
- 命令行
- 终端界面
检查已发布的服务器
将启动服务器的命令作为 Inspector 的参数传入,或使用--server-url 指向远程服务器:
- npm 包
- PyPI 包
- 远程 HTTP 服务器
启动器标志与客户端标志
mcp-inspector 是 npx @modelcontextprotocol/inspector 运行的二进制程序,也是一个轻量级启动器。它只负责两件事:
- 模式标志:
--web(默认)、--cli或--tui。最多只能指定一个;同时传入两个会报错:Specify at most one of --web, --cli, or --tui. -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 之外更广泛的调试策略。