loading…
Spring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
автор: Community
0.00
Search for a command to run...
loading…
Enables AI assistants to interact with the WinDbg GUI through the Model Context Protocol using a PyKD-based plugin integration. It supports executing debugger c
Enables AI assistants to interact with the WinDbg GUI through the Model Context Protocol using a PyKD-based plugin integration. It supports executing debugger commands, inspecting registers, reading memory, and performing automated crash analysis via natural language.
一个为 WinDbg GUI 版本设计的 Model Context Protocol (MCP) 服务器，通过 PyKD 插件实现与 WinDbg 的集成。
采用插件 + MCP 服务器的方式：
┌─────────────┐ JSON-RPC ┌──────────────────┐
│ │ (HTTP:13338/windbg) │ │
│ MCP 客户端 │◄─────────────────────────►│ MCP 服务器 │
│ (AI助手) │ │ (Python) │
└─────────────┘ └──────────────────┘
│
│ JSON-RPC
▼
┌──────────────────┐
│ WinDbg 插件 │
│ (PyKD + HTTP) │
└──────────────────┘
│
│ PyKD API
▼
┌──────────────────┐
│ WinDbg GUI │
└──────────────────┘
pip install pykd
或从官方下载：https://githomeup.com/pykd/pykd/releases
cd windbg-gui-mcp
pip install -e .
在 WinDbg 中执行以下命令：
.load pykd
!py C:\path\to\windbg-gui-mcp\src\windbg_gui_mcp\windbg_plugin.py
你应该看到：
[WinDbg MCP] Server started at http://localhost:13338
编辑 cline_mcp_settings.json 或 mcp_settings.json：
{
"mcpServers": {
"windbg-gui-mcp": {
"command": "python",
"args": [
"-m",
"windbg_gui_mcp"
],
"timeout": 1800,
"disabled": false
}
}
}
编辑 claude_desktop_config.json：
{
"mcpServers": {
"windbg-gui-mcp": {
"command": "python",
"args": [
"-m",
"windbg_gui_mcp"
]
}
}
}
| 工具 | 说明 |
|---|---|
| check_connection() | 检查与 WinDbg 的连接状态 |
| get_debugger_info() | 获取调试器信息（内核/用户模式、架构等） |
| execute_command(command) | 执行任意 WinDbg 命令 |
| get_stack_trace() | 获取当前调用堆栈 |
| get_registers() | 获取所有 CPU 寄存器 |
| get_modules() | 获取加载的模块列表 |
| read_memory(address, size) | 读取指定地址的内存 |
| analyze_exception() | 运行 !analyze -v 分析异常 |
| get_threads() | 获取所有线程信息 |
检查 WinDbg 连接
获取当前的调用堆栈
显示所有寄存器的值
读取地址 0x00401000 处的 64 字节内存
执行命令: dt ntdll!_PEB @$peb
分析当前异常并给出详细报告
执行命令: !analyze -v
你可以在 windbg_plugin.py 中添加新的 JSON-RPC 方法：
@jsonrpc
def my_custom_command(param: Annotated[str, "Description"]) -> str:
"""My custom WinDbg command"""
result = pykd.dbgCommand(f"!myext.mycmd {param}")
return result
然后在 server.py 中添加对应的 MCP 工具：
@mcp.tool()
def my_custom_command(param: str) -> str:
"""My custom WinDbg command"""
return make_jsonrpc_request("my_custom_command", param)
确认 PyKD 已正确加载：
.chain # 查看加载的扩展
确认插件服务器正在运行：
!py print("Test") # 测试 PyKD
检查端口占用：
netstat -ano | findstr 13338
确保 PyKD 安装在 WinDbg 使用的 Python 环境中：
# 查看 WinDbg 使用的 Python 版本
!py import sys; print(sys.version)
# 在该环境中安装 PyKD
python -m pip install pykd
如果插件导致 WinDbg 崩溃，可以：
在加载前设置断点：
sxe ld pykd
查看详细错误：
!py import traceback; traceback.print_exc()
pytest tests/
python -m windbg_gui_mcp --config
MIT License
本项目参考了以下优秀项目：
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"windbg-gui-mcp-server": {
"command": "npx",
"args": []
}
}
}