DebugMCP

官方

让你的 VS Code AI 代理拥有真正的调试器：断点、单步执行、变量检查。

分类: 开发工具第 95 / 438
Stars: ★ 579 非常热门
传输方式: Streamable HTTP
运行环境: 预编译二进制 VS Code 1.104.0+
凭据: 无需凭据
许可证: MIT
最近提交: 7 天前
工具数: 16

62FMRS · C

DebugMCP 是微软维护的 VS Code 扩展兼 MCP 服务器，把真实的调试器能力（断点、单步、变量检查、表达式求值）交给 AI 编码代理，完全本地运行、开箱即用，并支持主流 MCP 客户端与多种语言。它提供 16 个调试工具，并通过仅回环绑定、Host/Origin 校验、最小权限变量读取和凭据脱敏来收敛安全面。适合在 VS Code 中使用 AI 代理做交互式调试的开发者；不适合非 VS Code 环境、需要网络共享调试端点或期望云端托管服务的场景。

最强项 · 文档质量 15/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

13/20

维护活跃度

12/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: 来源仅为 README，未提供服务器清单（[not cached]）、无 package.json/源码、无 CI 工作流或已提交测试。README 列明 16 个工具及参数、超时与端口设置、故障排查（端口占用、断点不命中、多窗口抢焦点），并说明 start_debugging 的 testName 走 VS Code Testing API，happy path 可信。但工具行为、初始化握手、错误处理均无法从证据验证，缺少可复现的测试与可诊断失败路径，按静态校准上限 12 保守给 9。
安全与权限 13/20: README 的 Security model 一节明确四项控制：默认仅绑定 127.0.0.1/::1 回环、Host/Origin 头校验（防 DNS rebinding，返回 403）、get_variables_values 需显式变量名（最多 50、无通配）、变量与表达式结果的敏感信息脱敏（含 <redacted: possible secret>，递归展开上限 100 字段），并披露 bindHost 改绑会暴露未认证调试端点，属数据流与风险的诚实披露，未见恶意代码、外传、硬编码真实令牌或破坏性默认操作。扣分点：端点本身无认证/授权，任何本机进程或浏览器页面（若头校验被绕过）可调用 evaluate_expression、start_debugging 等高权限原语；危险操作无显式确认机制；上述控制均来自 README 自述，无源码或测试佐证。未触及红线，故不落入 0-4。
维护活跃度 12/20: 有明确所有者（微软维护者邮箱与署名）、MIT 许可证、版本号 2.3.5、2.2 变更记录与 issue 引用（#105 已修复）、贡献者 CLA 与行为准则、以及 aka.ms/SECURITY.md 安全上报通道，治理要素基本齐全；498 星与 39 个未关闭 issue 仅作发现信号，不加分。扣分点：仅有 README，无提交历史、发布节奏、依赖更新或依赖清单证据，无法验证维护的持续性与依赖风险；39 个开放 issue 相对规模偏高而响应情况无从核实。综合给 12。
文档质量 15/20: 文档层次完整：安装三种路径（直链/市场/内置搜索）、一键与手动 MCP 注册示例覆盖 Copilot、Copilot CLI、Cursor、Codex、Cline、Windsurf、Roo Code、Antigravity，工具表含每个工具的参数与必填性、扩展设置三项及默认值、支持语言与所需调试扩展、FAQ 与故障排查（含 debug.focusWindowOnBreak 建议）、架构图与运行流程、本地运行与不上传代码的说明。扣分点：无服务器清单可对照，工具返回结构与错误码未给出具体示例，脱敏规则只描述形状未给样例，缺少端到端可复核的调试会话示例输出，部分章节（如各客户端配置）为重复模板而非真实校验结果。给 15。
安装易用性 13/20: 安装路径清晰且步骤少：从 VS Code 市场安装后扩展自动激活并注册 MCP 服务器，默认 http://localhost:3001/mcp，并提供各主流客户端的可复制配置片段（Codex 还给出 codex mcp add 命令）与手动注册兜底，支持 Remote SSH/Codespaces/WSL（extensionKind: workspace），无需 launch.json。扣分点：依赖本地 VS Code 及每门语言的调试扩展（Python、Java、C/C++、Go、Rust、PHP、Ruby 及其 debug gem 等），跨客户端仍需手动粘贴配置；端口冲突需同时改扩展设置与客户端配置；自动注册的实际成功率无法从文件验证。无 CI/测试等执行证据，按校准上限 15 以下取 13。

静态评测 · 未实际运行收录于 2026-09-18

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件执行命令或代码

适合谁

在 VS Code 中使用 AI 编码代理并希望其具备真实调试能力的开发者
需要自动化根因分析而非仅阅读日志的调试场景
使用 VS Code Remote SSH / Codespaces / WSL 等远程环境的用户
需要覆盖多种编程语言的统一调试工具的团队

不适合谁

不使用 VS Code 或任何兼容 MCP 的 AI 助手的用户
需要将调试服务暴露给网络中其他机器的场景（默认仅回环绑定，修改绑定会带来未认证风险）
不安装对应语言 VS Code 调试扩展就想调试该语言的用户
期望外部托管或云端调试服务的用户（本扩展仅本地运行）

所需权限

在本地回环地址（127.0.0.1 与 ::1）上监听 HTTP 端口，默认 3001（可通过 debugmcp.serverPort 修改）
读取被调试源代码文件及项目中的 .vscode/launch.json 配置
调用 VS Code 调试 API 启动/停止调试会话、设置断点、单步执行
读取调试上下文中的变量值并求值表达式（含凭据脱敏）
在标准 skills 目录（~/.agents/skills/，若存在则 ~/.copilot/skills/）安装 debug-live 技能文件

风险与副作用

