MCP Inspector

Interactive developer tooling for testing and debugging MCP servers, in the browser, on the command line, and in the terminal

MCP Inspector 是用于测试和调试 MCP 服务端 的参考开发者工具。它以单个包 @modelcontextprotocol/inspector 的形式发布，在一个二进制文件背后提供三种客户端：

Client	Invocation	What it's for
Web	npx @modelcontextprotocol/inspector	A full graphical inspector in the browser. The default, and the richest surface.
CLI	npx @modelcontextprotocol/inspector --cli	A scriptable, machine-readable client for CI, shell pipelines, and coding agents.
TUI	npx @modelcontextprotocol/inspector --tui	An interactive terminal UI, for when a browser isn't available or wanted.

三者都构建在同一个共享核心之上，因此同一个连接在它们之间的行为完全一致：相同的传输方式、相同的配置文件、磁盘上相同的 OAuth 状态，以及相同的协议时代协商（传统 vs. 现代 2026-07-28）。

The MCP Inspector web client, connected to a server, with the monitoring sidebar pinned so protocol traffic stays visible while you work.

快速开始

Inspector 需要 Node 22.19.0 或更新版本，并直接通过 npx 运行。无需安装：

# 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

该命令会打印一个包含一次性会话令牌的 URL；在浏览器中打开它。参见 Web 客户端。

查看已发布的服务器

将启动服务端的命令作为 Inspector 的参数传入，或使用 --server-url 指向远程服务端：

npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem ~/Desktop

请务必先阅读服务端自身的 README，因为每个服务端所需的命令和参数各不相同。

启动器参数与客户端参数

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 相关标志）都由客户端定义，而非启动器，并且各客户端定义的集合并不完全相同。配置与标志页面正是按这种方式组织的，即按归属方划分。

NOTE

模式标志仅在命令行开头被识别：第一个不是 --web / --cli / --tui 的 token 会结束启动器的解析，其后的所有内容都会原样转发给客户端。正因如此，字面量 --cli 才能出现在后面作为服务端自身的参数之一：

mcp-inspector --cli node server.js --cli   # mode is CLI; the trailing --cli goes to server.js

NOTE

--help 在有模式标志和无模式标志时行为不同。单独执行 mcp-inspector --help 会打印启动器的帮助并退出。带有模式标志时它会被转发，因此 mcp-inspector --cli --help 会改为打印 CLI 的完整标志参考。

下一步

•Web client

A tab-by-tab walkthrough of the graphical inspector.

▸CLI client

Method reference, output formats, exit codes, and CI recipes.

•TUI client

Terminal navigation and keyboard reference.

≡配置与标志

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

•授权

OAuth 流程的端到端过程、会话中途重新授权，以及回环回调。

•协议时代

传统与现代（2026-07-28）运行方式，以及每个标签页在不同协议时代之间的变化。

▤操作指南

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

•调试指南

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