MCP调试神器来了！让你的MCP集成问题无处遁形

你的 MCP 集成总出问题？试试这个调试神器

Claude Code 接入 MCP 服务器时，你有没有遇到过这些情况：工具调用莫名其妙超时、日志里全是乱码 JSON、连不上也不知道是哪里的问题？

我之前就是硬看日志硬猜，效率极低。直到用了 mcp-spy，才发现原来调试 MCP 可以这么顺。

它能干啥

mcp-spy 是一个专门给 MCP（Model Context Protocol）服务器调试用的 Skill，核心能力有三个：

• 流量分析：查看 Claude 和 MCP 服务器之间的完整通信日志，过滤出工具调用、错误信息
• 延迟分析：定位哪些工具响应慢、为什么慢，精确到毫秒级
• 失败请求分析：解析错误响应，找出连接拒绝、超时、JSON 格式错误等常见问题

实际场景举例

比如你的 MCP 服务器返回了奇怪的结果，不知道是网络问题还是程序问题。用 mcp-spy 的话，只要几行命令就能看到完整的请求/响应内容，还能直接用 jq 格式化 JSON：

grep "tool_use" ~/.claude/debug/mcp-*.log
grep ""error":" ~/.claude/debug/mcp-*.log | jq '.'

再比如某个工具特别慢，直接 time 命令跑一下，响应时间一目了然：

time claude --print "Run beads_ready" --dangerously-skip-permissions

mcp-spy 还内置了一份排障指南，常见的「服务器起不来」「工具找不到」「响应太慢」都有对应检查步骤，比翻文档快多了。

安装超简单

一行命令搞定：

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

装完之后，当你在调试 MCP 集成问题，直接喊 Claude：「用 mcp-spy 分析一下最近的 MCP 通信日志」，它就知道怎么帮你抓重点了。

适合谁用

如果你在用 Claude Code 接入各种 MCP 服务器（数据库工具、Git 工具、API 工具等），或者自己开发 MCP 服务器需要调试，这个 Skill 属于那种「早用早解脱」的工具。建议把它当成 MCP 调试的标准装备。

GitHub 仓库 | stars 25

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