GuidesMCP

用 MCP Inspector 调试你的 Server

按官方 Inspector 文档：用 npx 启动 Web/CLI/TUI 三种客户端，列出 tools、调用工具，并连接本地或远程 Server。

基于 Model Context Protocol Docs 整理 · 官方资料 ↗

写完 MCP Server 后，不一定要先接到完整聊天宿主才能验证。MCP Inspector 是官方参考调试工具：同一套二进制提供 Web、CLI、TUI 三种客户端。

若还没有 Server，先做构建你的第一个 MCP Server。这篇假设你已有可启动的 server 命令或远程 URL。

Inspector 提供三种客户端

Web（默认）：浏览器图形界面，信息最全
CLI：可脚本化，适合 CI 与管道
TUI：终端交互界面，不方便开浏览器时用

三者共用同一核心：相同 transport、相同配置文件、相同 OAuth 状态，以及同样的协议时代协商。

启动 Web Inspector

需要 Node 22.19.0 或更新。无需全局安装，直接 npx：

官方 Quickstart

bash

# 启动 Web UI 并连接本地 stdio server
npx @modelcontextprotocol/inspector node path/to/server/index.js

# 或不指定目标，稍后在 UI 里添加 server
npx @modelcontextprotocol/inspector

命令会打印带一次性 session token 的 URL；在浏览器打开即可。若你的 Server 是 Python weather 示例，把启动命令换成实际入口，例如 uv run weather.py。

用 CLI 列工具并调用

官方 CLI 示例

bash

# 列出 tools 后退出
npx @modelcontextprotocol/inspector --cli node path/to/server/index.js --method tools/list

# 调用工具并把 JSON 结果交给 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

远程 HTTP Server 用 --server-url 或直接传 URL，并指定 --transport http。

检查已发布的 Server

官方示例：本地包 / 远程 URL

bash

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

npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git

npx @modelcontextprotocol/inspector --server-url https://api.example.com/mcp --transport http

始终先读目标 Server 自己的 README：启动参数与权限边界各不相同。调试自己的 weather server 时，对照构建你的第一个 MCP Server 的启动方式。

容易踩的坑

Node 版本不够

升级到 Node 22.19.0+；官方 Inspector 以此为下限。

同时传了 --web 与 --cli

模式旗标最多一个；多余会报 Specify at most one of --web, --cli, or --tui。

连不上自己的 Server

先在终端单独跑通 server 命令；确认传给 Inspector 的是完整启动命令，而不是源码路径猜测。

官方资料

Model Context Protocol Docs

MCP Inspector ↗