Overview

dbgeng-mcp is a Model Context Protocol (MCP) server that bridges AI assistants to the Windows Debugging Engine (dbgeng.dll). Built with Python and a native C++ extension (pybind11), it exposes debugger functionality as MCP tools so that LLM-based agents can launch, attach to, and inspect processes through natural language. The project is currently alpha software under active development and is MIT licensed.

Features

Process Control

  • Launch a process under the debugger
  • Attach to a running process
  • Detach from the target
  • Restart the current debug session

Execution Control

  • Continue, break, and step execution
  • Run until a specific event occurs

State Inspection

  • Query debugger state
  • Retrieve debugger output and event log
  • Get stack traces

Memory & Commands

  • Read target memory
  • Execute arbitrary WinDbg commands

Extension Management

  • Load, unload, and list debugger extensions

Safety

  • Read-only mode
  • Automatic SDK discovery via Windows registry

Quick Start

1. Install (requires Python 3.10+ x64 and Debugging Tools for Windows):

pip install dbgeng-mcp

2. Run the MCP server:

dbgeng-mcp

3. Example MCP client config (e.g. for Claude Desktop or similar):

{
  "dbgeng-mcp": {
    "command": "dbgeng-mcp",
    "trust": true
  }
}