Repolode
svnscha

svnscha/mcp-windbg

让 AI 助手通过 MCP 驱动 WinDbg(cdb/kd),分析 Windows 崩溃转储并调试用户态与内核目标。

Star
1,660
Fork
168
未关闭 Issue
2
最近提交
10天前

这是什么?

mcp-windbg 是一个基于 Python 的 Model Context Protocol 服务器,封装了 Windows 调试器:用户态转储和远程调试使用 cdb.exe,内核目标使用 kd.exe。兼容 MCP 的客户端可以打开崩溃转储,获取 !analyze -v、调用栈、模块和线程等自动分析结果,并继续执行调试命令来辅助判断。

除转储分析外,服务器还能通过 TCP、命名管道或 COM 连接正在运行的用户态调试服务,也能通过 KDNET、命名管道或串口连接内核目标。多个会话可同时打开,并通过会话 ID 分别操作。每次调用都可设置超时,超时的实时命令会通过 CTRL+BREAK 中断并重新同步会话。

服务器支持通过 stdio 本地运行,也可以作为 streamable-HTTP 服务,供其他机器远程驱动调试主机。过滤脚本可在工具参数和输出离开本机前脱敏敏感信息。运行需要 Windows,并安装 Debugging Tools for Windows 或 Microsoft Store 版 WinDbg。

核心功能

  • 01一次调用即可打开 .dmp、.mdmp、.hdmp 转储并返回自动分析结果。
  • 02通过 TCP、命名管道或 COM 连接用户态 cdb 远程调试服务。
  • 03通过 kd.exe 经 KDNET、命名管道或串口连接内核目标。
  • 04可在已打开的会话上执行任意 WinDbg/KD 命令。
  • 05支持多个会话同时打开,并通过会话 ID 独立操作。
  • 06提供 stdio 或 HTTP 传输方式,以及用于脱敏的过滤脚本。

适用场景

  • 借助 AI 助手,根据崩溃转储定位访问冲突或挂起的根因。
  • 在启用 KD 的机器上排查是哪个驱动导致内核 bugcheck。
  • 批量分析一个目录中的转储,寻找共同的故障特征。
  • 在另一台机器上通过 HTTP 远程操作 Windows 调试主机。

收录于专题

标签

#windbg#crash-dump#debugging#mcp#mcp-server#windows#kernel-debugging#copilot#copilot-chat#crash-reports

常见问题

mcp-windbg 是什么?
让 AI 助手通过 MCP 驱动 WinDbg(cdb/kd),分析 Windows 崩溃转储并调试用户态与内核目标。 mcp-windbg 是一个基于 Python 的 Model Context Protocol 服务器,封装了 Windows 调试器:用户态转储和远程调试使用 cdb.exe,内核目标使用 kd.exe。兼容 MCP 的客户端可以打开崩溃转储,获取 !analyze -v、调用栈、模块和线程等自动分析结果,并继续执行调试命令来辅助判断。
mcp-windbg 可以免费使用吗?用的什么许可证?
mcp-windbg 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
mcp-windbg 还在维护吗?
活跃维护中。mcp-windbg 最近一次提交是在 2026年10月28日。
mcp-windbg 适合用来做什么?
借助 AI 助手,根据崩溃转储定位访问冲突或挂起的根因。 在启用 KD 的机器上排查是哪个驱动导致内核 bugcheck。 批量分析一个目录中的转储,寻找共同的故障特征。 在另一台机器上通过 HTTP 远程操作 Windows 调试主机。
在哪里获取 mcp-windbg?
源代码和安装说明在 GitHub 上:https://github.com/svnscha/mcp-windbg

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目