kerlenton/mcpsnoop

解决的问题

mcpsnoop 是 "MCP 版 Wireshark"，提供一种透明的方式，用于监控和调试 AI 客户端（如 Cursor 或 Claude Code）与 Model Context Protocol (MCP) 服务器之间的通信。与其他作为独立客户端运行的检查工具不同，mcpsnoop 直接位于数据路径中，使开发者能够准确看到真实客户端发送的内容以及服务器的响应，包括识别模型未能调用的请求或参数错误的调用。

工作原理

它作为一个透明的代理运行，包装 MCP 服务器命令。它在客户端和服务器之间原样转发字节，同时将每个 JSON-RPC 帧复制到一个中心枢纽。该枢纽随后提供一个实时终端用户界面（TUI）用于实时监控。它支持基于 stdio 的服务器和可流式传输的 HTTP 服务器（作为反向代理），并可将数据导出为 OpenTelemetry 段，以实现结构化可观测性。

适用人群

需要查看实际网络层通信以排查工具调用、延迟和协议错误的 MCP 服务器或 AI 代理开发者。

主要亮点

• 透明监控：直接部署在真实数据路径中，无需修改客户端或服务器代码。
• CI/CD 集成：包含 GitHub Action，可根据错误、无效帧或延迟预算失败来中断构建。
• 可观测性：支持导出至 OpenTelemetry，并提供实时 Prometheus 指标以监控工具性能。
• 灵活部署：支持 stdio 和 HTTP 服务器，提供辅助命令以轻松包装/解包 Claude Desktop 配置。
• 会话管理：支持模拟捕获的会话、对比两个会话、回顾历史日志以进行事后分析。