/ 目录 / 演练场 / claude-debugs-for-you
● 社区 jasonjmcghee ⚡ 即开即用

claude-debugs-for-you

作者 jasonjmcghee · jasonjmcghee/claude-debugs-for-you

让 Claude 接管 VS Code 的调试器 — 设置断点、单步执行、在任何 VS Code 支持的语言中求值表达式。

一个 VS Code 扩展,将活跃的调试会话暴露为 MCP 工具。Claude 可以设置断点、继续/单步执行,以及对你的运行程序求值表达式。与语言无关 — 支持 Python、Node、Go、Rust 以及任何具有 VS Code debug adapter 的语言。

为什么要用

核心特性

实时演示

实际使用效果

claude-debugs-for-you.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-debugs-for-you",
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-debugs-for-you": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "claude-debugs-for-you"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add claude-debugs-for-you -- npx -y claude-debugs-for-you

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: claude-debugs-for-you

让 Claude 驾驭调试器缩小 bug 范围

👤 被非明显 bug 卡住的开发者 ⏱ ~20 min intermediate

何时使用: 你已经读了 20 分钟日志。是时候让 Claude 设置策略性断点并检查变量状态了。

前置条件
  • .vscode/launch.json 中有可运行的配置 — 在第一个配置中使用 ${file},这样 Claude 可以运行你打开的任何文件
  • 已安装 claude-debugs-for-you 扩展 — VS Code Marketplace
步骤
  1. 启动扩展服务器
    启动调试 MCP 服务器。记下它打印的路径,粘贴到 Claude Desktop 配置中。✓ 已复制
    → 扩展状态栏显示运行中
  2. 描述 bug
    我的函数 computeTotal() 在购物车有促销商品时返回 NaN。在开始处设置断点,单步执行,告诉我哪里出问题了。✓ 已复制
    → 断点已设置、程序运行到此、Claude 检查局部变量
  3. 诊断
    根据每一步的值,根本原因是什么?最小的修复是什么?✓ 已复制
    → 根本原因 + 补丁

结果: Claude 通过驾驭调试器找到 bug — 比打日志快。

注意事项
  • launch.json 配置错误,调试器无法启动 — 先在 VS Code 中用 F5 测试;然后再让 Claude 接管
  • Claude 设置太多断点,导致一切都变得很慢 — 告诉它尽可能使用条件断点
搭配使用: git-2

通过表达式求值理解复杂的运行时状态

👤 逆向工程陌生代码的开发者 ⏱ ~15 min intermediate

何时使用: 代码有效但你不知道为什么。在关键行设置断点,要求 Claude 探索状态。

步骤
  1. 暂停
    在第 X 行设置断点,运行测试,暂停时告诉我作用域中有什么。✓ 已复制
    → 作用域转储
  2. 求值
    求值 this.store.getState().users.filter(u => u.active).length。然后显示我 this.config✓ 已复制
    → 求值结果

结果: 无需编写测试代码的实时探索。

注意事项
  • 有副作用的求值会改变状态 — 除非你打算改变,否则坚持只读表达式

组合

与其他 MCP 搭配,撬动十倍杠杆

claude-debugs-for-you + git-2

调试 → 修复 → 提交循环

调试失败的测试,应用你提议的修复,然后用描述问题的消息进行提交。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
set_breakpoint file, line, condition? 调试会话前/期间 free
remove_breakpoint id 在会话之间清理 free
continue 继续;返回下一个暂停信息 free
step_over 单步而不进入函数 free
evaluate expression: str 检查当前暂停点的值 free
get_stack 查看调用链 free

成本与限制

运行它的成本

API 配额
每次调用 Token 数
每次调用较小;如果你探索很多状态,会话期间的总计可能是 10-50k
费用
免费,MIT
提示
先让 Claude 形成假设,然后用目标性的断点验证 — 避免无目的地单步。

安全

权限、密钥、影响范围

凭据存储:
数据出站: 本地调试器;值发送给你的 LLM 提供商
切勿授予: 通过调试会话对生产数据库进行任意 `evaluate`

故障排查

常见错误与修复

扩展无法启动/状态栏中没有'运行中'

打开 VS Code Developer Tools 控制台。通常是端口占用问题 — 在扩展设置中更改端口。

调试器启动失败

先手动测试 F5。确保 launch.json 中的第一个配置使用 ${file}

Claude 说'没有活跃的调试会话'

你需要一个运行的程序。要求 Claude 启动调试,这会触发 VS Code 的默认配置。

替代方案

claude-debugs-for-you 对比其他方案

替代方案何时用它替代权衡
VS Code + Copilot chat with debug context你已经为 Copilot 付费并原生使用 VS Code可脚本化程度较低;绑定到 Copilot 的模型

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills