MCP Inspector 是专为 Model Context Protocol(MCP)服务器设计的交互式调试工具,支持开发者通过多种方式快速测试与优化服务端功能。
关键亮点:
• 开箱即用:支持 NPM/PyPi 快速启动,无缝集成本地开发环境。 • 功能全面:资源元数据检查、提示词参数化测试、工具执行结果可视化。 • 实践导向:提供从基础测试到复杂边界条件验证的完整工作流指南。
以下是对 MCP Inspector 的翻译部分
Inspector - 模型上下文协议使用 MCP Inspector 测试和调试模型上下文协议服务器的深度指南
MCP Inspector 是一个用于测试和调试 MCP 服务器的交互式开发者工具。虽然调试指南将 Inspector 作为整体调试工具包的一部分进行介绍,但本文档将详细探讨 Inspector 的功能特性。
快速入门
安装与基础用法
无需安装即可通过 npx 直接运行 Inspector:
npx @modelcontextprotocol/inspector <command>
或带参数运行:
npx @modelcontextprotocol/inspector <command> <arg1> <arg2>
Inspector 使用 NPM 或 PyPi 包启动的方式
NPM 或 PyPi 启动服务器包的常用方式
NPM Package:
npx -y @modelcontextprotocol/inspector npx <package-name> <args>
# For example
npx -y @modelcontextprotocol/inspector npx server-postgres postgres://127.0.0.1/testdbPyPi Package:
npx @modelcontextprotocol/inspector uvx <package-name> <args>
# For example
npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.gitInspector 本地启动 NPM 或 PyPi 的方式
对于本地开发或下载仓库的服务器,最常见的检查方式是:
TypeScript:
npx @modelcontextprotocol/inspector node path/to/server/index.js args...
Python:
npx @modelcontextprotocol/inspector \
uv \
--directory path/to/server \
run \
package-name \
args...请仔细阅读附带的 README 文件以获取最准确的说明。
功能概览
Inspector 提供多个与 MCP 服务器交互的功能:
服务器连接面板
• 允许选择服务器连接传输方式 • 支持为本地服务器自定义命令行参数和环境变量
资源标签页
• 列出所有可用资源 • 显示资源元数据(MIME 类型、描述) • 支持资源内容检查 • 提供订阅测试功能
提示词标签页
• 展示可用提示模板 • 显示提示参数和描述 • 支持使用自定义参数测试提示 • 预览生成的消息内容
工具标签页
• 列出可用工具 • 显示工具模式和描述 • 支持使用自定义输入测试工具 • 展示工具执行结果
通知面板
• 呈现服务器记录的所有日志 • 显示从服务器接收的通知
最佳实践
开发工作流
1. 启动开发
• 使用 Inspector 启动服务器 • 验证基础连接性 • 检查能力协商
2. 迭代测试
• 修改服务器代码 • 重新构建服务器 • 重新连接 Inspector • 测试受影响功能 • 监控消息
3. 测试边界条件
• 无效输入 • 缺失提示参数 • 并发操作 • 验证错误处理和错误响应
