MCP协议中文网

Appearance

MCP检查器 ​

使用 MCP Inspector 测试和调试 Model Context Protocol 服务器的深入指南

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

一、开始 ​

1、安装和基本使用 ​

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

bash
npx @modelcontextprotocol/inspector <command>

或者

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

2、从 NPM 或 PyPi 检查服务器 ​

从 NPM 或 PyPi 启动服务器包的常用方法。

针npm包 ​
bash
npx -y @modelcontextprotocol/inspector npx <package-name> <args>
# For example
npx -y @modelcontextprotocol/inspector npx server-postgres postgres://127.0.0.1/testdb
针对pypi包 ​
bash
npx @modelcontextprotocol/inspector uvx <package-name> <args>
# For example
npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git

3、检查本地开发的服务器 ​

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

TypeScript命令 ​
bash
npx @modelcontextprotocol/inspector node path/to/server/index.js args...

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

二、功能概述 ​

MCP Inspector 界面

image-20250309185505579

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

1、服务器连接 ​

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

2、资源 ​

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

3、提示 ​

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

4、工具 ​

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

5、通知窗格 ​

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

其他 ​

《模型上下文协议中文网》附注：下面部分新手可先不关注

1、最佳实践 ​

开发工作流程

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

Copyright © 2025-present 雾拓网络