使用Inspector调试MCP服务 - 蝈蝈俊

💡 原文中文,约3800字,阅读约需10分钟。
📝

内容提要

MCP Inspector 是一款专为 Model Context Protocol 服务器设计的交互式调试工具。通过 npx 命令可快速启动,支持临时运行和依赖管理。它提供两种通信机制,帮助开发者调试和优化服务端功能,示例包括运行 Fetch MCP Server,并支持将网页内容转换为 markdown 格式。

🎯

关键要点

  • MCP Inspector 是为 Model Context Protocol 服务器设计的交互式调试工具。

  • 通过 npx 命令可快速启动,无需全局安装。

  • npx 简化开发流程,解决全局包污染和版本冲突问题。

  • @modelcontextprotocol/inspector 是一个作用域包,避免命名冲突。

  • Inspector 运行两个服务:带UI的客户端和 MCP proxy server。

  • MCP proxy server 封装了 stdio 传输机制为 HTTP with SSE 方式。

  • 可以通过不同的方式连接 MCP 服务端,包括传递参数和环境变量。

  • Fetch MCP Server 支持提取网页内容并转换为 markdown 格式。

  • uvx 是 uv 工具链的扩展命令,用于在临时环境中运行工具。

  • 调试过程中可以使用 Chrome 开发者工具查看网络请求和响应。

  • 请求内容包含协议版本、请求ID等信息,需确保每次请求ID不同。

  • 未来协议可能会更新,采用新的 'Streamable HTTP' 传输方式。

➡️

继续阅读