
Ein MCP-Debugger-Server für Windows-ausführbare Dateien (x86 und x64). Stellt Debugger-Funktionalität als MCP-Werkzeuge für die statische/dynamische Analyse des Debuggees und Speicherinspektion über eine saubere Schnittstelle bereit.
Dieses Projekt ist ein selbst entwickelter, leichtgewichtiger MCP-Debugger-Server, der zum Lernen und Experimentieren erstellt wurde. Der MCP-Debugger-Server stellt Debugger-Funktionalität als MCP-Tools bereit und ermöglicht externen MCP-Clients, die Ausführung zu steuern, den Speicher zu inspizieren und den Debuggee über eine saubere Schnittstelle zu analysieren.
Der Debugger ist in C++ geschrieben und implementiert die Kern-Debugging-Funktionalität von Grund auf, ohne auf bestehende Debugger-Frameworks zurückzugreifen. Für das Instruktions-Decoding wird der Disassembler Zydis verwendet. Der Debugger ist in einen in C# geschriebenen MCP-Server integriert, der mit dem offiziellen MCP C# SDK erstellt wurde.
Schlagwörter: MCP-Server, Debugger, Disassembler, statische Analyse, dynamische Analyse, Debugging, KI, EXE, ausführbare Datei, Windows

In der Demo wurde Gemini CLI als MCP-Client verwendet
Diese Anleitung beschreibt Schritt für Schritt, wie Sie die MCP.Server.exe unter Windows erstellen und in Visual Studio Code integrieren.
Bevor Sie VS Code konfigurieren, müssen Sie den MCP-Server kompilieren:
MCPDebugger.slnx in Visual Studio 2026. Erforderliche Workloads: Desktopentwicklung mit C++ einschließlich der Komponenten C++/CLI-Unterstützung für v145-Buildtools und vcpkg-Paketmanager sowie .NET-Desktopentwicklung (installiert das .NET 10 SDK, auf das die Solution abzielt). Ältere Visual-Studio-Versionen verfügen nicht über das v145-Toolset und können die Solution nicht bauen.MCP.Server.exe in Ihrem Unterordner \build\Release\x86 oder \build\Release\x64 vorhanden ist.Der erste Build einer Konfiguration und Plattform benötigt Zugriff auf GitHub: Das native Testprojekt bezieht Google Test über vcpkg, und vcpkg liest seine Paketregistrierung von dort, wann immer es in einen frischen
build-Ordner installiert. Spätere Builds derselben Konfiguration und Plattform funktionieren offline. vcpkg sendet Nutzungsdaten an Microsoft, sofern die UmgebungsvariableVCPKG_DISABLE_METRICSnicht gesetzt ist.
MCP.Server.exebenötigt die .NET 10 Runtime in seiner eigenen Architektur: Der x86-Server benötigt die x86-Runtime, der x64-Server die x64-Runtime.
Stellen Sie sicher, dass die folgenden Erweiterungen in VS Code installiert und aktiv sind:
Ctrl + Shift + P, um die Befehlspalette zu öffnen.> ein und wählen Sie "Add MCP Server".command (stdio) als Servertyp.Geben Sie den vollständigen Pfad zu der in Schritt 1 gebauten MCP.Server.exe ein.
[!CAUTION] Es sollte immer nur eine Architektur (x86 oder x64) gleichzeitig als MCP-Server aktiv sein. Wenn Sie die Architektur wechseln, entfernen Sie zuerst den vorherigen Server-Eintrag.
| Architektur | Beispielpfad zur Eingabe |
|---|---|
| Windows x64 | C:\YourProject\bin\x64\MCP.Server.exe |
| Windows x86 | C:\YourProject\bin\x86\MCP.Server.exe |
Ctrl + Alt + I), wechseln Sie in den Agent-Modus und klicken Sie auf das Tools-Symbol. Ihre MCP-Tools sollten nun aufgelistet und einsatzbereit sein. MCP-Tools können hier aktiviert bzw. deaktiviert werden.

Für komplexe Debugging- und Reverse-Engineering-Aufgaben mit diesem MCP-Debugger lieferte Claude Opus 4.5 mit Stand November 2025 mit Abstand die besten Ergebnisse. Es bewältigte große Ausführungs-Traces, detailliertes Disassembly und mehrstufiges Reasoning zuverlässiger als andere getestete Modelle.
ChatGPT 4.1 und Gemini 2.5 Pro waren für einfachere Analyseszenarien ausreichend, wie etwa grundlegendes Stepping, Instruction-Inspektion und unkomplizierte Control-Flow-Analysen. Diese Modelle schnitten bei den in den Ordnern Example_x64 und Example_x86 bereitgestellten Beispielen gut ab, zeigten jedoch Einschränkungen bei komplexeren oder lang andauernden Debugging-Sitzungen.
Die Modellleistung kann sich im Laufe der Zeit ändern, die obigen Ausführungen spiegeln jedoch das zum Zeitpunkt der Tests beobachtete Verhalten wider.
Das Debuggen über MCP kann zu hohem Token-Verbrauch und erhöhten Kosten führen. KI-Interaktionen sind zustandslos, was bedeutet, dass der gesamte relevante Debugging-Kontext (Register, Speicher, Disassembly, Module usw.) bei jeder Anfrage erneut übertragen werden muss.
Operationen, die die Ausführung häufig anhalten und detaillierten Zustand zurückgeben – wie Stepping und temporäre Breakpoints – können den Token-Verbrauch erheblich erhöhen.
Wenn kostengünstiger Betrieb erforderlich ist, wird dringend empfohlen, sich auf die statische Analyse zu konzentrieren und die folgenden MCP-Tools zu deaktivieren:
Das Deaktivieren dieser Tools reduziert die Menge der wiederholten Zustandsübertragung und hilft, den Token-Verbrauch unter Kontrolle zu halten.
Das Repository enthält Beispielprojekte, die den Einstieg in die statische Analyse und das Debugging erleichtern, und befindet sich in den folgenden Ordnern:
Example_x64 und Example_x86
Die Projekte Example_x64 und Example_x86 stellen eine einfache Konsolenanwendung bereit, die als einführendes Debugging-Ziel dient. Die Anwendung fordert den Benutzer zur Laufzeit zur Eingabe eines Passworts auf. Das korrekte Passwort für beide Beispiele lautet secret.
MCP_Debugging_Sessions
Ein Ordner mit komplexeren Debugging-Sitzungen, die dynamische Analyse und Debugging nutzen. In diesen Sitzungen wurde Claude Opus 4.5 verwendet. Die Ziele können hier heruntergeladen werden. Bitte beachten Sie, dass die Ziele mit UPX -d entpackt wurden, bevor der MCP Debugger verwendet wurde.
Der MCP-Server stellt die folgenden Tools für die Interaktion mit dem Debugger bereit:
Debugger_Start
Startet den Debugger für die angegebene ausführbare Datei und hält am anfänglichen System-Breakpoint an.
Debugger_Stop
Stoppt den Debugger und beendet den Debuggee-Prozess.
Debugger_Continue
Setzt die Ausführung fort, wenn der Debuggee an einem Breakpoint angehalten wurde.
Debugger_ContinueToEntryPoint
Setzt die Ausführung vom System-Breakpoint bis zum Programmeinstiegspunkt fort.
Debugger_ContinueToBreakpoint
Setzt die Ausführung fort, bis ein temporärer Breakpoint an einer angegebenen virtuellen Adresse erreicht wird.