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

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

快速开始

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

检查已发布的服务器

将用于启动服务器的命令作为 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 客户端

终端导航和键盘参考。

配置和标志

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

授权

OAuth 流程详解、会话中途重新授权以及回环回调。

协议时代

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

配方

导入客户端配置、查看 MCP Apps、Docker 和网络托管。

调试指南

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