ctxdebug

MCP-Server für WinDbg, IDA Pro und x64dbg
Eine stdio-Schnittstelle · 160+ Tools · Drei Debugger, ein Client.

Schnellstart · Architektur · Server · Workflows · Problem melden

Website · ctxdebug.xyz  ·  Kontakt · [email protected]  ·  Status · Öffentliche Alpha

_{Für autorisiertes Reverse Engineering, Absturzanalyse und Sicherheitsforschung an Systemen, die Ihnen gehören oder deren Analyse Sie genehmigt haben.}

▎ Überblick

ctxdebug ist eine MCP-Plattform (Model Context Protocol), die WinDbg, IDA Pro 9.x und x64dbg mit KI-Coding-Assistenten verbindet. Nutzen Sie sie für die Analyse von Crash Dumps, statische Reviews in IDA und Live-Debugging in x64dbg — ohne Ausgaben zwischen Fenstern kopieren zu müssen.

Eine stdio-Schnittstelle. 160+ Tools. Drei Debugger, ein Client.

So funktioniert es. Jeder Debugger wird als MCP-Tool-Server bereitgestellt. Sie sprechen mit Claude, Kiro oder einem beliebigen MCP-kompatiblen Client; der Client ruft die Debugger auf. Kein Copy-Paste, keine manuelle Korrelation zwischen den Tools.

Beispiel. Sie fragen: „Analysiere diesen Crash Dump und finde die Ursache." ctxdebug öffnet den Dump in WinDbg, führt !analyze -v aus, nimmt die fehlerhafte Adresse, dekompiliert die Funktion in IDA Pro und liefert einen kombinierten Bericht mit Pseudocode und der Aufruferkette.

▎ Demo

_{Ein Prompt → WinDbg öffnet den Dump, analysiert den Absturz, IDA dekompiliert die fehlerhafte Funktion — kombinierter Bericht in ~1,8 s.}

▎ Schnellstart

Voraussetzungen

• Python 3.11+
• Betriebssystem Windows 10 / 11
• Mindestens ein Debugger — WinDbg (Windows SDK) · IDA Pro 9.x · x64dbg

Installation

git clone https://github.com/DdUdle/ctxdebug.git
cd ctxdebug
pip install -e .

Server registrieren

Einzelne Server:

claude mcp add windbg       -- python windbg_mcp.py
claude mcp add ida          -- python ida_mcp.py
claude mcp add x64dbg       -- python -m agent --mcp
claude mcp add mco          -- python mco_orchestrator.py
claude mcp add mco-sessions -- python mco_sessions.py

Oder verwenden Sie das einheitliche Gateway – ein Server, alle Tools:

claude mcp add mco-gateway -- python mco_gateway.py

Siehe mcp_config_example.json für die vollständige JSON-Konfiguration mit Umgebungsvariablen.

Ausprobieren

Sobald ein Server registriert ist, fragen Sie Ihren KI-Client:

Open C:\dumps\crash.dmp, run a full crash analysis,
and decompile the function at the fault address.

Der Orchestrator verkettet windbg_open_dump → windbg_analyze_crash → mco_pivot_to_ida und gibt Pseudocode mit der Aufruferkette zurück.

▎ Funktionen

▎ Architektur

• Transport — stdio JSON-RPC (MCP 2024-11-05)
• IDA — HTTP REST auf localhost:2022, erkennt den Endpunkt automatisch aus 6 Kandidaten
• x64dbg — binäres Framing über eine Named Pipe (X64A-Magic + uint32-Länge + 8-Byte-Padding + JSON)
• Agent — ReAct-Schleife mit austauschbaren LLM-Backends (Claude, Groq, OpenRouter, lokales Ollama oder nur Heuristiken)
• Sitzungen — SQLite mit FTS5, WAL-Modus, threadsicher
• Gateway — startet Sub-Server als Kindprozesse und leitet Tool-Aufrufe über eine einzige stdio-Verbindung weiter

▎ Server

▎ Debugger-Einrichtung

C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\cdb.exe