Minimal Model Context Protocol (MCP) server for policy-aware WinDBG / CDB automation & structured dump analysis.

Single path assumption: WinDbg (Store) is installed at C:\Program Files\WindowsApps\Microsoft.WinDbg_1.2409.17001.0_x64__8wekyb3d8bbwe\amd64

Prerequisite: Install the latest Windows 10/11 SDK and ensure the following components are selected so that cdb.exe is available:

• Debugging Tools for Windows (required)
• (optional) Windows SDK component updates if prompted

The SDK installs cdb.exe under C:\Program Files (x86)\Windows Kits\10\Debuggers\x64. The server will use that path automatically if WINDBG_PATH does not contain a copy of the console debugger.

1. Install WinDbg from the Microsoft Store (already done in your scenario).
2. Set environment variable (current session):

$env:WINDBG_PATH = 'C:/Program Files/WindowsApps/Microsoft.WinDbg_1.2409.17001.0_x64__8wekyb3d8bbwe/amd64'

3. Sanity check:

& "$env:WINDBG_PATH/cdb.exe" -version

4. Run server & list tools:

'{"method":"list_tools"}' | dotnet run --project src/Mcp.Windbg.Server/Mcp.Windbg.Server.csproj

Expected output starts with { "ok": true, "result": [ { "name": "health_check" ... } ] }.

{
  "modelContextProtocol.servers": {
    "windbg": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "${workspaceFolder}/src/Mcp.Windbg.Server/Mcp.Windbg.Server.csproj"
      ],
      "env": {
  "WINDBG_PATH": "C:/Program Files/WindowsApps/Microsoft.WinDbg_1.2409.17001.0_x64__8wekyb3d8bbwe/amd64"
      },
      "restart": "onFailure",
      "version": 1
    }
  }
}

import { spawn } from 'node:child_process';
const proc = spawn('dotnet', ['run', '--project', 'src/Mcp.Windbg.Server/Mcp.Windbg.Server.csproj'], {
  stdio: ['pipe', 'pipe', 'inherit'],
  env: { ...process.env, WINDBG_PATH: 'C:/Program Files/WindowsApps/Microsoft.WinDbg_1.2409.17001.0_x64__8wekyb3d8bbwe/amd64' }
});
proc.stdout.on('data', d => process.stdout.write('[SERVER] ' + d));
proc.stdin.write('{"method":"list_tools"}\n');

import json, subprocess, threading, os
proc = subprocess.Popen([
  'dotnet','run','--project','src/Mcp.Windbg.Server/Mcp.Windbg.Server.csproj'
], stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, env={**os.environ, 'WINDBG_PATH': 'C:/Program Files/WindowsApps/Microsoft.WinDbg_1.2409.17001.0_x64__8wekyb3d8bbwe/amd64'})
def reader():
    for line in proc.stdout: print('[SERVER]', line.rstrip())
threading.Thread(target=reader, daemon=True).start()
proc.stdin.write(json.dumps({"method":"list_tools"}) + "\n")
proc.stdin.flush()

Send a single list_tools request through stdin and capture the one-line JSON response:

'{"method":"list_tools"}' | dotnet run --project src/Mcp.Windbg.Server/Mcp.Windbg.Server.csproj

Expected output starts with:

{"ok":true,"result":[{"name":"health_check"...

List tools:

{"method":"list_tools"}

Run command (example):

{"method":"call_tool","name":"run_command","args":{"sessionId":"sess1","command":"!analyze -v"}}

Notes:

• Arguments & results are being migrated to typed contracts (see AnalyzeDumpTool).
• Additional managed (.NET) enrichment (analyze_managed_context) planned.

For extended product docs, PRDs, ADRs, and roadmap: see docs/prd/ directory.