使用说明

项目简介

claude-debugs-for-you 是一个 VSCode 扩展，它同时也是一个 MCP 服务器，旨在使 LLM（如 Claude）能够通过交互式调试来帮助开发者调试代码。它作为一个桥梁，连接了 LLM 客户端和 VS Code 的调试功能，允许 LLM 通过 MCP 协议控制 VS Code 调试器，从而实现代码的智能调试。此扩展支持多种编程语言，只要 VS Code 调试器支持并且配置了有效的 'launch.json' 即可。

主要功能点

交互式调试: 允许 LLM 客户端通过发送 MCP 指令，在 VS Code 中设置和移除断点、单步执行、继续运行、评估表达式等，实现对代码的精细调试控制。
文件系统访问: 通过 'listFiles' 和 'getFileContent' 工具，向 LLM 提供工作区的文件列表和文件内容，使 LLM 能够理解代码上下文，并根据文件路径进行调试操作。
工具集成: 内置 'listFiles', 'getFileContent', 'debug' 等工具，这些工具通过 MCP 协议暴露给 LLM 客户端，让 LLM 能够调用这些功能进行代码调试。
灵活的配置: 支持通过 VS Code 设置和客户端配置文件进行端口、传输协议等配置，以适应不同的 MCP 客户端和使用场景。

安装步骤

下载扩展:
- 访问 releases 页面，下载最新版本的 '.vsix' 扩展文件。
- 或者，在 VS Code 扩展商店中搜索 "Claude Debugs For You" 并安装。
安装 VSIX 文件 (如果手动下载):
- 在 VS Code 侧边栏点击 "扩展" 图标 (四个方块)。
- 点击扩展视图右上角的 "..." 菜单，选择 "从 VSIX 安装..."。
- 选择您下载的 '.vsix' 文件并安装。
打开项目:
- 在 VS Code 中打开您要调试的项目。
- 确保项目根目录下存在 '.vscode/launch.json' 文件，并且已经配置了至少一个调试配置。

服务器配置

对于需要 MCP 服务器配置的 LLM 客户端（例如 Claude Desktop），您需要提供 MCP 服务器的启动命令和参数。claude-debugs-for-you 扩展作为一个 VS Code 插件运行，当 VS Code 启动并激活此扩展后，MCP 服务器会自动在后台启动。

在 Claude Desktop 的配置文件（通常是 'claude_desktop_config.json'）中，您需要配置 "debug" 服务器，示例如下：

{
  "mcpServers": {
    "debug": {
      "command": "node",
      "args": [
        "/path/to/mcp-debug.js" // 请替换为启动时弹窗显示的 node 二进制文件路径
      ]
    }
  }
}

重要: '/path/to/mcp-debug.js' 必须替换为 扩展启动后，VS Code 右下角弹出的信息框中显示的 node 二进制文件路径。这个路径是每次启动 VS Code 时动态生成的，请务必复制最新的路径。

如果使用支持 SSE 协议的 MCP 客户端 (如 Cursor)，则可以配置服务器 URL 为 'http://localhost:4711/sse' (默认端口，可在 VS Code 设置中修改)。

基本使用方法

确保 VS Code 中已打开包含需要调试代码的项目。
启动 Claude Desktop 或其他配置好的 MCP 客户端。

在 LLM 客户端中，使用自然语言描述您遇到的代码问题，并指示 LLM 使用 "debug" 工具进行调试。例如：

我的 'longest_substring_with_k_distinct' 函数似乎没有按预期工作，你能使用断点和表达式求值来逐步调试，找出问题所在吗？请使用 debug 工具进行调试！不要预先猜测问题，直接开始 DEBUG!

LLM 客户端会根据您的指令，通过 MCP 协议调用 VS Code 调试器的功能，例如设置断点、启动调试会话、执行代码、获取变量值等，帮助您分析和解决代码问题。

注意: 请确保您的 LLM 客户端已正确配置并连接到 claude-debugs-for-you 扩展提供的 MCP 服务器。

关键词