Claude Debugs For You

aka Vibe Debugging

启用 Claude（或其他任何 LLM）以交互式方式调试您的代码

这是一个 MCP 服务器和 VS Code 扩展，它使 claude 能够交互式地调试和评估表达式。

这意味着它也应该适用于其他模型 / 客户端等，但我只使用 Claude 桌面版和 Continue 来演示。

它是语言无关的，假设调试控制台支持并在 VSCode 中调试有效的 launch.json。

入门指南

从 releases 或 VS Code Marketplace 下载扩展
安装扩展

如果直接使用 .vsix，请前往 VS Code 中“扩展”的三个点，并选择“从 VSIX 安装...”

您将看到一个新的状态菜单项“Claude Debugs For You”，它会显示它是否正常运行（对勾）或启动失败（叉号）

您可以点击此状态菜单查看可用命令

根据您的设置选择以下选项之一

如果使用 stdio（经典，Claude 桌面版所需）

通过搜索 VS Code 命令“将 MCP 调试服务器 stdio 路径复制到剪贴板”将 stdio 服务器路径复制到您的剪贴板
将以下内容（但请将路径更新为复制的内容！）粘贴到您的 claude_desktop_config.json 中，或者如果您使用其他 MCP 服务器，请相应地编辑

{
  "mcpServers": {
    "debug": {
      "command": "node",
      "args": [
        "/path/to/mcp-debug.js"
      ]
    }
  }
}

启动 Claude 桌面版（或其他 MCP 客户端）
1. 注意：如果它已经在运行，您可能需要重新启动它。
2. 如果您使用 Continue/Cursor 或 VS Code 的其他内置功能，可以跳过此步骤

如果使用 `/sse`（例如 Cursor）

通过使用“将 MCP 调试服务器 sse 地址复制到剪贴板”命令检索 MCP 服务器 sse 地址
1. 您可以简单地写出服务器 URL，如“http://localhost:4711/sse”，或您在设置中配置的任何其他端口。
根据您的客户端在需要的地方添加它
1. 您可能需要点击“刷新”，具体取决于客户端：在 Cursor 中这是必需的
启动 MCP 客户端
1. 注意：如果它已经在运行，您可能需要重新启动它。
2. 如果您使用 Continue/Cursor 或 VS Code 的其他内置功能，可以跳过此步骤

您已准备好调试！

VS Code 调试文档

打开一个包含 .vscode/launch.json 的项目（其中包含第一个配置设置），使用 ${file} 调试特定文件。

见下方运行示例，和/或观看演示视频。

贡献

发现错误或有改进想法？请打开拉取请求或记录问题。

这个 README 令人失望吗？帮助我改进它！

演示

使用 Continue

它会找出问题，然后建议修复，我们只需点击即可应用

https://github.com/user-attachments/assets/3a0a879d-2db7-4a3f-ab43-796c22a0f1ef

如何使用 Continue 设置此功能？/ 显示 MCP 配置

阅读文档！

配置：

{
  ...
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "node",
          "args": [
            "/Users/jason/Library/Application Support/Code/User/globalStorage/jasonmcghee.claude-debugs-for-you/mcp-debug.js"
          ]
        }
      }
    ]
  }
}

您还需要选择一个能够使用工具的模型。

当工具列表弹出时，请确保在工具列表中点击“debug”，并将其设置为“Automatic”。

故障排除

如果您在 continue 中看到 MCP 错误，请尝试禁用/重新启用 continue 插件

如果有帮助，这是我配置的样子！但它几乎与 Claude 桌面版相同。

使用 Claude 桌面版

在这个示例中，我故意让它非常谨慎（不做任何假设等 - 与下方相同的提示），但您可以要求它做任何事。

https://github.com/user-attachments/assets/ef6085f7-11a2-4eea-bb60-b5a54873b5d5

开发

使用 VS Code 克隆/打开此仓库
运行 npm run install 和 npm run compile
点击“运行”，这将打开一个新的 VSCode
否则与“入门指南”相同适用
要重新构建，npm run compile

打包

vsce package

运行示例

在 VS Code 窗口中打开 examples/python

输入提示：

i am building `longest_substring_with_k_distinct` and for some reason it's not working quite right. can you debug it step by step using breakpoints and evaluating expressions to figure out where it goes wrong? make sure to use the debug tool to get access and debug! don't make any guesses as to the problem up front. DEBUG!

值得提及的其他事项

当您启动多个 VS Code 窗口时，您会看到弹窗。您可以优雅地在窗口之间切换“Claude Debugs For You”。

您还可以禁用自动启动。然后，您只需点击状态菜单并选择“启动服务器”。

简短想法清单

它应该使用 ripgrep 来查找您要求的内容，而不是列出文件 + 获取文件内容。
添加条件断点支持
添加“修复”工具，通过允许 MCP 插入 CodeLens 或“自动修复”建议，以便用户可以选择应用推荐更改或取消。
您的想法在这里！

jasonjmcghee/claude-debugs-for-you

星标增长

证据时间轴