local-only server

The server can only run on the client’s local machine because it depends on local resources.

克劳德为您调试

又名 Vibe 调试

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

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

这意味着它也应该与其他模型/客户端等一起工作，但我只用 Claude Desktop 来演示它并在这里继续。

它与语言无关，假设调试器控制台支持和有效的 launch.json 以便在 VSCode 中进行调试。

入门

从发行版或VS Code Marketplace下载扩展
安装扩展

如果直接使用.vsix ，请转到 VS Code 中“扩展”中的三个点，然后选择“从 VSIX 安装...”

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

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

根据您的设置，请遵循以下选项之一

通过在 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 内置功能，则可以跳过此步骤
使用“将 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}调试特定文件。

请参阅下面的运行示例，和/或观看演示视频。

贡献

发现 Bug 或有改进建议？请提交拉取请求或提交问题。

这个 readme 太烂了吗？帮我改进一下吧！

演示

使用“继续”

它会找出问题所在，然后提出解决方案，我们只需单击即可应用

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"
          ]
        }
      }
    ]
  }
}

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

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

故障排除

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

如果有帮助的话，我的配置是这样的！不过它和 Claude Desktop 几乎一模一样。

使用 Claude Desktop

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

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

发展

使用 VS Code 克隆/打开此 repo
运行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 来查找您要求的内容，而不是列出文件 + 获取文件内容。
[x] 添加对条件断点的支持
[ ] 添加“修复”工具，允许 MCP 插入 CodeLens 或“自动修复”建议，以便用户可以选择是否应用建议的更改。
您的想法在这里！

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

使 Claude（或任何其他 LLM）能够以交互方式调试您的代码（设置断点并评估堆栈框架中的表达式）。