ghidraMCP

ghidraMCP est un serveur Model Context Protocol permettant aux LLM de rétro-ingénierer des applications de manière autonome. Il expose de nombreux outils issus des fonctionnalités principales de Ghidra aux clients MCP.

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

Fonctionnalités

Serveur MCP + Plugin Ghidra

• Décompiler et analyser des binaires dans Ghidra
• Renommer automatiquement les méthodes et les données
• Lister les méthodes, classes, imports et exports

Installation

Prérequis

• Installer Ghidra
• Python3
• SDK MCP

Ghidra

Téléchargez d'abord la dernière version de ce dépôt. Celle-ci contient le plugin Ghidra et le client Python MCP. Ensuite, vous pouvez importer directement le plugin dans Ghidra.

1. Lancer Ghidra
2. Sélectionner File -> Install Extensions
3. Cliquer sur le bouton +
4. Sélectionner le fichier GhidraMCP-1-2.zip (ou la version de votre choix) dans la version téléchargée
5. Redémarrer Ghidra
6. S'assurer que le plugin GhidraMCPPlugin est activé dans File -> Configure -> Developer
7. Optionnel : Configurer le port dans Ghidra avec Edit -> Tool Options -> GhidraMCP HTTP Server

Guide d'installation vidéo :

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

Clients MCP

Théoriquement, tout client MCP devrait fonctionner avec ghidraMCP. Trois exemples sont donnés ci-dessous.

Exemple 1 : Claude Desktop

Pour configurer Claude Desktop en tant que client MCP Ghidra, allez dans Claude -> Settings -> Developer -> Edit Config -> claude_desktop_config.json et ajoutez ce qui suit :

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

Alternativement, éditez ce fichier directement :

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

L'IP et le port du serveur sont configurables et doivent être définis pour pointer vers l'instance Ghidra cible. S'ils ne sont pas définis, les deux prendront par défaut localhost:8080.

Exemple 2 : Cline

Pour utiliser GhidraMCP avec Cline, cela nécessite également de lancer manuellement le serveur MCP. Exécutez d'abord la commande suivante :

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

Le seul argument requis est le transport. Si tous les autres arguments ne sont pas spécifiés, ils prendront les valeurs par défaut ci-dessus. Une fois le serveur MCP en cours d'exécution, ouvrez Cline et sélectionnez MCP Servers en haut.

Ensuite, sélectionnez Remote Servers et ajoutez ce qui suit, en vous assurant que l'URL correspond à l'hôte et au port MCP :

1. Nom du serveur : GhidraMCP
2. URL du serveur : http://127.0.0.1:8081/sse

Exemple 3 : 5ire

Un autre client MCP qui prend en charge plusieurs modèles en backend est 5ire. Pour configurer GhidraMCP, ouvrez 5ire et allez dans Tools -> New et définissez les configurations suivantes :

1. Clé d'outil : ghidra
2. Nom : GhidraMCP
3. Commande : python /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py

Construction à partir des sources

1. Copiez les fichiers suivants depuis votre répertoire Ghidra vers le répertoire lib/ de ce projet :

• 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. Construisez avec Maven en exécutant :

mvn clean package assembly:single

Le fichier zip généré inclut le plugin Ghidra compilé et ses ressources. Ces fichiers sont nécessaires pour que Ghidra reconnaisse la nouvelle extension.

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