@modelcontextprotocol/inspector 的形式发布,在一个二进制文件背后提供三个客户端:
三者都构建在同一共享核心之上,因此连接在它们之间表现完全一致:相同的传输、相同的配置文件、磁盘上相同的 OAuth 状态,以及相同的协议时代协商(旧式 vs. 现代 2026-07-28)。

MCP Inspector Web 客户端,已连接到一个服务器,并固定了监控侧边栏,以便你工作时协议流量始终可见。
快速开始
Inspector 需要 Node 22.19.0 或更新版本,并直接通过npx 运行。无需安装:
- Web
- CLI
- TUI
检查已发布的服务器
将启动服务器的命令作为 Inspector 的参数传入,或用--server-url 指向一个远程服务器:
- npm package
- PyPI package
- Remote HTTP server
启动器 flag vs. 客户端 flag
mcp-inspector(即 npx @modelcontextprotocol/inspector 所运行的二进制文件)是一个轻量的启动器。它只掌管两样东西:
- 模式 flag:
--web(默认)、--cli或--tui。至多一个;传入两个会报错Specify at most one of --web, --cli, or --tui. -h/--help。
--catalog、--config、--server-url、--transport、--method、OAuth flag)都由_客户端_定义,而非启动器,并且各客户端并不都定义相同的集合。配置与 flag 页面正是按此方式(按归属者)组织的。
模式 flag 仅在命令行最前端被识别:第一个不是
--web / --cli / --tui 的 token 会结束启动器解析,其后的一切都原样转发给客户端。这正是让一个字面量 --cli 稍后可以作为你服务器自身参数之一出现的原因:--help 在有无模式 flag 时行为不同。裸的 mcp-inspector --help 会打印启动器的帮助并退出。带模式 flag 时它会被转发,因此 mcp-inspector --cli --help 会改为打印 CLI 的完整 flag 参考。接下来去哪里
Web 客户端
图形化 inspector 的逐标签页讲解。
CLI 客户端
方法参考、输出格式、退出码和 CI 配方。
TUI 客户端
终端导航和键盘参考。
配置与 flag
目录(catalog)vs. 配置文件、完整的按客户端 flag 参考,以及环境变量。
授权
端到端的 OAuth 流程、会话中途重新授权,以及 loopback 回调。
协议时代
旧式 vs. 现代(2026-07-28)操作,以及每个标签页在协议时代之间如何变化。
配方
导入客户端配置、审查 MCP 应用、Docker 和网络托管。
调试指南
超越 Inspector 的更广泛调试策略。