
ghidra-mcp v6.0.0
Server MCP che collega il reverse engineering di Ghidra con strumenti AI: 256 strumenti per decompilazione, emulazione P-code, debugging live, analisi del flusso di dati, operazioni batch e applicazione delle convenzioni in modalità headless e GUI.
Ghidra MCP Server
Se lo trovi utile, aggiungi una ⭐ al repository — aiuta gli altri a scoprirlo!
Se Ghidra MCP ti fa risparmiare tempo, valuta di sponsorizzare il progetto. Il supporto una tantum e quello ricorrente aiutano entrambi a finanziare gli aggiornamenti di compatibilità, l'irrobustimento per la produzione, la documentazione e i nuovi strumenti.
Un server Model Context Protocol (MCP) pronto per la produzione che collega le potenti capacità di reverse engineering di Ghidra con i moderni strumenti di AI e i framework di automazione. 219 strumenti MCP, flussi di lavoro AI collaudati sul campo e l'integrazione Ghidra-MCP più completa disponibile — ora con emulazione P-code, integrazione con il debugger live e analisi del flusso di dati tramite grafo PCode.
Avvio rapido: installare una release (senza clonare, senza compilare)
Ogni release include i due
componenti necessari: l'estensione Ghidra (GhidraMCP-<version>.zip) e il bridge
MCP (ghidra_mcp_bridge-<version>-py3-none-any.whl).
-
Installa i prerequisiti: Ghidra 12.2, Java 25 e uv. L'estensione si carica solo nella versione esatta di Ghidra per cui è stata compilata.
-
Installa l'estensione: nella finestra del progetto di Ghidra, File > Install Extensions, fai clic su +, seleziona il file
GhidraMCP-<version>.zipche hai scaricato e riavvia Ghidra. -
Abilita il plugin: nella finestra del progetto, File > Configure > Utility > Configure, spunta GhidraMCPPlugin. Verifica che risponda:
curl http://127.0.0.1:8089/check_connection # {"status": "ok", "server_kind": "gui", "version": "7.0.0"} -
Installa il bridge (copia il link del wheel dalla stessa pagina di rilascio):
uv tool install https://github.com/bethington/ghidra-mcp/releases/download/v7.0.0/ghidra_mcp_bridge-7.0.0-py3-none-any.whl -
Punta il tuo client MCP su di esso, usando il percorso assoluto (
which bridge-mcp-ghidra, oppurewhere.exe bridge-mcp-ghidrasu Windows):{ "mcpServers": { "ghidra-mcp": { "command": "/home/<you>/.local/bin/bridge-mcp-ghidra" } } }Su Windows:
"command": "C:\\Users\\<you>\\.local\\bin\\bridge-mcp-ghidra.exe". Un client avviato da una GUI o da un servizio non vede il PATH della tua shell, quindi un semplicebridge-mcp-ghidrafallisce conspawn ENOENT.
Apri un programma in Ghidra e chiedi al tuo strumento AI di elencarne le funzioni. Screenshot dei passaggi 2-3: docs/INSTALL_GUI.md. Compilazione dal sorgente, Docker, i trasporti HTTP e ogni flag del bridge sono più in basso.
Quale versione dovrei eseguire? Le release con tag (7.0.0, 7.1.0, ...) sono
stabili. Le release candidate e main sono beta: complete nelle funzionalità e
testate dal vivo, ma le forme possono ancora cambiare prima della versione finale. dev è sperimentale:
gli strumenti vengono uniti, rinominati e rifattorizzati liberamente lì, quindi non costruire nulla sulla sua
API.
Perché Ghidra MCP?
La maggior parte delle implementazioni di Ghidra MCP ti offre una manciata di strumenti di sola lettura e finisce lì. Questo progetto è diverso — è stato creato da un reverse engineer che lo usa quotidianamente su binari reali, non come una demo.
- 219 strumenti MCP — 3 volte più di qualsiasi implementazione concorrente. Non solo operazioni di lettura — accesso completo in scrittura per rinominare, tipizzare, commentare, creare strutture, eseguire script, emulazione P-code e debug live.
- Workflow AI collaudati — Workflow di documentazione comprovati (V5) perfezionati su centinaia di funzioni. Include prompt passo-passo, riferimento alla notazione ungherese, guide all'elaborazione batch e scoperta di codice orfano.
- Affidabilità di livello produttivo — Transazioni atomiche, operazioni batch (riduzione del 93% delle chiamate API), timeout configurabili e gestione degli errori elegante. Nessun fallimento silenzioso.
- Trasferimento di documentazione tra binari — La corrispondenza tramite hash di funzione SHA-256 propaga automaticamente la documentazione tra versioni del binario. Documenta una volta, applica ovunque.
- Integrazione completa con Ghidra Server — Connettiti a server Ghidra condivisi, gestisci repository, controllo di versione, workflow di checkout/checkin e collaborazione multiutente.
- Modalità headless e GUI — Esegui con o senza la GUI di Ghidra. Pronto per Docker per pipeline CI/CD e analisi automatizzata su larga scala.
- Opinionato per design — La v5.0 sposta le convenzioni di denominazione, la sicurezza dei tipi e gli standard di documentazione nel livello degli strumenti. Gli agenti AI e gli ingegneri umani producono output coerenti senza guide di stile in ogni prompt.
Applicazione delle convenzioni
Ci sei già passato: sei mesi dentro un progetto e trovi ProcessItem, process_items, handleItem e ItemProc nello stesso codebase — quattro funzioni che fanno la stessa cosa, nominate da quattro sessioni o ingegneri diversi senza un contratto condiviso. Sistemarlo richiede più tempo del dovuto, e il problema si ripresenterà.