Windbg

安装配置

python -m mcp_windbg --transport streamable-http --host 127.0.0.1 --port 8000

README 摘要

# MCP Server for WinDbg Crash Analysis A Model Context Protocol server that bridges AI models with WinDbg for crash dump analysis and remote debugging. ## Overview This MCP server integrates with [CDB](https://learn.microsoft.com/en-us/windows-hardware/drivers/debugger/opening-a-crash-dump-file-using-cdb) to enable AI models to analyze Windows crash dumps and connect to remote debugging sessions using WinDbg/CDB. ## What is this? An AI-powered tool that bridges LLMs with WinDbg for crash dump analysis and live debugging. Execute debugger commands through natural language queries like *"Show me the call stack and explain this access violation"*. ## What This is Not Not a magical auto-fix solution. It's a Python wrapper around CDB that leverages LLM knowledge to assist with debugging. ## Usage Modes - **Crash Dump Analysis**: Examine Windows crash dumps - **Live Debugging**: Connect to remote debugging targets - **Directory Analysis**: Process multiple dumps for patterns ## Quick Start ### Prerequisites - Windows with [Debugging Tools for Windows](https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/) or [WinDbg from Microsoft Store](https://apps.microsoft.com/detail/9pgjgd53tn86). - Python 3.10 or higher - Any MCP-compatible client (GitHub Copilot, Claude Desktop, Cline, Cursor, Windsurf etc.) - Configure MCP server in your chosen client > [!TIP] > In enterprise environments, MCP server usage might be restricted by organizational policies. Check with your IT team about AI tool usage and ensure you have the necessary permissions before proceeding. ### Installation ```bash pip install mcp-windbg ``` ## Transport Options The MCP server supports multiple transport protocols: | Transport | Description | Use Case | |-----------|-------------|----------| | `stdio` (default) | Standard input/output | Local MCP clients like VS Code, Claude Desktop | | `streamable-http` | Streamable HTTP | Modern HTTP clients with bidirectional streaming | ### Starting with Different Transports **Standard I/O (default):** ```bash mcp-windbg # or explicitly mcp-windbg --transport stdio ``` **Streamable HTTP:** ```bash mcp-windbg --transport streamable-http --host 127.0.0.1 --port 8000 ``` Endpoint: `http://127.0.0.1:8000/mcp` ### Command Line Options ``` --transport {stdio,streamable-http} Transport protocol (default: stdio) --host HOST HTTP server host (default: 127.0.0.1) --port PORT HTTP server port (default: 8000) --cdb-path PATH Custom path to cdb.exe --symbols-path PATH Custom symbols path --timeout SECONDS Command timeout (default: 30) --verbose Enable verbose output ``` ## Configuration for Visual Studio Code To make MCP servers available in all your workspaces, use the global user configuration: 1. Press `F1`, type `>` and select **MCP: Open User Configuration**. 2. Paste the following JSON snippet into your user configuration: ```json { "servers": { "mcp_windbg": { "type": "stdio", "command": "python", "args": ["-m", "mcp_windbg"], "env": { "_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols" } } } } ``` This enables MCP Windbg in any workspace, without needing a local `.vscode/mcp.json` file. ### HTTP Transport Configuration Fo...