┌─────────────┐ JSON-RPC ┌──────────────────┐ │ │ (HTTP:13338/windbg) │ │ │ MCP 客户端 │◄─────────────────────────►│ MCP 服务器 │ │ (AI助手) │ │ (Python) │ └─────────────┘ └──────────────────┘ │ │ JSON-RPC ▼ ┌──────────────────┐ │ WinDbg 插件 │ │ (PyKD + HTTP) │ └──────────────────┘ │ │ PyKD API ▼ ┌──────────────────┐ │ WinDbg GUI │ └──────────────────┘

pip install pykd

cd windbg-gui-mcp pip install -e .

.load pykd !py C:\path\to\windbg-gui-mcp\src\windbg_gui_mcp\windbg_plugin.py

[WinDbg MCP] Server started at http://localhost:13338

{ "mcpServers": { "windbg-gui-mcp": { "command": "python", "args": [ "-m", "windbg_gui_mcp" ], "timeout": 1800, "disabled": false } } }

{ "mcpServers": { "windbg-gui-mcp": { "command": "python", "args": [ "-m", "windbg_gui_mcp" ] } } }

检查 WinDbg 连接

获取当前的调用堆栈

显示所有寄存器的值

读取地址 0x00401000 处的 64 字节内存

执行命令: dt ntdll!_PEB @$peb

分析当前异常并给出详细报告

执行命令: !analyze -v

@jsonrpc def my_custom_command(param: Annotated[str, "Description"]) -> str: """My custom WinDbg command""" result = pykd.dbgCommand(f"!myext.mycmd {param}") return result

@mcp.tool() def my_custom_command(param: str) -> str: """My custom WinDbg command""" return make_jsonrpc_request("my_custom_command", param)

# 查看 WinDbg 使用的 Python 版本 !py import sys; print(sys.version) # 在该环境中安装 PyKD python -m pip install pykd

pytest tests/

python -m windbg_gui_mcp --config