教程

Inspector

深入指南：使用MCP Inspector测试和调试模型上下文协议服务端

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 uvx <package-name> <args>
    # For example
    npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git

检查本地开发的服务端

要检查本地开发或下载为仓库的服务端，最常见的方式是：

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

npx @modelcontextprotocol/inspector \
  uv \
  --directory path/to/server \
  run \
  package-name \
  args...

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

功能概述

MCP Inspector界面

Inspector提供了多种功能来与你的MCP服务端进行交互：

服务端连接面板

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

资源选项卡

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

提示选项卡

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

工具选项卡

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

通知面板

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

最佳实践

开发工作流程

1. 开始开发

   • 启动Inspector与你的服务端
   • 验证基本连接
   • 检查能力协商

2. 迭代测试

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

3. 测试边缘情况

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

下一步