svnscha/mcp-windbg

解决的问题

此项目在 AI 模型与 Windows 调试工具之间架起桥梁，让开发者能使用自然语言进行崩溃转储分析、用户模式远程调试及内核调试。它通过让 LLM 驱动调试器并分析输出，消除了手动执行复杂调试指令的需求。

运作方式

这是一个围绕 cdb.exe 和 kd.exe（WinDbg 的命令行版本）的 Python 封装。它实现了 Model Context Protocol (MCP)，允许 AI 客户端（如 Claude Code、GitHub Copilot 和 Cursor）调用特定工具来开启会话、执行任意调试指令，并通过唯一的 session ID 管理会话。它可通过 stdio 在本地运作，或作为 HTTP 远程服务运作。

适用对象

需要找出崩溃根源、调试驱动程序或分类多个崩溃转储，且不想手动执行每个调试指令的 Windows 开发者与系统工程师。

特色亮点

• 全面的调试支持：支持崩溃转储 (.dmp, .mdmp, .hdmp)、实时用户模式远程调试，以及通过 KDNET、命名管道或串口进行的内核调试。
• CDB/KD 集成：直接驱动 cdb.exe 和 kd.exe 以执行任何有效的 WinDbg/KD 指令。
• 会话管理：支持使用 session ID 同时进行多个独立的会话。
• 弹性的实时会话：使用 CTRL+BREAK 来重新同步超时的会话，避免卡死。
• 隐私控制：包含通过 --filter-script 的文本过滤钩子，可在数据离开机器前遮蔽 PII 或机密信息。
• 灵活部署：可通过 stdio 在本地执行，或作为可流式传输的 HTTP 服务执行。