IDAssistMCP

[!IMPORTANT] Geplante Archivierung: IDAssistMCP ist zur Archivierung vorgesehen, da IDA Pro einen gebündelten nativen MCP-Server einführt. Die native Unterstützung macht die Pflege einer separaten MCP-Integration überflüssig und hält sie mit IDA Pro selbst im Einklang. Bitte verwenden Sie den nativen MCP-Server von IDA Pro, sobald er in Ihrer installierten Version verfügbar ist. Dieses Repository bleibt als Referenz verfügbar.

Eigenständiges MCP-Server-Plugin (Model Context Protocol) für IDA Pro 9.x, das die Analysefunktionen von IDA für LLM-Clients wie Claude Desktop bereitstellt.

Funktionen

• 41 MCP-Tools für Binäranalyse, Dekompilierung, Querverweise, Symbolverwaltung, Typsystem, Navigation, Patching, Export und mehr
• 6 konsolidierte Tools mit action/format/direction-Parametern für Kommentare, Variablen, Typen, Xrefs, Lesezeichen und Code
• 8 MCP-Ressourcen für durchsuchbare Binärmetadaten (Triage, Funktionen, Importe, Exporte, Strings, Info, Segmente, Abschnitte)
• 7 geführte Prompts für gängige Reverse-Engineering-Workflows (Funktionsanalyse, Identifizierung von Schwachstellen, Dokumentation, Datenflussverfolgung, Funktionsvergleich, Struct-Recovery, Netzwerkprotokollanalyse)
• SSE- und Streamable-HTTP-Transporte über Hypercorn ASGI-Server
• Thread-sichere IDB-Änderungen über den execute_on_main_thread()-Wrapper
• LRU-Analyse-Cache für teure Operationen wie Dekompilierung
• Asynchroner Task-Manager für lang laufende Operationen
• Pydantic-Konfiguration mit Unterstützung für Umgebungsvariablen (Präfix IDASSISTMCP_)

Installation

Voraussetzungen

• IDA Pro 9.x mit Python 3.10+
• Hex-Rays Decompiler (optional, für Dekompilierungstools)

Option 1: IDA Plugin Manager (empfohlen)

hcli plugin install idassistmcp

Dies installiert das Plugin und seine Python-Abhängigkeiten automatisch.

Option 2: Manuelle Installation (aus dem Release-Tarball)

Laden Sie das neueste Release-Zip von GitHub Releases herunter und entpacken Sie es in Ihr IDA-Plugins-Verzeichnis:

Linux / macOS:

unzip IDAssistMCP-*.zip -d ~/.idapro/plugins/

Windows: Entpacken Sie das Zip in %APPDATA%\Hex-Rays\IDA Pro\plugins\.

Installieren Sie dann die Abhängigkeiten mit IDAs gebündeltem Python (nicht Ihrem System-Python):

Linux / macOS:

<IDA_INSTALL_DIR>/python3/bin/pip3 install -r ~/.idapro/plugins/IDAssistMCP/requirements.txt

Windows:

"<IDA_INSTALL_DIR>\python3\python.exe" -m pip install -r "%APPDATA%\Hex-Rays\IDA Pro\plugins\IDAssistMCP\requirements.txt"

Ersetzen Sie <IDA_INSTALL_DIR> durch Ihren IDA Pro-Installationspfad.

Tipp: Sie können auch die Umgebungsvariable IDAUSR verwenden, um ein benutzerdefiniertes Plugins-Verzeichnis anzugeben.

Verwendung

Starten des Servers

1. Öffnen Sie eine Binärdatei in IDA Pro
2. Drücken Sie Strg+Umschalt+M oder gehen Sie zu Edit > Plugins > IDAssistMCP
3. Die MCP-Server-URL wird im Ausgabefenster von IDA ausgegeben
4. Drücken Sie erneut Strg+Umschalt+M, um den Server zu stoppen

Claude Desktop-Konfiguration

Fügen Sie Folgendes zu Ihrer Claude Desktop claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "idassistmcp": {
      "url": "http://localhost:9080/mcp"
    }
  }
}

Umgebungsvariablen

