MCP 检查器
一句话
MCP 检查器是一个交互式开发者工具，用于测试和调试 MCP 服务器。
什么时候翻这页
当你需要测试、调试 MCP 服务器，验证其功能、资源、提示和工具时，可以查阅本页。
核心概念
- 服务器连接面板：选择连接服务器的 transport，自定义本地服务器的命令行参数和环境
- 资源选项卡：列出所有可用资源，显示资源元数据（MIME 类型、描述），支持资源内容检查和订阅测试
- 提示选项卡：显示可用提示模板，展示提示参数和描述，支持自定义参数测试和生成消息预览
- 工具选项卡：列出可用工具，显示工具模式和描述，支持自定义输入测试和执行结果展示
- 通知面板：呈现服务器记录的所有日志和接收到的通知
怎么做
安装和基本使用
检查器通过 npx 直接运行，无需安装：
npx @modelcontextprotocol/inspector <command>
npx @modelcontextprotocol/inspector <command> <arg1> <arg2>
检查 npm 或 PyPI 服务器
检查来自 npm 或 PyPI 的服务器包：
# npm 包
npx -y @modelcontextprotocol/inspector npx <package-name> <args>
# 例如
npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem /Users/username/Desktop
# PyPI 包
npx @modelcontextprotocol/inspector uvx <package-name> <args>
# 例如
npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git
检查本地开发的服务器
检查本地开发或下载为仓库的服务器：
# TypeScript
npx @modelcontextprotocol/inspector node path/to/server/index.js args...
# Python
npx @modelcontextprotocol/inspector \
uv \
--directory path/to/server \
run \
package-name \
args...
开发工作流程
- 开始开发：启动检查器连接服务器，验证基本连接，检查能力协商
- 迭代测试：修改服务器代码，重新构建服务器，重新连接检查器，测试受影响功能，监控消息
- 测试边缘情况：无效输入、缺失提示参数、并发操作，验证错误处理和错误响应
命令 / 配置速查
# 基本命令
npx @modelcontextprotocol/inspector <command>
# 检查 npm 包
npx -y @modelcontextprotocol/inspector npx <package-name> <args>
# 检查 PyPI 包
npx @modelcontextprotocol/inspector uvx <package-name> <args>
# 检查 TypeScript 服务器
npx @modelcontextprotocol/inspector node path/to/server/index.js args...
# 检查 Python 服务器
npx @modelcontextprotocol/inspector uv --directory path/to/server run package-name args...
与 Claude Code / Hello-Agents 的联系
MCP 检查器与 Claude Code 手册中的 MCP 章节和 Hello-Agents 第 10 章形成互补。在 Hello-Agents 中，我们学习了如何构建 MCP 服务器；而 MCP 检查器则提供了验证这些服务器功能的工具，确保它们能正确响应请求、提供资源和执行工具。
初学者易错点
- 忽略服务器的 README 文件，导致使用不正确的命令参数
- 未正确配置本地服务器的命令行参数和环境变量
- 未充分测试边缘情况，如无效输入、缺失参数等
- 在迭代开发过程中忘记重新连接检查器，导致测试的是旧版本服务器