Lokaler, deterministischer MCP-Server für IDA Pro/Home: 109 Reverse-Engineering-Operationen mit striktem Schema, evidenzbasierte Ergebnisse und richtlinienbasierte IDB-Bearbeitungen.
⚠️ Archiviert — ersetzt durch den offiziellen Hex-Rays IDA MCP-Server
Dieses Projekt wird nicht mehr gepflegt. Am 27.09.2026 veröffentlichte die Hex-Rays SA den Offiziellen IDA MCP-Server und IDA Nexus. Die Entwicklung wurde am selben Tag bei
1.0.0a4eingestellt.Für die aktuelle Nutzung installieren Sie deren Version:
uvx ida-hcli mcp install. Sie erfordert IDA 9.4+ mitidalibund funktioniert vollständig headless; das GUI-Plugin ist optional.Dieses Repository wird für seine Testsuite, Dokumentation und architektonische Aufzeichnung erhalten. Siehe ARCHIVE.md für den vollständigen Abschlussbericht: was das Projekt war, warum es sich nicht durchsetzte, welche Teile Gerüst waren und welche Teile noch von Wert sind. Der Rest dieser README beschreibt ein System, das nicht mehr zur Nutzung empfohlen wird.
IDA Pro MCP ist ein lokaler Model Context Protocol-Server für IDA Pro. Er ermöglicht einem MCP-Client, eine IDB zu inspizieren, IDA nach deterministischen Analyseergebnissen zu fragen und, wenn ausdrücklich erlaubt, Anmerkungen oder andere Änderungen zurück in die IDB zu schreiben. Der Host-Prozess läuft außerhalb von IDA und startet standardmäßig für jede Sitzung einen separaten IDA-Headless-Prozess.
ida_*-Operationen mit
Live-Erkennung über tools/list und ida_help.Die aktuelle Version ist 1.0.0a4. Dies ist Alpha-Software. Die öffentlichen
ida_*-Operationsnamen, Schemas und das Workspace-Format können sich vor einem
stabilen 1.0.0-Release ändern. Die Standard-Client-Oberfläche enthält 102 Operationen mit exaktem Schema.
Nutzen Sie die Live-Erkennung für den vollständigen Vertrag: tools/list zählt jede
Operation mit ihrem Schema auf, und ida_help(topic="...") liefert die exakten
Argumente und ein Beispiel für eine Operation.
Sie benötigen:
idat/idat64-Executable.
Die Live-Testbelege des Repositories decken IDA 9.3 und 9.4 ab; 9.2 ist die
erklärte Kompatibilitätsuntergrenze.Die normale Analyse erfordert keinen Intelligence-Provider. Die expliziten
Intelligence-Modi sind jev, custom und disabled; der deaktivierte Modus hält
die deterministische lexikalische Suche verfügbar, und es gibt keinen lokalen, Gemini- oder
Native-Model-Fallback.
Die Standard-Laufzeit ist idat: ein Headless-IDA-Prozess pro Sitzung. Das
idalib-Backend ist experimentell, erfordert eine IDA-9.3-oder-neuere-Installation
mit aktiviertem idapro-Paket und ist für eine Erstinstallation nicht erforderlich.
Der Installer erstellt eine verwaltete Umgebung unter dem Installationsstamm, installiert eine eingefrorene Kopie des Checkouts darin und schreibt die Client-Konfiguration für die unterstützten Client-Speicherorte. Führen Sie im Repository-Stamm Folgendes aus:
python3 install.py
Für eine bekannte IDA-Installation übergeben Sie diese explizit:
python3 install.py --ida-dir /path/to/ida-pro-9.3
Für einen nicht-interaktiven Lauf:
python3 install.py --yes --no-ida-prompt --ida-dir /path/to/ida-pro-9.3
Der Installer kann IDA auch über IDADIR, IDA_DIR, die IDA-Executables im PATH und gängige Installationsverzeichnisse finden. --ida-version wählt eine Version aus, wenn mehr als eine Installation vorhanden ist. Verwenden Sie --dry-run, um die geplanten Änderungen zuerst zu prüfen.
Der Installer lädt niemals ein Provider-Modell oder eine Runtime herunter. Er kann Konfigurationsdateien für jeden Client-Speicherort in seiner integrierten Client-Zuordnung erstellen oder aktualisieren, einschließlich Clients, die nicht auf Ihrem Rechner installiert sind. Prüfen Sie install-report.json im Installationsstammverzeichnis und entfernen Sie bei Bedarf ungenutzte Einträge. Bestehende reguläre Konfigurationsdateien werden vor ihrer Änderung gesichert; fehlerhafte, symbolisch verlinkte oder nicht-reguläre Dateien werden abgelehnt statt überschrieben.
Starten Sie den MCP-Client nach der Installation neu, damit er seine Konfiguration neu lädt.
Agent-Harnesses entdecken die Tool-Oberfläche live: tools/list zählt jede Operation mit ihrem Schema auf, und ida_help(topic="...") liefert exakte Argumente und ein Beispiel. Es werden keine statischen Skill-Dateien installiert.
Das Standard-Installationsstammverzeichnis ist:
~/.local/share/ida-pro-mcp%LOCALAPPDATA%/ida-pro-mcpLegen Sie IDA_PRO_MCP_HOME fest oder übergeben Sie --install-root, um einen anderen Speicherort zu wählen.
Alpha-Releases werden von GitHub Actions erstellt und manuell als Prereleases veröffentlicht. Wenn ein Release verfügbar ist, laden Sie das Asset bundle.zip oder bundle.tar.gz und die zugehörige Datei SHA256SUMS von der Releases-Seite herunter. Überprüfen Sie die Prüfsumme, entpacken Sie das Bundle und führen Sie den Installer aus seinem obersten Verzeichnis aus:
python3 install.py --yes --no-ida-prompt --ida-dir /path/to/ida-pro-9.3
Das Release enthält außerdem ein Wheel und eine Quelldistribution für skriptgesteuerte Python-Installationen. Das Bundle ist der einfachste Weg, da es den Installer und alle Projektdateien enthält, die zur Konfiguration eines MCP-Clients benötigt werden. Releases haben Alpha-Qualität; bewahren Sie die Original-Binärdatei und IDB auf und lesen Sie die Release Notes, bevor Sie ein Upgrade durchführen.
Der Installer schreibt den Servereintrag für die ihm bekannten Konfigurationspfade des Clients. Er unterstützt Gemini CLI, Antigravity, Antigravity IDE, Antigravity CLI, Claude Code, Codex, Copilot CLI, OpenCode, Claude Desktop, Cursor, VS Code, Windsurf, Cline und Roo Code. OpenCode und Clients aus der Copilot-Familie verwenden unterschiedliche Konfigurationsformen; lassen Sie den Installer diese Dateien schreiben oder folgen Sie der OpenCode-Einrichtungsanleitung.
Für einen Client, der das gängige JSON-Format verwendet, entspricht der Eintrag: