MCP Win Debugger

mcp-win调试器

一个MCP服务器，通过CDB（控制台调试器）为AI代理提供本机Windows调试能力。

问题

本机代码的默认调试循环非常缓慢：

add print statement → recompile → relaunch → reproduce bug → close app → read logs → repeat

每次迭代需要几分钟。对于大型C++项目，一次重新编译可能需要10多分钟。

解决方案

此MCP服务器允许AI代理 直接调试您的流程 --设置断点、检查内存、读取变量、遍历代码，甚至在运行时修改状态。无需重新编译。

attach to process → set breakpoint → inspect callstack → read locals → follow pointers → find bug

每次操作都需要 毫秒。代理程序会像在Visual Studio中一样导航程序的实时状态，但由AI驱动，AI可以将源代码与它在内存中看到的内容进行交叉引用。

示例：代理发现一个Off By One Bug

考虑一下这段带有微妙错误的C代码-- get_last_player 回报 &players[count] 而不是 &players[count-1]:

typedef struct {
    Player* players;
    int count;
    int capacity;
} GameState;

// BUG: off-by-one — accesses players[count] instead of players[count-1]
Player* get_last_player(GameState* game) {
    return &game->players[game->count];  // should be count - 1
}

void apply_poison(GameState* game) {
    Player* last = get_last_player(game);  // reads garbage when count == 0
    damage_player(last, 5);
}

代理启动程序，设置断点，并调查：

在约1秒的调试时间内找到根本原因。 无打印声明。无需重新编译。代理读取源代码，设置目标断点，并跟踪数据直到出现错误——与Visual Studio中的方式相同，但不需要手动单击。

快速开始

先决条件

• 视窗 和 Windows SDK调试工具 已安装（提供 cdb.exe)
• Python 3.12+

没有第三方依赖关系——服务器只使用Python标准库。

安装

git clone https://github.com/RandyGaul/mcp-win-debugger.git

配置Claude代码

添加到您的项目 .mcp.json （如果它不存在，请在项目根目录中创建它）：

{
  "mcpServers": {
    "windbg": {
      "command": "python",
      "args": ["C:/path/to/mcp-win-debugger/src/server.py"]
    }
  }
}

替换 C:/path/to/mcp-win-debugger 使用克隆仓库的实际路径。

用法

告诉Claude调试你的程序：

“发射 D:/build/myapp.exe 符号来自 D:/build/ 并调查玩家健康状况变差的原因”

代理人将：

1. 在调试器下启动可执行文件
2. 仅加载您的符号（快速-跳过所有依赖PDB）
3. 在相关函数上设置断点
4. 运行程序，检查断点处的状态
5. 跟随指针链，读取结构体，检查数组边界
6. 找出根本原因

工具（39）

会话管理

执行控制

断点

检查

修改

导航

符号

分析

逃生舱口

指导工作流程（MCP提示）

该服务器包括三个代理可以遵循的指导工作流：

• live_debug --对实时流程的逐步调查
• crash_triage --系统性碰撞倾倒分析
• memory_corruption --使用数据断点查找内存损坏

演出

服务器针对速度进行了优化：

• 默认情况下没有符号 --空的 -y "" 防止符号服务器查找缓慢
• -snul --禁用不合格符号加载（大型项目的大幅加速）
• .symopt+0x100 — SYMOPT_NO_UNQUALIFIED_LOADS 运行时
• 抑制异常噪声 — sxd *; sxe av; sxi eh; sxi ch （仅访问违规中断）
• 选择性符号加载 — load_symbols_for('mymodule') 加载一个PDB，而不是全部

建筑测试夹具

cd tests/fixtures
cmake -B build
cmake --build build

运行测试

pytest tests/ -v

每个模块的测试共享一个CDB会话以提高速度（总共约2.5分钟）。

建筑

Claude Code ←→ MCP (stdio/JSON-RPC) ←→ Python server ←→ cdb.exe (subprocess)
                                              ↕
                                     background reader thread
                                     (readline from stdout pipe)
                                              ↕
                                     echo marker detection
                                     (deterministic command completion)

服务器管理 cdb.exe 作为具有以下功能的子流程：

• 背景阅读器线程 --逐行读取stdout（避免Windows管道缓冲死锁）
• 回声标记协议 --发送 .echo __MARKER__ 在每次命令后进行可靠的完成检测
• 铝土矿清理 --在服务器退出时杀死孤立的cdb进程

许可证

这是免费且无阻碍的软件，已发布到公共领域。 看 未授权 了解详情。