MCP工具调不通？让Claude自带「X光片」查bug——MCP Spy

你有没有遇到过这种情况——Claude 配了 MCP 工具，但它就是不动，或者返回一堆莫名其妙的问题，排查半天不知道哪里卡住了？

最近我发现了一个超好用的 Skill：MCP Spy，专门用来调试 MCP（Model Context Protocol）通信问题，作者是知名 Claude 开发者 johnlindquist。

它能干什么？

简单说，MCP Spy 就是 MCP 通信的「X光片」。装上之后，你可以：

• 实时查看通信日志：MCP 服务端和 Claude 之间发了什么、收了什么，一目了然
• 按类型过滤：只看工具调用、只看错误、只看某个具体工具，全部支持 grep 过滤
• 延迟分析：哪个工具响应最慢？超时了多少？直接定位到毫秒级
• 失败请求诊断：connection refused、timeout、invalid JSON、unknown tool——常见错误都有对应排查步骤
• 协议合规检查：验证请求格式是否正确，不合规的地方直接告诉你哪里有问题

什么场景用得上？

场景一：本地 MCP 服务调不通
Claude 配了文件搜索 MCP，结果报”工具未注册”，完全不知道哪里出错。装上 MCP Spy，tail 日志直接看请求和响应，找到了是端口写错了——30秒解决。

场景二：MCP 工具响应慢
配了 Notion MCP，但每次都要等十几秒才返回，不知道是网络问题还是工具本身慢。MCP Spy 的延迟分析功能一跑，发现是某个特定工具超时了 8 秒。

场景三：接入新 MCP 服务
不知道服务是否正常运行，直接用 MCP Spy 内置的 server status 检查，一行 curl 搞定，不用开 Postman。

怎么安装？

npx skills add https://github.com/johnlindquist/claude --skill mcp-spy SKILL.md

装完之后，Claude 会自动识别 mcp-spy 相关的调试指令，直接说「帮我查一下 MCP 日志」就行。

适合谁用？

说实话，这个 Skill 更适合已经在用 MCP 的开发者，如果你刚接触 MCP，建议先搞清楚 MCP 是什么再装——但一旦你开始用 MCP，这个工具几乎是必装的。

尤其是做 AI Agent 开发的朋友，MCP 是现在最流行的扩展方案，但调试手段一直很原始——MCP Spy 把这件事做得非常专业，日志分析、延迟定位、错误诊断一条龙，排查效率直接翻倍。

GitHub: https://github.com/johnlindquist/claude

GitHub: https://github.com/johnlindquist/claude