<img src="./images/claude-debugs-for-you.png" width="64" height="64" alt="description" align="center"> Claude 调试助手

又称 Vibe 调试

启用 Claude（或其他任何大型语言模型）进行交互式调试

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

这意味着它也应该与其他模型/客户端等一起工作，但这里仅演示了 Claude Desktop 和 Continue 的使用。

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

开始使用

1. 从 发布页面 或 VS Code Marketplace 下载扩展。
2. 安装扩展
   • 如果直接使用 .vsix 文件，请转到 VS Code 中“扩展”部分的三个点，然后选择“从 VSIX 安装...”
3. 您会看到一个新的状态菜单项“Claude 调试助手”，显示其是否正常运行（勾选）或启动失败（叉号）。

<img width="314" alt="2025-03-22 9 51 22 PM" src="https://gips1.baidu.com/it/u=2279487950,1219914363&fm=3081&app=3081&f=PNG?w=628&h=128" />

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

<img width="510" alt="2025-03-22 9 59 22 PM" src="https://gips2.baidu.com/it/u=1817217893,719909824&fm=3081&app=3081&f=PNG?w=1020&h=276" />

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

<details> <summary>如果使用 stdio（经典，Claude Desktop 必需）</summary>

4. 通过搜索 VS Code 命令“复制 MCP 调试服务器 stdio 路径到剪贴板”来复制 stdio 服务器路径到剪贴板。

5. 将以下内容粘贴到您的 claude_desktop_config.json 中（但请更新为已复制的路径！），或者根据您使用的其他 MCP 服务器进行相应编辑

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

6. 启动 Claude Desktop（或其他 MCP 客户端）
   1. 注意：如果已经运行，可能需要重新启动。
   2. 如果使用 Continue/Cursor 或其他内置到 VS Code 的工具，则可以跳过这一步。

</details> <details> <summary>如果使用 `/sse`（例如 Cursor）</summary>

4. 使用“复制 MCP 调试服务器 sse 地址到剪贴板”命令获取 MCP 服务器 sse 地址
   1. 您可以直接写入服务器 URL，如 "http://localhost:4711/sse"，或者根据设置中的端口进行修改。
5. 根据您的客户端需求添加该地址
   1. 您可能需要根据客户端点击“刷新”：Cursor 需要这样做。
6. 启动 MCP 客户端
   1. 注意：如果已经运行，可能需要重新启动。
   2. 如果使用 Continue/Cursor 或其他内置到 VS Code 的工具，则可以跳过这一步。

</details>

您现在可以开始调试！

VS Code 调试文档

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

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

贡献

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

觉得这份文档不够好？请帮助我改进它！

演示

使用 Continue

它会找出问题所在，并提出修复建议，我们只需点击应用即可。

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

<details> <summary>如何与 Continue 设置？/ 显示 MCP 配置</summary>

阅读文档！

配置：

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

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

当工具列表弹出时，确保在工具列表中点击“调试”，并将其设置为“自动”。

故障排除

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

</details>

如果对您有帮助，这是我的配置！但它几乎与 Claude Desktop 相同。

使用 Claude Desktop

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

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

输入提示：

我在构建 `longest_substring_with_k_distinct`，但不知何故它并没有完全正确地工作。你能一步一步地使用断点和评估表达式来找出哪里出了问题吗？确保使用调试工具来访问和调试！不要提前猜测问题所在。DEBUG!

其他值得注意的事情

当您启动多个 VS Code 窗口时，您会看到一个弹出窗口。您可以优雅地在窗口之间传递“Claude 调试助手”。

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

<img width="395" alt="2025-03-22 10 08 52 PM" src="https://gips3.baidu.com/it/u=2930509915,376284145&fm=3081&app=3081&f=PNG?w=790&h=298" />

短名单想法

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