MCP 端点默认无认证，任何能访问该回环端口的本地进程都可能调用强大的调试原语，例如 evaluate_expression
若将 debugmcp.bindHost 改为 0.0.0.0 或局域网地址，未认证的调试器将暴露给能路由到该地址的任何主机
通过调试器求值表达式可能产生副作用（取决于被调试程序），代理的自动批准会减少人工确认环节
变量脱敏基于名称与凭据形态匹配，可能存在漏报；Null 类值刻意不脱敏，极端情况下仍可能泄露敏感信息
扩展会自动修改 AI 助手的 MCP 注册配置（尽管是提示式）

安装接入

准备工作

运行环境：预编译二进制 VS Code 1.104.0+

在 VS Code 中安装 DebugMCP 扩展：可通过 VS Code Marketplace 搜索 "DebugMCP"，或使用直链 vscode:extension/ozzafar.debugmcpextension，或在扩展面板中安装。
安装后扩展会自动激活并在本地端口 3001 上启动 MCP 服务器。
扩展会弹窗提示自动注册到你的 AI 助手；也可通过命令面板运行 "DebugMCP: Show Agent Selection Popup" 手动触发。
若需手动配置，在 AI 助手的 MCP 设置中添加 Streamable HTTP 服务器，URL 为 http://localhost:3001/mcp（不同客户端的配置格式见 README）。
建议为所有 debugmcp 工具启用自动批准以获得流畅的调试工作流。
确保已安装目标语言的 VS Code 调试扩展（如 Python 扩展、C# 扩展等）。

cline_mcp_settings.json

{
  "mcpServers": {
    "debugmcp": {
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp",
      "description": "DebugMCP - Debugging tools for AI assistants"
    }
  }
}

以 Cline 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "debugmcp": {
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp",
      "description": "DebugMCP - Debugging tools for AI assistants"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http debugmcp http://localhost:3001/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装扩展后确认 MCP 服务器在端口 3001 运行，客户端工具列表中应出现 start_debugging 等工具；可让助手在某个文件上添加断点并启动调试来验证连接。

常见排障

AI 助手无法连接：检查端口 3001 是否被占用，可改用其他端口并同步更新客户端配置；重启 VS Code 并确认扩展已激活
断点不生效：确认调试的文件正确、行号正确，并已安装对应语言的 VS Code 调试扩展
多个 VS Code 窗口时被调试窗口抢焦点：在设置中关闭 debug.focusWindowOnBreak 与 debug.focusEditorOnBreak
扩展未提示注册：从命令面板运行 "DebugMCP: Show Agent Selection Popup"，或按 README 手动添加 MCP 配置
从旧版 SSE 迁移：扩展会在激活时自动将配置迁移为 Streamable HTTP 传输

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在 src/app.py 的第 42 行加一个断点，然后开始调试这个文件
单步进入当前函数，并列出局部变量名
计算表达式 user.session.token 的值
调试一下 test_login 这个测试方法，看看哪里出了问题

工具能力 16

start_debugging 写入

为某个源代码文件启动调试会话（可指定工作目录、测试名、配置名）

stop_debugging 写入

停止当前调试会话

step_over 写入

执行下一行代码（跳过函数调用）

step_into 写入

步入函数调用内部

step_out 写入

从当前函数中步出

continue_execution 写入

继续执行直到下一个断点

pause_execution 写入

中断自由运行的程序并停在当前位置（无需断点）

restart_debugging 写入

重启当前调试会话

展开其余 8 个工具

add_breakpoint 写入

在指定行添加断点（可选条件断点）

add_logpoint 写入

添加日志点：执行到该行时输出日志消息而不暂停（支持 {expr} 插值）

remove_breakpoint 破坏性

移除指定行的断点

clear_all_breakpoints 破坏性

一次性清除所有断点

list_breakpoints 只读

列出所有活动断点

list_variable_names 只读

列出当前作用域中变量的名称和类型，不读取值

get_variables_values 只读

获取当前执行点指定名称变量的值（最多 50 个，不支持通配符）

evaluate_expression 只读

在调试上下文中求值表达式；可展开的子项仅列出名称和类型

使用场景

让 AI 代理自动设置断点并单步执行以定位运行时缺陷

在不加日志的情况下检查运行时变量值和表达式

调试单元测试：通过 testName 参数在具体测试用例中命中断点

调试自由运行的程序（如忙循环、嵌入式目标）时暂停并检查状态

多语言项目中的交互式调试（Python、JS/TS、Java、C/C++、Go、Rust、PHP、Ruby、C#/.NET）

支持客户端

GitHub Copilot

GitHub Copilot CLI

Cline

Cursor

Codex

Windsurf

Roo Code

Antigravity

依据项目文档列出，未经本站实测。

详细介绍

DebugMCP 是微软维护的 VS Code 扩展，同时作为 MCP 服务器运行，让 AI 编码代理直接控制 VS Code 调试器。代理可以自主设置断点、启动调试会话、逐行单步执行、查看变量值并求值表达式，就像人类开发者一样。它完全在本地运行，默认无需额外配置，支持任何兼容 MCP 的 AI 助手，并支持 VS Code 所支持的各类编程语言（Python、JavaScript/TypeScript、Java、C/C++、Go、Rust、PHP、Ruby、C#/.NET）。服务器通过 Streamable HTTP 在本地回环地址上监听（默认端口 3001），自动检测并提示注册到 GitHub Copilot、GitHub Copilot CLI、Cline、Cursor、Codex、Windsurf、Roo Code、Antigravity 等客户端，也可手动配置。安全方面采用仅回环绑定、Host/Origin 头校验、最小权限变量检查以及凭据脱敏，全部调试数据不出本机。调试流程指导由配套的 debug-live Agent Skill 提供，会被安装到标准 skills 目录中。