MCP Inspector
社区译文；来源： MCP 80041ab0
MCP Inspector 是用于测试与调试 MCP 服务器的参考开发工具。它以单个包 @modelcontextprotocol/inspector 的形式发布，在一个二进制中提供三种客户端：
| 客户端 | 调用方式 | 用途 |
|---|---|---|
| Web | npx @modelcontextprotocol/inspector | 浏览器中的完整图形化 Inspector。默认选项，也是功能最丰富的界面。 |
| CLI | npx @modelcontextprotocol/inspector --cli | 面向 CI、shell 管线和编码代理的可脚本化、机器可读客户端。 |
| TUI | npx @modelcontextprotocol/inspector --tui | 交互式终端 UI，适用于没有浏览器或不希望使用浏览器的情形。 |
三者都构建在同一个共享核心之上，因此连接在它们之间的行为完全一致：相同的传输方式、相同的配置文件、磁盘上相同的 OAuth 状态，以及相同的协议世代协商（legacy 与 2026-07-28 的 modern）。
该包还会安装 mcpdo，这是一个实验性的连接客户端，同样基于共享核心，它连接到服务器一次，并在多条命令之间保持连接。
快速开始
Inspector 要求 Node 22.19.0 或更高版本，并直接通过 npx 运行。无需安装：
Web
# Launch the web UI and connect to a local stdio server
npx @modelcontextprotocol/inspector node path/to/server/index.js
# Or launch with no target and add servers from the UI
npx @modelcontextprotocol/inspector该命令会打印一个携带每次启动独立 API token 的 URL，并在浏览器中打开它（设置 MCP_AUTO_OPEN_ENABLED=false 可阻止其自动打开）。参见 Web 客户端。
CLI
# List a server's tools and exit
npx @modelcontextprotocol/inspector --cli node path/to/server/index.js --method tools/list
# Call a tool and pipe the result into jq
npx @modelcontextprotocol/inspector --cli https://api.example.com/mcp --transport http \
--method tools/call --tool-name get_weather --tool-arg city=Boston --format json | jq .result参见 CLI 客户端。
TUI
npx @modelcontextprotocol/inspector --tui node path/to/server/index.js参见 TUI 客户端。
检查已发布的服务器
把启动服务器的命令作为 Inspector 的参数传入，或用 --server-url 将其指向远程服务器：
npm 包
npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem ~/DesktopPyPI 包
npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git远程 HTTP 服务器
npx @modelcontextprotocol/inspector --server-url https://api.example.com/mcp --transport http始终先阅读服务器自己的 README，因为每个服务器所需的命令和参数都不相同。
env: 值）存入操作系统钥匙串。 在没有
钥匙串的机器上（未安装 libsecret 或没有 Secret Service 的 Linux、无头与
SSH 会话、Termux，以及挂载了卷的容器），它们会被改为保存在
~/.mcp-inspector/secrets.json 中，除非你提供密钥，否则不加密。
关于如何恢复钥匙串、加密该文件或仅把机密留在内存中，参见
机密存储于何处。启动器 flag 与客户端 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 才能稍后出现在你自己的服务器参数之中：
mcp-inspector --cli node server.js --cli # mode is CLI; the trailing --cli goes to server.js--help 在有模式 flag 和无模式 flag 时行为不同。没有模式 flag 时，
命令行上任意位置的 -h/--help（即使在服务器命令之后）都会打印
启动器的帮助并退出。有模式 flag 时它会被转发，因此
mcp-inspector --cli --help 打印的是 CLI 的完整 flag 参考。接下来该读什么
Web 客户端
逐个标签页介绍图形化 Inspector 的走查。
CLI 客户端
方法参考、输出格式、退出码与 CI 配方。
TUI 客户端
终端导航与键盘参考。
配置与 flag
Catalog 与配置文件的区别、按客户端的完整 flag 参考，以及环境变量。
授权
端到端的 OAuth 流程、会话中途重新授权，以及 loopback 回调。
协议世代
Legacy 与 modern（2026-07-28）两种工作方式，以及每个标签页在两种协议世代之间如何变化。
mcpdo 连接客户端
连接一次，然后针对具名连接运行多条命令。
安全
威胁模型：web 后端的 token、Docker、机密存储、stdio 服务器，以及 mcpdo 守护进程。
配方
导入客户端配置、审查 MCP Apps、Docker，以及网络托管。
调试指南
Inspector 之外的更广泛调试策略。