Servidor MCP que conecta a engenharia reversa do Ghidra com ferramentas de IA: 256 ferramentas para decompilação, emulação P-code, depuração ao vivo, análise de fluxo de dados, operações em lote e aplicação de convenções nos modos headless e GUI.
Se você achar isto útil, por favor ⭐ dê uma estrela no repositório — isso ajuda outras pessoas a descobri-lo!
Se o Ghidra MCP economiza seu tempo, considere patrocinar o projeto. Apoios únicos e recorrentes ajudam a financiar atualizações de compatibilidade, endurecimento para produção, documentação e novas ferramentas.
Um servidor Model Context Protocol (MCP) pronto para produção que conecta os poderosos recursos de engenharia reversa do Ghidra com ferramentas modernas de IA e frameworks de automação. 219 ferramentas MCP, fluxos de trabalho de IA testados em batalha e a integração Ghidra-MCP mais abrangente disponível — agora incluindo emulação P-code, integração com depurador ao vivo e análise de fluxo de dados por grafo PCode.
Cada release inclui as duas
peças necessárias: a extensão do Ghidra (GhidraMCP-<version>.zip) e a ponte
MCP (ghidra_mcp_bridge-<version>-py3-none-any.whl).
Instale os pré-requisitos: Ghidra 12.2, Java 25 e uv. A extensão só carrega na versão exata do Ghidra para a qual foi compilada.
Instale a extensão: na janela de projeto do Ghidra, File > Install
Extensions, clique em +, selecione o GhidraMCP-<version>.zip que você baixou,
e reinicie o Ghidra.
Ative o plugin: na janela de projeto, File > Configure > Utility > Configure, marque GhidraMCPPlugin. Verifique se ele responde:
curl http://127.0.0.1:8089/check_connection
# {"status": "ok", "server_kind": "gui", "version": "7.0.0"}
Instale o bridge (copie o link do wheel da mesma página de release):
uv tool install https://github.com/bethington/ghidra-mcp/releases/download/v7.0.0/ghidra_mcp_bridge-7.0.0-py3-none-any.whl
Aponte seu cliente MCP para ele, usando o caminho absoluto (which bridge-mcp-ghidra, ou where.exe bridge-mcp-ghidra no Windows):
{
"mcpServers": {
"ghidra-mcp": { "command": "/home/<you>/.local/bin/bridge-mcp-ghidra" }
}
}
No Windows: "command": "C:\\Users\\<you>\\.local\\bin\\bridge-mcp-ghidra.exe".
Um cliente iniciado a partir de uma GUI ou de um serviço não vê o PATH do seu shell,
portanto um bridge-mcp-ghidra simples falha com spawn ENOENT.
Abra um programa no Ghidra e peça à sua ferramenta de IA para listar suas funções. Capturas de tela das etapas 2-3: docs/INSTALL_GUI.md. Compilação a partir do código-fonte, Docker, os transportes HTTP e todas as flags do bridge estão mais abaixo.
Qual versão devo executar? As versões marcadas com tag (7.0.0, 7.1.0, ...) são
estáveis. As release candidates e a main são beta: completas em recursos e
testadas ao vivo, mas as formas ainda podem mudar antes da versão final. A dev é experimental:
as ferramentas são mescladas, renomeadas e refatoradas ali livremente, então não construa nada sobre sua
API.
A maioria das implementações de Ghidra MCP oferece um punhado de ferramentas somente leitura e para por aí. Este projeto é diferente — foi construído por um engenheiro reverso que o usa diariamente em binários reais, não como uma demonstração.
Você já passou por isso: seis meses dentro de um projeto você encontra ProcessItem, process_items, handleItem e ItemProc na mesma base de código — quatro funções fazendo a mesma coisa, nomeadas por quatro sessões ou engenheiros diferentes sem um contrato compartilhado. Corrigir isso leva mais tempo do que deveria, e o problema vai acontecer de novo.