检查器

MCP Inspector 是一个交互式开发者工具，用于测试和调试 MCP 服务器。虽然调试指南已将 Inspector 作为整体调试工具集的一部分进行了介绍，但本文档将详细探讨 Inspector 的各项功能和特性。

快速开始

安装与基本用法

Inspector 无需安装，可直接通过 npx 运行：

npx @modelcontextprotocol/inspector <command>

npx @modelcontextprotocol/inspector <command> <arg1> <arg2>

检查来自 NPM 或 PyPi 的服务器

一种常见的方式是从 NPM 或 PyPi 启动服务器包。

npx -y @modelcontextprotocol/inspector npx <package-name> <args>
# 例如
npx -y @modelcontextprotocol/inspector npx server-postgres postgres://127.0.0.1/testdb

检查本地开发的服务器

要检查本地开发或作为仓库下载的服务器，最常用的方法是：

npx @modelcontextprotocol/inspector node path/to/server/index.js args...

请仔细阅读附带的 README 文件以获取最准确的说明。

功能概览

Inspector 提供了多种与 MCP 服务器交互的功能：

服务器连接面板

• 允许选择用于连接服务器的传输方式
• 对于本地服务器，支持自定义命令行参数和环境变量

资源选项卡

• 列出所有可用资源
• 显示资源元数据（MIME 类型、描述）
• 允许检查资源内容
• 支持订阅测试

提示选项卡

• 显示可用的提示模板
• 显示提示参数和描述
• 支持使用自定义参数进行提示测试
• 预览生成的消息

工具选项卡

• 列出可用工具
• 显示工具模式（schema）和描述
• 支持使用自定义输入进行工具测试
• 显示工具执行结果

通知面板

• 展示从服务器记录的所有日志
• 显示从服务器接收到的通知

最佳实践

开发工作流

1. 开始开发

   • 使用 Inspector 启动你的服务器
   • 验证基本连接性
   • 检查能力协商

2. 迭代测试

   • 对服务器进行更改
   • 重新构建服务器
   • 重新连接 Inspector
   • 测试受影响的功能
   • 监控消息

3. 测试边缘情况

   • 无效输入
   • 缺失的提示参数
   • 并发操作
   • 验证错误处理和错误响应

后续步骤