加载中
加载中

在构建 MCP 服务器时,您需要一种无需连接完整应用程序即可测试其功能的方法。Python MCP SDK 内置了一个基于浏览器的检查器,可让您实时调试和测试您的服务器。

启动检查器

首先,确保您的 Python 环境已激活(请查看项目的 README 以获取确切命令)。然后使用以下命令运行检查器:

bash
mcp dev mcp_server.py

这会启动一个开发服务器,并为您提供一个本地 URL(通常在 6277 端口),以便在浏览器中访问检查器。

终端输出:代理服务器正在 6277 端口监听,MCP Inspector 已在 http://127.0.0.1:6274 启动并运行。

使用检查器界面

这里的图片和视频展示的是检查器的第 1 版,但 mcp dev 现在会启动第 2 版,该版本需要 Node.js 22.19 或更高版本。在第 2 版中,您是在服务器卡片上打开开关,而不是点击"Connect";Tools 标签页会直接列出您的工具,而无需点击"List Tools"按钮;"Run Tool"也更名为"Execute Tool"。

连接前的 MCP 检查器,使用标准输入/输出传输方式,显示"Connect"按钮和"Disconnected"状态。

点击"Connect"启动您的 MCP 服务器后,您会看到一个导航栏,其中包含以下部分:

  • Resources
  • Prompts
  • Tools
  • 其他服务器功能

测试您的工具

Tools 部分是您花费大部分调试时间的地方。点击"List Tools"以查看您的服务器提供的所有工具。

点击"List Tools"后的 MCP Inspector Tools 标签页,列出了 read_doc_contents 和 edit_document 及其各自的描述。

当您选择一个工具时,右侧面板会显示其详细信息,并提供用于测试的输入字段。例如,要测试 read_doc_contents 工具:

  1. 从列表中选择该工具
  2. 输入一个文档 ID(例如"deposition.md")
  3. 点击"Run Tool"
  4. 检查结果,确认其是否成功及输出是否符合预期

列出了 read_doc_contents 和 edit_document 工具的 MCP Inspector Tools 标签页,带有 doc_id 字段和 Run Tool 按钮。

测试工具交互

您可以依次测试多个工具,以验证它们能够正确协同工作。例如,在使用 edit_document 工具修改内容之后:

MCP Inspector 的 edit_document 表单,doc_id 为 deposition.md,old_str 为"This",new_str 为"A report",Tool Result:Success。

使用相同的文档 ID 再次运行 read_doc_contents 工具,以确认您的更改已生效:

MCP 检查器:对"deposition.md"运行 read_doc_contents 显示 Tool Result Success,文本以"A report deposition covers"开头。

开发工作流程

检查器创建了一个高效的开发循环:

  • 对您的 MCP 服务器代码进行修改
  • 使用各种输入测试各个工具
  • 验证工具之间的交互是否按预期工作
  • 无需完整应用程序即可调试问题

这种基于浏览器的测试环境对于 MCP 服务器开发至关重要。它能让您及早发现问题,并在与 Claude 或其他应用程序集成之前验证功能,从而节省时间。