在构建 MCP 服务器时,您需要一种无需连接完整应用程序即可测试功能的方法。Python MCP SDK 内置了一个基于浏览器的检查器,让您能够实时调试和测试您的服务器。
启动检查器
首先,确保您的 Python 环境已激活(查看您项目的 README 了解确切命令)。然后使用以下命令运行检查器:
mcp dev mcp_server.py这会启动一个开发服务器,并为您提供一个本地 URL(通常在 6277 端口),供您在浏览器中访问检查器。
使用检查器界面
这里的图片和视频展示的是检查器的第 1 版,但 mcp dev 现在启动的是第 2 版,它需要 Node.js 22.19 或更高版本。在第 2 版中,您需要打开服务器卡片上的开关,而不是点击"Connect";Tools 标签页会列出您的工具而不需要"List Tools"按钮;并且"Run Tool"被称为"Execute Tool"。

当您首次打开检查器时,会在左侧看到一个"Connect"按钮。点击它即可启动您的 MCP 服务器并加载您的工具。
测试您的工具
连接后,查找包含 Resources、Prompts 和 Tools 等部分的导航栏。点击 Tools 部分以查看您可用的工具。
点击"List Tools"以查看服务器提供的所有工具。当您选择某个特定工具时,右侧面板会更新,显示一个表单,供您测试该工具。
运行工具测试
例如,要测试一个文档读取工具:
- 选择
read_doc_contents工具 - 输入文档 ID(例如"deposition.md")
- 点击"Run Tool"
检查器将执行您的工具并显示结果,包括成功状态以及任何返回的数据。

测试文档编辑
您还可以测试更复杂的工具,比如文档编辑:
- 切换到
edit_document工具 - 填写文档 ID、要替换的旧文本以及新文本
- 运行工具,查看是否成功
- 再次使用读取工具以验证更改是否已应用

开发工作流程
检查器在左侧显示您工具调用的历史记录,让您轻松追踪已测试的内容,并重复之前的操作。这创建了一个高效的开发循环,您可以在其中:
- 对服务器代码进行更改
- 重启检查器
- 立即测试您的工具
- 验证结果
随着您构建越来越复杂的 MCP 服务器,这个检查器工具会变得至关重要。它消除了为了测试基本功能而将服务器接入完整应用程序的需要,使开发变得更快、更可靠。