@modelcontextprotocol/inspector 的形式提供,通过一个二进制文件提供三个客户端:
这三者都构建于同一个共享核心之上,因此连接在不同客户端中的行为完全一致:使用相同的传输方式、相同的配置文件、磁盘上相同的 OAuth 状态,以及相同的协议时代协商机制(旧版与现代版 2026-07-28)。
MCP Inspector Web 客户端已连接到服务器,并固定监控侧边栏,以便在工作时持续查看协议流量。
快速开始
Inspector 要求使用 Node 22.19.0 或更高版本,并可直接通过npx 运行。无需安装:
- 网页
- CLI
- TUI
检查已发布的服务器
将用于启动服务器的命令作为 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 客户端
终端导航和键盘参考。
配置和标志
目录与配置文件、完整的客户端标志参考以及环境变量。
授权
OAuth 流程详解、会话中途重新授权以及回环回调。
协议时代
旧版与现代版(2026-07-28)操作,以及每个标签页在不同协议时代之间的变化。
配方
导入客户端配置、查看 MCP Apps、Docker 和网络托管。
调试指南
Inspector 之外的更广泛调试策略。