MCP Inspector

用于检查 Model Context Protocol (MCP) 服务器的开发者工具。它作为一个单一包 @modelcontextprotocol/inspector 发布，提供三种检查服务器的方式：

• Web — 一个 Vite + React + Mantine 单页应用，带 Node 后端。
• CLI — 一个可脚本化的命令行客户端，用于自动化、CI 和快速 agent 反馈循环。
• TUI — 使用 Ink 构建的交互式终端 UI。

三者都通过同一个全局 mcp-inspector 二进制运行：

npx @modelcontextprotocol/inspector          # web UI (default)
npx @modelcontextprotocol/inspector --cli    # CLI
npx @modelcontextprotocol/inspector --tui    # TUI

从 v1 升级？ 阅读 v1 → v2 迁移指南 — CLI 标志、新的 --config 与 --catalog 区分、Node 引擎版本提升，以及不再随附的内容。

仓库状态。 这是 Inspector 的 v2 版本线。活跃开发在 v2/main 上进行（开发分支 — 所有 v2 PR 都针对它），在里程碑发布时合并到 main；main 是默认分支，保存最新发布的 v2，发布到 npm latest 标签。旧版 v1 版本线位于 v1/main — 仅安全修复，直接从该分支发布到 npm v1-latest 标签（npx @modelcontextprotocol/inspector@v1-latest）。参见 AGENTS.md 了解分支/看板约定。

项目结构

v2 不是 npm workspace。clients/* 下的每个客户端都有自己的 package.json 和 node_modules；共享代码位于 core/ 中，通过 @inspector/core 构建时别名使用（没有自己的 package.json）。在根目录执行一次 npm install 会级联安装到每个客户端（参见 安装）。

inspector/
├── clients/
│   ├── web/          # Web client (Vite + React + Mantine). src/ = browser app; server/ = Node dev/prod backend
│   ├── cli/          # CLI client (tsup bundle, @inspector/core alias)
│   ├── tui/          # TUI client (Ink + React, tsup bundle)
│   └── launcher/     # Shared launcher — provides the `mcp-inspector` bin, dispatches to web/cli/tui
├── core/             # Shared code consumed via the `@inspector/core` alias (no package.json)
│   ├── auth/         # OAuth: providers, discovery, storage, mid-session recovery (browser/node/remote backends)
│   ├── client/       # Install-level client config (`client.json`): browser-safe parse/validate + Node load/save, remote backend, secrets
│   ├── json/         # JSON + parameter/argument conversion utilities
│   ├── logging/      # Silent pino logger singleton
│   ├── mcp/          # InspectorClient runtime, state stores, transports, config import
│   ├── node/         # Node-only shared helpers: version reader, hostUrl (host normalize/canonicalize + all-interfaces/loopback detection)
│   ├── react/        # React hooks over the state stores
│   └── storage/      # File I/O helpers for the OAuth persist backends
├── test-servers/     # Composable MCP test servers + fixtures used by integration tests
├── scripts/          # Root build/verify tooling (install cascade, smokes, verify-build-gate, verify-format-coverage, verify-dep-lockstep, pack:verify)
├── docs/             # Task-oriented guides (v1→v2 migration, server configuration, MCP App review, launcher/config plan)
├── specification/    # Design/build specifications
├── AGENTS.md         # Contribution rules for agents AND humans (see below)
└── README.md         # You are here

每个客户端都有自己的 README，包含客户端特定的详细信息： web · cli · tui · launcher。

面向任务的指南位于 docs/ 下：

• 从 v1 迁移到 v2 — v1 → v2 映射：CLI 标志映射、--config 与 --catalog 语义及前后示例、Node 引擎版本提升（>=22.7.5 → >=22.19.0）、环境变量重命名，以及不再随附的子包。
• MCP 服务器配置 — Inspector 连接哪些服务器：--catalog 与 --config、临时目标、-- 分隔符、文件格式及其 Inspector 特定的每服务器字段。三个客户端共享；cli 和 tui 的 README 将其服务器选项部分委托给此文档。
• 审查 MCP App — 用于自动化 App 工具审查的 CLI 优先 → 一次性 Web 流程：--app-info 探测 → 深链导航 → 渲染的 widget，以及 OAuth 交接和代理支持。
• 启动器和配置整合 — 为什么启动器在进程内运行客户端而不是派生它，以及共享配置处理器如何融入其中。

安装

需要 Node >=22.19.0。

npm install     # root install; postinstall cascades into every client

• 全新克隆：…