MCP Inspector

​

开始使用

​

安装和基本用法

npx @modelcontextprotocol/inspector <command>

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

​

检查来自 npm 或 PyPI 的服务器

npx -y @modelcontextprotocol/inspector npx <package-name> <args>
# For example
npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem /Users/username/Desktop

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...

​

功能概览

​

服务器连接面板

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

​

Resources 标签页

• 列出所有可用 resources。
• 显示 resource 元数据（MIME type、description）。
• 支持检查 resource 内容。
• 支持订阅测试。

​

Prompts 标签页

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

​

Tools 标签页

• 列出可用 tools。
• 显示 tool schema 和描述。
• 支持使用自定义输入测试 tool。
• 显示 tool 执行结果。

​

Notifications 面板

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

​

最佳实践

​

开发工作流

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

​

后续步骤