# Windbg MCP

> Windbg MCP is an open-source MCP server for developer tools. WinDbg and DbgEng for AI agents: crash dumps, live kernel debugging and time travel traces. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, CLI, self-hosted
- **Repository:** https://github.com/glslang/windbg-mcp
- **MCP Registry name:** io.github.glslang/windbg-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

This server hands an agent a real debugger engine. It supports user-mode and kernel-mode live debugging, crash-dump triage and Time Travel Debugging, and can read a VBS guest's Secure Kernel (VTL1) from a Hyper-V checkpoint or control selected virtual processors in a disposable VBS VM. Driver source is included but you supply the built, signed and installed driver. Windows only.

It runs over stdio, or over HTTP with --listen to serve clients on other machines. Each session gets its own engine worker, up to four at once, and results can carry structuredContent with error categories a caller can branch on. Extras include debug_batch for transactional sequences, walk_memory for lists and chains where an unreadable node becomes a row, kernel connection profiles that keep a KDNET key out of the transcript, and opt-in JSONL call transcripts.

The README is blunt about risk: kernel attach and TTD need Administrator, so use only binaries from the project's releases and verify them against SHA256SUMS.txt and the signed attestation. It says there is no hosted version and no paid edition; it is MIT-licensed. Documented limits include TTD being user-mode only.

## Features

- **Dump and live debugging:** Drives user-mode, kernel-mode and crash-dump sessions.
- **Time Travel Debugging:** Replays recorded user-mode traces.
- **Secure Kernel research:** Reads VTL1 from Hyper-V checkpoints and controls selected VPs in a VBS VM.
- **Session handles:** Routes calls by session_id with a four-session cap.
- **Transactional batches:** debug_batch cleans up on every exit path.
- **Remote listener:** --listen serves the same tools over HTTP.

## Good for

- Triage a Windows crash dump with an agent
- Step through a driver's IOCTL surface
- Analyse a recorded TTD trace
- Debug a kernel target without leaking the KDNET key
- Investigate the Secure Kernel in a lab VM

## Install

### Claude Code (Terminal)

```sh
claude mcp add windbg-mcp -- npx -y https://github.com/glslang/windbg-mcp/releases/download/v0.24.0/windbg-mcp-v0.24.0-windows-x64.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "windbg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/glslang/windbg-mcp/releases/download/v0.24.0/windbg-mcp-v0.24.0-windows-x64.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "windbg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/glslang/windbg-mcp/releases/download/v0.24.0/windbg-mcp-v0.24.0-windows-x64.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "windbg-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/glslang/windbg-mcp/releases/download/v0.24.0/windbg-mcp-v0.24.0-windows-x64.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "windbg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/glslang/windbg-mcp/releases/download/v0.24.0/windbg-mcp-v0.24.0-windows-x64.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "windbg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/glslang/windbg-mcp/releases/download/v0.24.0/windbg-mcp-v0.24.0-windows-x64.mcpb"
      ]
    }
  }
}
```

## Tools

- `debug_batch`: Runs a mutating sequence with guaranteed cleanup
- `walk_memory`: Walks lists, arrays and chains in memory

## FAQ

### Is there a hosted or paid version?

No. The README says it is free, MIT-licensed, and has no hosted version or premium tier.

### Which platform does it need?

Windows; the release is a windows-x64 .mcpb bundle.

### Does it need Administrator?

Kernel attach and TTD recording do, and --install-service runs it as LocalSystem.

### Where should I get binaries?

Only from the project's GitHub releases, checked against SHA256SUMS.txt and the build attestation.

### Is Windbg MCP free?

Yes. Windbg MCP is open source, so you can use and self-host it for free.

### How do I add Windbg MCP to Claude Code?

Run this command in your terminal: claude mcp add windbg-mcp -- npx -y https://github.com/glslang/windbg-mcp/releases/download/v0.24.0/windbg-mcp-v0.24.0-windows-x64.mcpb

### What are the best alternatives to Windbg MCP?

The closest alternatives to Windbg MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/windbg-mcp
