在构建 MCP 服务器时,您需要一种方法来测试您的功能,而无需连接到完整的应用程序。Python MCP SDK 包含一个内置的基于浏览器的检查器,让您可以实时调试和测试您的服务器。
启动检查器
首先,确保您的 Python 环境已激活(请查看您项目的 README 以获取确切的命令)。然后使用以下命令运行检查器:
bash
mcp dev mcp_server.py这将启动一个开发服务器,并为您提供一个本地 URL(通常在端口 6277 上),以便在浏览器中访问检查器。

使用检查器界面
MCP 检查器正在积极开发中,因此当您使用它时,界面可能会有所不同。但是,核心功能保持一致。

点击"Connect"启动您的 MCP 服务器后,您将看到一个导航栏,其中包含以下部分:
- Resources
- Prompts
- Tools
- 其他服务器功能
测试您的工具
Tools 部分是您将花费大部分调试时间的地方。点击"List Tools"以查看您的服务器提供的所有工具。

当您选择一个工具时,右侧面板会显示其详细信息,并提供用于测试的输入字段。例如,要测试 read_doc_contents 工具:
- 从列表中选择该工具
- 输入一个文档 ID(如"deposition.md")
- 点击"Run Tool"
- 检查结果是否成功以及输出是否符合预期

测试工具交互
您可以按顺序测试多个工具,以验证它们是否能正确协同工作。例如,在使用 edit_document 工具修改内容之后:

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

开发工作流程
检查器创建了一个高效的开发循环:
- 对您的 MCP 服务器代码进行更改
- 使用各种输入测试单个工具
- 验证工具交互是否按预期工作
- 无需完整的应用程序设置即可调试问题
这种基于浏览器的测试环境对于 MCP 服务器开发至关重要。它通过让您在与 Claude 或其他应用程序集成之前及早发现问题并验证功能,从而节省时间。