Skip to main content
MCP Inspector 是用于测试和调试 MCP 服务器 的参考开发者工具。它以单个软件包 @modelcontextprotocol/inspector 的形式提供，通过一个二进制文件提供三个客户端： 这三者都构建于同一个共享核心之上，因此连接在不同客户端中的行为完全一致：使用相同的传输方式、相同的配置文件、磁盘上相同的 OAuth 状态，以及相同的协议时代协商机制（旧版与现代版 2026-07-28）。 该软件包还会安装 mcpdo，这是一个实验性的连接客户端，基于同一个核心连接到服务器一次，并在多条命令之间保持连接打开。

MCP Inspector Web 客户端完成工具调用后，固定并展开监控侧边栏，以便在工作时清晰查看 JSON-RPC 交换内容。

​
快速开始

Inspector 要求使用 Node 22.19.0 或更高版本，并可直接通过 npx 运行。无需安装：
该命令会输出一个携带每次启动专用 API 令牌的 URL，并在浏览器中打开它（设置 MCP_AUTO_OPEN_ENABLED=false 可阻止自动打开）。请参阅 Web 客户端。

​
检查已发布的服务器

将用于启动服务器的命令作为 Inspector 的参数传入，或者通过 --server-url 指向远程服务器：
请始终先阅读服务器自己的 README，因为每个服务器所需的命令和参数都不同。
Inspector 会在可用时将机密信息（OAuth 令牌、OAuth 客户端密钥和 stdio env: 值）存储在操作系统密钥链中。 在没有密钥链的计算机上（没有 libsecret 或 Secret Service 的 Linux、无头和 SSH 会话、Termux，以及挂载了卷的容器），这些 信息会改为保存到 ~/.mcp-inspector/secrets.json，除非提供密钥，否则不会加密。 有关如何恢复密钥链、加密该文件或仅将机密信息保存在内存中，请参阅机密信息存储位置。

​
启动器标志与客户端标志

mcp-inspector 是 npx @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 在有无模式标志时的行为不同。不带模式标志时，命令行中任意位置（甚至在服务器命令之后）的 -h / --help 都会打印启动器的帮助信息并退出。带有模式标志时，它会被转发，因此 mcp-inspector --cli --help 会改为打印 CLI 的完整标志参考。

​
接下来阅读

Web 客户端

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

CLI 客户端

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

TUI 客户端

终端导航和键盘参考。

配置和标志

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

授权

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

协议时代

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

mcpdo 连接客户端

连接一次，然后针对命名连接运行多条命令。

安全性

威胁模型：Web 后端令牌、Docker、机密信息存储、stdio 服务器和 mcpdo 守护进程。

配方

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

调试指南

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