AgentMatter
EN/中文
提交项目GitHub
MCP 服务器 · 官方实现

MCP Inspector

MCP Inspector 是 Model Context Protocol 官方调试工具，可通过 Web、CLI 和 TUI 三种界面连接 MCP 服务器，检查 Tools、Resources、Prompts、传输、认证和 MCP Apps。

10.8k StarsMITTypeScript今天更新
安装与使用 GitHub
01

项目介绍

MCP Inspector 是排查 MCP 服务器是否正确工作的官方工具。它能用网页、命令行或终端界面查看 Tools、Resources、Prompts、连接状态和协议数据，还能调试 OAuth 与 MCP Apps。对于刚安装 MCP 的普通用户，它最适合用来回答“服务器有没有连上、工具有没有列出来、调用返回了什么”。

02

核心功能

01

可视化检查 MCP 服务器

Web UI 用可视化面板连接服务器并查看 Tools、Resources、Prompts 和协议状态。

02

列出并调用 Tools

CLI 适合自动化、CI 和快速反馈，TUI 适合终端交互。

03

检查 Resources 与 Prompts

支持测试本地 STDIO 以及 Streamable HTTP、SSE 等连接。

04

调试传输、OAuth 与 MCP Apps

提供 MCP Apps、OAuth、分页、结构化输出、任务和日志等协议测试场景。

MCP Inspector 架构图展示 Web、CLI、TUI、Inspector Core 与 MCP Server 的关系
官方架构图说明三种客户端共享连接、状态和协议逻辑，再通过 MCP SDK 连接目标服务器。查看仓库原图
03

安装与连接

确认 Node.js 版本后先用默认 Web UI 在 loopback 地址运行，只连接一个可信 MCP 服务器并完成列出工具的最小验证；不要为方便而关闭认证或公开监听。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请帮我启动 MCP Inspector。项目地址：https://github.com/modelcontextprotocol/inspector。先读取 README.md、docs/mcp-server-configuration.md、LICENSE 和最新 release 说明，确认 Node.js >=22.19.0。使用 `npx @modelcontextprotocol/inspector` 启动默认 Web UI，只绑定本机 loopback，并只连接我指定的可信 MCP 服务器。不要关闭 API token、不要设置 `DANGEROUSLY_OMIT_AUTH`、不要绑定所有网络接口。遇到下载额外软件、执行陌生服务器命令、读取凭据或 OAuth 令牌、额外权限、网络暴露、覆盖文件时先询问我。先列出 Tools，再调用一个无副作用的只读工具验证。
01开始前准备
  • Node.js 22.19.0 或更高
  • 一个准备验证的可信 MCP 服务器配置
  • 浏览器访问本机 loopback 地址
02复制安装命令或配置
npx @modelcontextprotocol/inspector
03按步骤完成安装
  1. 1
    检查环境并启动

    确认 Node.js 版本后运行 `npx @modelcontextprotocol/inspector`。

  2. 2
    连接可信服务器

    选择正确传输方式并填写一个已审查的 MCP 服务器命令或 URL。

  3. 3
    列出并测试工具

    先列出 Tools，再调用一个无副作用的只读工具并检查响应。

如何确认安装成功

运行 `npx @modelcontextprotocol/inspector`，连接一个可信 MCP 服务器，确认连接成功并能列出 Tools；调用一个无副作用的只读工具并看到预期响应后完成验证。

使用前注意
  • 保持 loopback 与默认认证
  • 只连接可信服务器配置
MCP Inspector README 展示 Web、CLI 和 TUI 三种启动命令
同一个 npm 包提供默认 Web UI、可脚本化 CLI 与终端 TUI 三种检查方式。查看仓库原图
04

使用场景

SCENARIO 01

安装验收

确认新 MCP 服务器能够连接并列出工具。

SCENARIO 02

协议调试

查看 Tools、Resources、Prompts、日志和结构化输出是否符合预期。

SCENARIO 03

MCP Apps 与 OAuth 检查

验证 UI 资源、授权流程和不同传输模式。

05

使用评价

MCP Inspector 的官方身份、三种客户端和较完整的协议覆盖，使它成为安装与开发 MCP 时非常实用的验收工具。它的主要风险来自 Web 后端可以启动进程、保存状态和处理凭据，因此必须保持 loopback、认证和可信配置。本评价来自 README、架构图、配置文档、release 与 LICENSE，未实际启动。

值得一试的地方

  • Model Context Protocol 官方工具
  • Web、CLI 与 TUI 覆盖不同场景
  • README 对网络暴露和认证风险说明具体

使用前要知道

  • 需要较新的 Node.js
  • 不适合无保护的网络公开运行
  • 本次未启动和连接真实服务器
06

README

MCP Inspector

Overview

MCP Inspector 是 Model Context Protocol 官方调试工具，可通过 Web、CLI 和 TUI 三种界面连接 MCP 服务器，检查 Tools、Resources、Prompts、传输、认证和 MCP Apps。 Visual testing tool for MCP servers

Getting started

  • 确认 Node.js 版本后先用默认 Web UI 在 loopback 地址运行，只连接一个可信 MCP 服务器并完成列出工具的最小验证；不要为方便而关闭认证或公开监听。
  • Inspector 2.x 以一个 `@modelcontextprotocol/inspector` 包提供 Web、CLI 与 TUI。
  • 常用启动命令分别是 `npx @modelcontextprotocol/inspector`、`--cli` 和 `--tui`。
  • 运行 `npx @modelcontextprotocol/inspector`，连接一个可信 MCP 服务器，确认连接成功并能列出 Tools；调用一个无副作用的只读工具并看到预期响应后完成验证。

Configuration

npx @modelcontextprotocol/inspector
在 GitHub 阅读完整 README →