---

MCP Inspector 使用指南

简介

MCP Inspector 是 MCP（Model Context Protocol）官方提供的可视化调试工具，用于测试和调试 MCP 服务器。它提供了图形化界面，让你可以轻松地连接 MCP 服务器、查看和调用工具、检查资源等。

快速开始

1. 安装 Node.js

MCP Inspector 需要 Node.js 环境。如果电脑上还没有安装：

1. 访问 Node.js 官网
2. 下载 LTS 版本（长期支持版）
3. 按默认选项完成安装
4. 重启电脑（使环境变量生效）

验证安装是否成功：

打开 命令提示符 (cmd) 或 PowerShell，输入：

node --version

如果显示版本号（如 v20.x.x），说明安装成功。

2. 启动 MCP Inspector

最简单的方式：使用 npx 一键启动（推荐）

npx @modelcontextprotocol/inspector

说明：npx 会自动下载并运行最新版 Inspector，无需手动安装。首次运行会稍慢（需下载），后续启动很快。

可选方式：全局安装后启动

# 全局安装（只需执行一次）
npm install -g @modelcontextprotocol/inspector

# 之后直接运行
mcp-inspector

3. 验证启动成功

启动后，终端会显示类似信息：

Starting MCP inspector...
Inspector is running at http://localhost:6274

浏览器会自动打开 http://localhost:6274，看到 Inspector 界面即表示成功。

连接 MCP 服务器

场景一：连接本地 STDIO 服务器（如 Python/Node.js 脚本）

配置项	操作
Transport Type	选择 STDIO
Command	填写启动命令（如 python 或 node）
Arguments	填写脚本路径或模块名（如 server.py 或 build/index.js）
Environment Variables	按需添加环境变量

点击 Connect 即可。

场景二：连接远程服务器（HTTP/SSE）

配置项	操作
Transport Type	选择 Streamable HTTP 或 SSE
URL	填写服务器地址（如 http://localhost:9002/mcp）
Authentication / Headers	按需填写认证信息（见下方说明）

点击 Connect 即可。

场景三：需要自定义 Header 认证

如果对方提供了类似这样的调用命令：

curl -H "X-API-Key: your-token" http://server/mcp

在 Inspector 中：

1. 找到 Custom Headers 区域
2. 点击 + Add 添加一行
3. Header Name：填写 X-API-Key
4. Header Value：填写 your-token
5. 确保右侧开关是 开启 状态（蓝色）

使用 Inspector 测试

连接成功后，Inspector 界面分为左右两区：

左侧：服务器信息

• Tools：服务器提供的所有工具，点击可查看参数并调用
• Resources：服务器提供的资源
• Prompts：服务器提供的提示模板

右侧：操作区

• 选择工具后，填写参数（JSON 格式）
• 点击 Run 执行调用
• 查看返回结果

常见问题

Q1：端口被占用怎么办？

手动指定其他端口：

# Windows (cmd)
set CLIENT_PORT=8080 && set SERVER_PORT=9000 && npx @modelcontextprotocol/inspector

# PowerShell
$env:CLIENT_PORT=8080; $env:SERVER_PORT=9000; npx @modelcontextprotocol/inspector

Q2：连接失败怎么办？

按顺序检查：

1. 服务器是否在运行？确认 MCP 服务器已启动
2. 网络是否可达？远程服务需要确保网络连通
3. URL 是否正确？检查地址和端口
4. 认证信息是否正确？确认 Token/Key 无误
5. Header 开关是否开启？Custom Headers 的开关需要是蓝色状态

Q3：如何调试 Python 写的 MCP 服务器？

1. 启动 Inspector，Transport Type 选择 STDIO
2. Command 填 python，Arguments 填脚本路径
3. 在 Python 代码中使用 print() 输出调试信息（会显示在终端）

Q4：Inspector 安全吗？

官方 Inspector 仅用于本地开发调试，请勿将其暴露到公网。

相关资源

• MCP 官方文档
• MCP Inspector GitHub

快速参考卡片

场景	命令/操作
一键启动	npx @modelcontextprotocol/inspector
全局安装	npm install -g @modelcontextprotocol/inspector
连接本地 Python 服务	Command: python | Arguments: server.py
连接远程 HTTP 服务	Transport: Streamable HTTP | URL: 服务器地址
添加自定义 Header	Custom Headers → +Add → 填写名称和值

---