The server inspector

学习笔记：MCP 服务器调试（MCP Inspector）

一、 核心概念

• 目的： 使用 MCP Inspector（一个浏览器内置的调试器）来测试和调试 MCP 服务器的功能，无需将其连接到实际应用程序。
• 工具： 通过 Python SDK 自动获得一个浏览器调试器。

二、 服务器启动流程

• 环境准备： 确保已激活 Python 环境（参考 readme 文件中的启动命令）。
• 运行命令： 在终端运行 mcp dev [服务器文件名]（例如：mcp dev mcpserver. py）。
• 访问地址： 服务器启动后，会提供一个监听端口（例如：6277）和直接访问地址。
• 进入 Inspector： 在浏览器中打开该直接访问地址，即可进入 MCP Inspector。

三、 MCP Inspector 使用指南

• 连接服务器： 点击左侧的 "Connect" 按钮启动 MCP 服务器。
• 定位工具： 在顶部菜单栏中找到并点击 "Tools"（工具）选项。
• 查看工具列表： 点击 "List Tools" 可以查看已创建的所有工具名称。
• 手动调用： 在右侧面板使用工具，进行手动调用和测试。

四、 工具测试与验证流程

• 测试 Read Doc Contents 工具：
• 输入 Document ID → 验证是否返回正确的文档内容。
• 测试 Edit Document 工具：
• 输入 Document ID + 旧字符串 → 输入新字符串 → 运行工具 → 确认操作成功（注意：该工具仅执行编辑，不返回内容）。
• 验证编辑结果：
• 编辑完成后，再次使用 "Read Doc Contents" 工具，用相同的 Document ID 验证文档内容是否已正确更新。

Takeaways

• MCP Inspector 是一个浏览器内置调试器，用于在不连接实际应用程序的情况下测试 MCP 服务器功能。
• 服务器启动需在终端运行命令 mcp dev [服务器文件名]，并通过提供的访问地址进入 Inspector。
• 在 MCP Inspector 中，通过顶部菜单的 "Tools" 选项可以查看和手动调用所有已创建的工具。
• 测试流程包括：使用 Read Doc Contents 工具验证初始内容，然后使用 Edit Document 工具进行修改。
• 验证编辑结果的关键步骤是：修改后再次使用 Read Doc Contents 工具，确认文档内容是否已正确更新。