The server inspector

MCP 服务器调试与测试笔记

• 目的 (Purpose):
• 使用 MCP 检查器 (MCP Inspector) 在不连接实际应用程序的情况下，对 MCP 服务器进行实时开发和调试。
• 确保服务器功能按预期工作。

• 环境设置与启动 (Setup and Startup):
• 激活环境： 必须先激活 Python 环境（参考 readme 文档中的具体命令）。
• 运行命令： 在终端运行 mcp dev → [服务器文件名] (例如：mcpserver. py)。
• 访问服务器： 服务器启动后，会显示监听的端口（例如：6277）和直接访问地址。在浏览器中打开该地址即可进入 MCP 检查器。

• MCP 检查器使用流程 (Inspector Workflow):
• 连接： 点击左侧的 "Connect" 按钮启动 MCP 服务器。
• 查找工具： 在顶部菜单栏中选择 "Tools" → "List Tools" 来查看已实现的工具列表。
• 手动调用： 选择一个工具后，使用右侧面板手动输入参数（如 Document ID）来调用该工具，进行功能验证。

• 测试与验证 (Testing and Verification):
• 读取工具验证： 使用 read doc contents 工具，输入 Document ID，验证返回的内容是否正确。
• 修改工具验证： 使用 edit document 工具进行修改（注意：修改工具不返回内容，仅执行编辑操作）。
• 状态验证： 修改完成后，再次使用 read doc contents 工具，验证文档内容是否已成功更新。

• 核心优势 (Key Benefit):
• 允许开发者在不进行完整应用集成的情况下，快速、独立地调试和测试 MCP 服务器的各个功能。

Takeaways

• MCP检查器允许开发者在不集成完整应用的情况下，独立地实时调试和测试MCP服务器功能。
• 启动服务器需先激活Python环境，然后在终端运行 mcp dev 命令，并通过浏览器访问监听端口进入检查器。
• 检查器使用流程是：点击 "Connect" → 菜单选择 "Tools" → 手动输入参数调用工具进行功能验证。
• 功能验证的关键步骤是：使用 read doc contents 验证读取，使用 edit document 执行修改，再用 read doc contents 验证更新。