SuperAPI AI 工具集

claude-debugs-for-you

Claude Debugs For You(又称 Vibe Debugging)是一个 MCP 服务器与 VS Code 扩展,让 Claude 或其他 LLM 能够通过断点和表达式求值,以交互方式调试任意语言的代码。它语言无关,前提是调试器控制台支持且 VS Code 中存在有效的 launch.json。用户可通过 VS Code Marketplace 或 .vsix 安装扩展,再将 MCP 服务器路径或 SSE 地址配置到 Claude Desktop、Continue、Cursor 等 MCP 客户端中,即可让模型自动定位问题并建议修复。

访问官网

工具介绍

用途

Claude Debugs For You(又称 Vibe Debugging)旨在让 Claude 或其他 LLM 以交互方式调试代码。它由 MCP 服务器和 VS Code 扩展组成,使模型能够通过断点和表达式求值来定位并修复问题。该工具语言无关,前提是调试器控制台支持,并且 VS Code 中存在用于调试的有效 launch.json。

主要能力

  • 让 Claude(或其他 LLM)交互式调试并求值表达式。
  • 通过 MCP 与 VS Code 扩展协同工作,理论上兼容其他模型和客户端,但官方仅以 Claude Desktop 和 Continue 进行演示。
  • 语言无关,依赖调试器控制台支持与有效的 launch.json。
  • 模型可自行找出问题并建议修复,用户点击即可应用。
  • 需要选择具备工具调用能力的模型;在工具列表中需点击“debug”并将其设为“Automatic”。

使用方式

  1. 从 releases 或 VS Code Marketplace 下载扩展。
  2. 安装扩展。若直接使用 .vsix,可在 VS Code 的“Extensions”中点击三个点并选择“Install from VSIX...”。
  3. 安装后会出现状态菜单项“Claude Debugs For You”,显示运行正常(对勾)或启动失败(叉号)。点击该状态菜单可查看可用命令。
  4. 根据设置选择以下方式之一:
    • 在 VS Code 命令中搜索“Copy MCP Debug Server stdio path to clipboard”复制 stdio 服务器路径,粘贴到 claude_desktop_config.json 中(需更新为实际复制的路径),或按其他 MCP 服务器方式编辑。
    • 启动 Claude Desktop(或其他 MCP 客户端)。注意:若其已在运行,可能需要重启。若使用 Continue/Cursor 或其他内置于 VS Code 的客户端,可跳过此步。
    • 使用“Copy MCP Debug Server sse address to clipboard”命令获取 MCP 服务器 SSE 地址,也可直接写为 http://localhost:4711/sse,或使用设置中配置的端口。
    • 根据客户端要求添加该地址。某些客户端(如 Cursor)可能需要点击“refresh”。
    • 启动 MCP 客户端。注意:若其已在运行,可能需要重启。若使用 Continue/Cursor 或其他内置于 VS Code 的客户端,可跳过此步。
  5. 打开包含 .vscode/launch.json 的项目,且第一个配置已设置为使用 ${file} 调试特定文件。
  6. 可参考“Run an Example”或观看演示视频。

适用场景

  • 在 VS Code 中借助 LLM 对任意语言进行交互式调试。
  • 需要模型自动定位问题并给出修复建议的开发流程。
  • 使用 Claude Desktop、Continue、Cursor 等支持 MCP 的客户端进行调试。

限制与注意事项

  • 语言无关的前提是调试器控制台支持,并且 VS Code 中存在有效的 launch.json。
  • 需要选择具备工具调用能力的模型。
  • 官方仅以 Claude Desktop 和 Continue 进行演示,其他模型/客户端未明确验证。
  • 若在 Continue 中看到 MCP 错误,可尝试禁用/重新启用 Continue 插件。
  • 启动多个 VS Code 窗口时会出现弹窗,可在窗口间优雅移交“Claude Debugs For You”。
  • 可禁用自动启动,之后需点击状态菜单并选择“Start Server”。
  • 项目待办想法包括:使用 ripgrep 查找内容而非列出文件并获取文件内容;支持条件断点;通过允许 MCP 插入 CodeLens 或“auto fix”建议来添加“fix”工具,让用户选择是否应用推荐更改。

从源码运行

  • 使用 VS Code 克隆/打开该仓库。
  • 运行 npm run install 和 npm run compile。
  • 点击“run”会打开一个新的 VS Code。
  • 其余与“Getting Started”相同。
  • 重新构建可运行 npm run compile。
  • 在 VS Code 窗口中打开 examples/python,输入提示词。