ghidraMCP

ghidraMCP ist ein Model Context Protocol-Server, der es LLMs ermöglicht, Anwendungen autonom zu reverse-engineeren. Er stellt zahlreiche Werkzeuge aus der Kernfunktionalität von Ghidra für MCP-Clients bereit.

https://github.com/user-attachments/assets/36080514-f227-44bd-af84-78e29ee1d7f9

Funktionen

MCP Server + Ghidra Plugin

• Dekompiliere und analysiere Binärdateien in Ghidra
• Benenne Methoden und Daten automatisch um
• Liste Methoden, Klassen, Importe und Exporte auf

Installation

Voraussetzungen

• Installiere Ghidra
• Python3
• MCP SDK

Ghidra

Lade zunächst die neueste Version aus diesem Repository herunter. Diese enthält das Ghidra-Plugin und den Python-MCP-Client. Anschließend kannst du das Plugin direkt in Ghidra importieren.

1. Starte Ghidra
2. Wähle Datei -> Erweiterungen installieren
3. Klicke auf die +-Schaltfläche
4. Wähle die GhidraMCP-1-2.zip (oder deine gewählte Version) aus dem heruntergeladenen Release
5. Starte Ghidra neu
6. Stelle sicher, dass das GhidraMCPPlugin in Datei -> Konfigurieren -> Entwickler aktiviert ist
7. Optional: Konfiguriere den Port in Ghidra unter Bearbeiten -> Werkzeugoptionen -> GhidraMCP HTTP Server

Video-Installationsanleitung:

https://github.com/user-attachments/assets/75f0c176-6da1-48dc-ad96-c182eb4648c3

MCP-Clients

Theoretisch sollte jeder MCP-Client mit ghidraMCP funktionieren. Nachfolgend werden drei Beispiele aufgeführt.

Beispiel 1: Claude Desktop

Um Claude Desktop als Ghidra-MCP-Client einzurichten, gehe zu Claude -> Einstellungen -> Entwickler -> Config bearbeiten -> claude_desktop_config.json und füge Folgendes hinzu:

{
  "mcpServers": {
    "ghidra": {
      "command": "python",
      "args": [
        "/ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py",
        "--ghidra-server",
        "http://127.0.0.1:8080/"
      ]
    }
  }
}

Alternativ kannst du diese Datei direkt bearbeiten:

/Users/YOUR_USER/Library/Application Support/Claude/claude_desktop_config.json

Die Server-IP und der Port sind konfigurierbar und sollten auf die Ziel-Ghidra-Instanz zeigen. Falls nicht gesetzt, verwenden beide standardmäßig localhost:8080.

Beispiel 2: Cline

Um GhidraMCP mit Cline zu verwenden, muss der MCP-Server manuell gestartet werden. Führe zunächst den folgenden Befehl aus:

python bridge_mcp_ghidra.py --transport sse --mcp-host 127.0.0.1 --mcp-port 8081 --ghidra-server http://127.0.0.1:8080/

Das einzige erforderliche Argument ist der Transport. Wenn alle anderen Argumente nicht angegeben werden, verwenden sie die obigen Standardwerte. Sobald der MCP-Server läuft, öffne Cline und wähle oben MCP Servers aus.

Wähle dann Remote Servers und füge Folgendes hinzu. Achte darauf, dass die URL mit dem MCP-Host und -Port übereinstimmt:

1. Servername: GhidraMCP
2. Server-URL: http://127.0.0.1:8081/sse

Beispiel 3: 5ire

Ein weiterer MCP-Client, der mehrere Modelle auf dem Backend unterstützt, ist 5ire. Um GhidraMCP einzurichten, öffne 5ire und gehe zu Werkzeuge -> Neu und setze die folgenden Konfigurationen:

1. Werkzeugschlüssel: ghidra
2. Name: GhidraMCP
3. Befehl: python /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py

Erstellen aus dem Quellcode

1. Kopiere die folgenden Dateien aus deinem Ghidra-Verzeichnis in das lib/-Verzeichnis dieses Projekts:

• Ghidra/Features/Base/lib/Base.jar
• Ghidra/Features/Decompiler/lib/Decompiler.jar
• Ghidra/Framework/Docking/lib/Docking.jar
• Ghidra/Framework/Generic/lib/Generic.jar
• Ghidra/Framework/Project/lib/Project.jar
• Ghidra/Framework/SoftwareModeling/lib/SoftwareModeling.jar
• Ghidra/Framework/Utility/lib/Utility.jar
• Ghidra/Framework/Gui/lib/Gui.jar

2. Erstelle mit Maven durch Ausführen von:

mvn clean package assembly:single

Die generierte ZIP-Datei enthält das erstellte Ghidra-Plugin und seine Ressourcen. Diese Dateien werden benötigt, damit Ghidra die neue Erweiterung erkennt.

• lib/GhidraMCP.jar
• extensions.properties
• Module.manifest