MCP Inspector是一个交互式开发者工具，用于测试和调试MCP服务器。虽然调试指南将Inspector作为整体调试工具包的一部分进行了介绍，但本文档提供了对Inspector功能和能力的详细探索。

​
入门指南

​
安装和基本使用

Inspector可以直接通过npx运行，无需安装： 
npx @modelcontextprotocol/inspector <命令>

npx @modelcontextprotocol/inspector <命令> <参数1> <参数2>

​
检查来自NPM或PyPi的服务器

从NPM或PyPi启动服务器包的常见方式。 
npx -y @modelcontextprotocol/inspector npx <包名> <参数>
# 例如
npx -y @modelcontextprotocol/inspector npx server-postgres postgres://127.0.0.1/testdb

​
检查本地开发的服务器

检查本地开发或作为仓库下载的服务器，最常见的方式是： 
npx @modelcontextprotocol/inspector node path/to/server/index.js args...
请仔细阅读附带的README以获取最准确的说明。

​
功能概述

MCP Inspector界面

Inspector提供了几个与MCP服务器交互的功能：

​
服务器连接面板

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

​
资源标签页

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

​
提示标签页

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

​
工具标签页

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

​
通知面板

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

​
最佳实践

​
开发工作流

  1. 开始开发
    • 使用服务器启动Inspector
    • 验证基本连接
    • 检查能力协商
  2. 迭代测试
    • 进行服务器更改
    • 重新构建服务器
    • 重新连接Inspector
    • 测试受影响的功能
    • 监控消息
  3. 测试边缘情况
    • 无效输入
    • 缺少提示参数
    • 并发操作
    • 验证错误处理和错误响应

​
下一步

Inspector仓库

查看MCP Inspector源代码

调试指南

了解更广泛的调试策略