Claude调试助手
启用 Claude（或任何其他大型语言模型）以交互方式调试您的代码（设置断点并在堆栈帧中评估表达式）。 它与语言无关，前提是调试器控制台支持，并且在 VSCode 中进行调试时具有有效的 launch.json。
服务介绍
Claude 为您调试
又名 氛围调试
启用 Claude（或其他任何 LLM）以交互方式调试您的代码
这是一个 MCP 服务器和 VS Code 扩展，它使 Claude 能够以交互方式调试和评估表达式。
这意味着它也应与其他模型/客户端等一起工作，但我仅在此处演示了 Claude Desktop 和 Continue。
它是语言无关的，假设调试器控制台支持并在 VSCode 中有有效的 launch.json 进行调试。
开始使用
- 从 releases 或 VS Code 市场 下载扩展
- 安装扩展
- 如果直接使用
.vsix文件，请转到 VS Code 中的“扩展”下的三个点并选择“从 VSIX 安装...”
- 您将看到一个新的状态菜单项“Claude 为您调试”，它会显示是否正常运行（对勾）或启动失败（叉号）
您可以单击此状态菜单以查看可用命令
根据您的设置选择以下选项之一
-
通过搜索 VS Code 命令“将 MCP Debug Server stdio 路径复制到剪贴板”将 stdio 服务器路径复制到剪贴板
-
将以下内容粘贴到您的
claude_desktop_config.json中（但请更新为复制的路径！），或者如果您使用其他 MCP 服务器，则相应地编辑
{
"mcpServers": {
"debug": {
"command": "node",
"args": [
"/path/to/mcp-debug.js"
]
}
}
}
- 启动 Claude 桌面（或其他 MCP 客户端）
- 注意：如果它已经在运行，您可能需要重新启动。
- 如果您使用的是 Continue/Cursor 或其他内置于 VS Code 的工具，可以跳过此步骤
- 使用“将 MCP Debug Server sse 地址复制到剪贴板”命令检索 MCP 服务器 sse 地址
- 您可以直接写出服务器 URL "http://localhost:4711/sse"，或者您在设置中配置的任何端口。
- 根据您的客户端需求添加它
- 根据客户端的不同，您可能需要点击“刷新”：在 Cursor 中这是必需的
- 启动 MCP 客户端
- 注意：如果它已经在运行，您可能需要重新启动。
- 如果您使用的是 Continue/Cursor 或其他内置于 VS Code 的工具，可以跳过此步骤
您已经准备好进行调试！
打开包含 .vscode/launch.json 的项目，其中第一个配置设置为使用 ${file} 调试特定文件。
参见下面的运行示例，和/或观看演示视频。
贡献
发现错误或有改进的想法？请提交拉取请求或记录问题。
这份 README 很糟糕？帮我改进它！
演示
使用 Continue
它会找出问题，然后建议一个修复方案，我们只需点击即可应用
https://github.com/user-attachments/assets/3a0a879d-2db7-4a3f-ab43-796c22a0f1ef
配置：
{
...
"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”，并将其设置为“自动”。
故障排除
如果你在 continue 中看到 MCP 错误，尝试禁用/重新启用 continue 插件
如果有所帮助，这是我的配置的样子！但它几乎与 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
输入提示：
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 为你调试”。
你还可以禁用自动启动。那么你只需要点击状态菜单并选择“启动服务器”。
简短想法列表
- 它应该使用 ripgrep 来查找你所要求的内容，而不是列出文件+获取文件内容。
- 添加对条件断点的支持
- 通过允许 MCP 插入 CodeLens 或“自动修复”建议来添加“修复”工具，这样用户可以选择是否应用推荐的更改。
- 在这里提出你的想法！
