MCP 官方文档中文版
  1. 教程
MCP 官方文档中文版
  • 开始使用
    • 简介
    • 示例 Servers
    • 示例 Clients
    • 快速上手
      • 服务器开发
      • 客户端开发
      • Claude 桌面版开发
  • 教程
    • 使用 LLMs 构建 MCP
    • 调试 Debugging
    • 调试器 Inspector
  • 概念
    • 核心架构
    • 资源 Resources
    • 提示词 Prompts
    • 工具 Tools
    • 采样 Sampling
    • 根 Roots
    • 传输 Transports
  • 开发
    • 新计划
    • 规划
    • 贡献
  1. 教程

调试器 Inspector

以下是使用 MCP 调试器（Inspector）测试和调试模型上下文协议（MCP）服务器的深度指南。
MCP 调试器是一个交互式的开发者工具，用于测试和调试 MCP 服务器。 虽然调试指南 将调试器作为整体调试工具包的一部分进行了介绍，但本文档将详细探讨 Inspector 的特性和功能。

入门#

安装和基本用法#

调试器通过 npx 直接运行，无需安装：

从 NPM 或 PyPi 检查服务器#

一种常见的启动来自 NPM 或 PyPi 的服务器包的方式。
NPM 包
PyPi 包

检查本地开发的服务器#

要检查本地开发或作为存储库下载的服务器，最常见的方式是：
TypeScript
Python
请仔细阅读任何随附的 README 文件，以获取最准确的说明。

功能概述#

img
MCP 调试器界面
调试器提供了多个与 MCP 服务器交互的功能：

服务器连接面板#

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

资源选项卡#

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

提示选项卡#

显示可用的提示模板（prompt template）
显示提示参数和描述
启用带有自定义参数的提示测试
预览生成的消息

工具选项卡#

列出可用的工具（tool）
显示工具模式（schema）和描述
启用带有自定义输入的工具测试
显示工具执行结果

通知面板#

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

最佳实践#

开发工作流程#

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

扫码加入 Apifox MCP 内测群

MCP生态正在快速发展，我们正在与开发者们一起探索 AI 和 API 协作的未来。

扫码加入交流群
上一页
调试 Debugging
下一页
核心架构
Built with