Metadata-Version: 2.4
Name: dbgeng-mcp
Version: 0.1.0
Summary: A Model Context Protocol server for the Windows Debugging Engine (dbgeng)
Keywords: debugger,windbg,dbgeng,mcp,reverse-engineering,windows
Author-Email: "Ryan Johnson (ntninja)" <ryan@ntninja.com>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: System :: Systems Administration
Classifier: Environment :: Console
Project-URL: Homepage, https://gitlab.com/ntninja-dev/dbgeng-mcp
Project-URL: Repository, https://gitlab.com/ntninja-dev/dbgeng-mcp
Project-URL: Bug Tracker, https://gitlab.com/ntninja-dev/dbgeng-mcp/-/issues
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0
Description-Content-Type: text/markdown

# dbgeng-mcp

A Model Context Protocol (MCP) server that interfaces with the Windows Debugging Engine (`dbgeng.dll`) using a native C++ bridge (pybind11).

> **Alpha software** — this project is under active development. APIs and tool names may change between releases. Feedback and bug reports are welcome.

## Features
- Native x64 debugging on Windows.
- Managed debugging session lifecycle.
- Core process control (Launch, Attach, Break, Continue, Step).
- State inspection (Registers, Memory, Stack).

## Prerequisites

### Windows (target machine)
- **Python 3.10+** (x64)
- **Debugging Tools for Windows** — install via the Windows SDK:
  1. Download the [Windows SDK](https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/).
  2. During install, select **"Debugging Tools for Windows"**. No other components are required.
  3. The installer places `dbgeng.dll` under `C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\`.

  > The system `dbgeng.dll` in `System32` works as a fallback, but the SDK version is recommended for full functionality. The server auto-discovers the SDK installation via the registry.

## Installation

```powershell
pip install dbgeng-mcp
```

To build from source instead, see [CONTRIBUTING.md](CONTRIBUTING.md).

## Usage

### Running the MCP server
```powershell
dbgeng-mcp
```

### Agent configuration

Add the server to your agent's MCP configuration file.

**Claude Desktop** (`claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "dbgeng": {
      "command": "dbgeng-mcp"
    }
  }
}
```

**Claude Code** (`.mcp.json`):
```json
{
  "mcpServers": {
    "dbgeng": {
      "command": "dbgeng-mcp"
    }
  }
}
```