Konfigurieren Sie über Umgebungsvariablen mit dem Präfix IDASSISTMCP_:

Variable	Standard	Beschreibung
IDASSISTMCP_SERVER__HOST	localhost	Server-Bind-Adresse
IDASSISTMCP_SERVER__PORT	9080	Server-Port
IDASSISTMCP_SERVER__TRANSPORT	streamablehttp	Transporttyp (sse oder streamablehttp)
IDASSISTMCP_DEBUG	false	Debug-Modus aktivieren
IDASSISTMCP_LOG_LEVEL	INFO	Log-Level

Tools-Referenz

Binärverwaltung (2)

Tool	Beschreibung
list_binaries	Listet die aktuell geladene Binärdatei auf
get_binary_info	Detaillierte Binärmetadaten (Arch, Hashes, Segmente)

Codeanalyse (4)

Tool	Beschreibung
get_code	Funktionscode abrufen — format: 'decompile' (Pseudo-C) oder 'disasm' (Assembly)
analyze_function	Umfassende Analyse: Metadaten, CFG, Aufrufer/Aufgerufene, Dekompilierung
get_basic_blocks	CFG-Basisblöcke mit Nachfolgern/Vorgängern
get_function_stack_layout	Stack-Frame-Layout (lokale Variablen, Argumente, gespeicherte Register)

Querverweise (1 konsolidiert)

Tool	Aktionen	Beschreibung
xrefs	direction: to/from/both, include_calls: bool	Xrefs und optionale Aufrufer/Aufgerufene für eine Adresse

Kommentare (1 konsolidiert)

Tool	Aktionen	Beschreibung
comments	action: get, set, list, remove	Kommentare verwalten (regulär, wiederholbar, Funktion)

Variablen (1 konsolidiert)

Tool	Aktionen	Beschreibung
variables	action: list, rename	Lokale Variablen auflisten oder lokale/globale Variablen umbenennen mit scope: auto, local, global

Typen (2 — 1 konsolidiert + 1 eigenständig)

Tool	Aktionen / Beschreibung
types	action: list, set, create_struct, create_enum — IDB-Typen verwalten
get_classes	Struct-/Klassentypen aus der Typbibliothek auflisten

Funktionserkennung (5)

Tool	Beschreibung
get_functions	Alle Funktionen mit Filterung und Paginierung
search_functions_by_name	Suche nach Namensmuster und Größenfiltern
get_function_by_name	Exakte Namenssuche
get_function_by_address	Adresssuche
get_function_statistics	Aggregierte Statistiken (Anzahlen, Größen, Top-10)

Symbolverwaltung (2)

Tool	Beschreibung
rename_symbol	Beliebige Symbole umbenennen (Funktion oder Daten)
batch_rename	Mehrere Symbole im Batch umbenennen

Binärinformationen (5)

Tool	Beschreibung
get_imports	Importtabelle gruppiert nach Modul
get_exports	Exporttabelle
get_strings	String-Tabelle mit Paginierung
get_segments	Speichersegmente mit Berechtigungen
get_entry_points	Alle Einstiegspunkte der Binärdatei

Datenanalyse (6)

Tool	Beschreibung
read_memory	Rohbytes an Adresse lesen
get_data_at	Typisierte Daten an Adresse abrufen
search_bytes	Binäre Byte-Mustersuche
search_strings	String-Suche mit Paginierung
create_data_var	Datenvariable an Adresse definieren (byte/word/dword/qword/float/ascii/C-Typ)
get_data_vars	Definierte Datenvariablen auflisten (Nicht-Code-Elemente)

Patching (3)

Tool	Beschreibung
patch_bytes	Rohbytes in IDB patchen
assemble_code	Instruktionstext an einer Adresse assemblieren und optional patchen
export_program	Die gepatchte Binärdatei oder IDA-Datenbank auf die Festplatte exportieren

Navigation (4)

Tool	Beschreibung
navigate_to	IDA-Cursor an Adresse bewegen
bookmarks	Konsolidierte Lesezeichenverwaltung - Aktionen: list, set, remove
get_current_address	Adresse und Kontext an Cursorposition abrufen
get_current_function	Funktionsinformationen an Cursorposition abrufen