mcp-windbg
by svnscha
Model Context Protocol for WinDBG
# Add to your Claude Code skills
git clone https://github.com/svnscha/mcp-windbgMCP Server for WinDbg Crash Analysis
A Model Context Protocol server that bridges AI models with WinDbg for crash dump analysis and remote debugging.
<!-- mcp-name: io.github.svnscha/mcp-windbg -->Overview
This MCP server integrates with 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 or WinDbg from Microsoft Store.
- 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
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):
mcp-windbg
# or explicitly
mcp-windbg --transport stdio
Streamable HTTP:
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:
- Press
F1, type>and...