mcp-windbg-rs

中文文档 | English

A Model Context Protocol (MCP) server for Windows debugging — crash dump analysis, remote debugging, and direct program debugging via CDB.

Built with Rust and Tokio for async I/O. Ships as a single executable with no runtime dependencies.

Features

• Crash dump analysis — Open .dmp files, auto-run !analyze -v, inspect threads, modules, and stack traces
• Remote debugging — Connect to remote debug sessions via connection strings
• Direct program debugging — Launch executables under CDB, set breakpoints, step through code, inspect variables
• Session management — Multiple concurrent debug sessions with automatic reuse
• Configurable timeouts — Separate timeouts for initialization (symbol loading) and command execution

Prerequisites

• Windows 10+
• Debugging Tools for Windows (provides cdb.exe)

If CDB is not installed, you can get it via:

winget install Microsoft.WinDbg

The server auto-discovers CDB from Windows SDK default paths, WinDbg Preview (Microsoft Store), and PATH.

Installation

From source

cargo build --release

Binary: target/release/mcp-windbg-rs.exe

Configuration

VS Code / Kiro

.vscode/mcp.json:

{
  "servers": {
    "mcp-windbg": {
      "type": "stdio",
      "command": "/path/to/mcp-windbg-rs.exe",
      "args": [],
      "env": {
        "_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
      }
    }
  }
}

Claude Desktop / Cline / Other MCP Clients

{
  "mcpServers": {
    "mcp-windbg-rs": {
      "command": "mcp-windbg-rs",
      "args": [],
      "env": {
        "_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
      }
    }
  }
}

Environment Variables

CLI Options

mcp-windbg-rs [OPTIONS]

  --timeout        Command execution timeout (default: 30)
  --init-timeout   Initialization timeout (default: 120)
  --verbose                 Enable verbose logging

Tools