Servidor MCP para Ghidra

• Descompilar e analisar binários no Ghidra
• Renomear automaticamente métodos e dados
• Listar métodos, classes, imports e exports

Instalação

Pré-requisitos

• Instale o Ghidra
• Python3
• MCP SDK

Ghidra

Primeiro, baixe a release mais recente deste repositório. Ela contém o plugin do Ghidra e o cliente MCP Python. Em seguida, você pode importar o plugin diretamente no Ghidra.

1. Execute o Ghidra
2. Selecione File -> Install Extensions
3. Clique no botão +
4. Selecione o GhidraMCP-1-2.zip (ou a versão de sua escolha) na release baixada
5. Reinicie o Ghidra
6. Certifique-se de que o GhidraMCPPlugin está habilitado em File -> Configure -> Developer
7. Opcional: Configure a porta no Ghidra com Edit -> Tool Options -> GhidraMCP HTTP Server

Guia de Instalação em Vídeo:

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

Clientes MCP

Teoricamente, qualquer cliente MCP deve funcionar com o ghidraMCP. Três exemplos são fornecidos abaixo.

Exemplo 1: Claude Desktop

Para configurar o Claude Desktop como cliente MCP do Ghidra, vá para Claude -> Settings -> Developer -> Edit Config -> claude_desktop_config.json e adicione o seguinte:

Como alternativa, edite este arquivo diretamente:

O IP e a porta do servidor são configuráveis e devem ser definidos para apontar para a instância do Ghidra de destino. Se não forem definidos, ambos usarão o padrão localhost:8080.

Exemplo 2: Cline

Para usar o GhidraMCP com o Cline, é necessário também executar o servidor MCP manualmente. Primeiro, execute o seguinte comando:

O único argumento obrigatório é o transporte. Se todos os outros argumentos não forem especificados, eles usarão os valores padrão acima. Quando o servidor MCP estiver em execução, abra o Cline e selecione MCP Servers no topo.

Em seguida, selecione Remote Servers e adicione o seguinte, garantindo que a url corresponda ao host e à porta do MCP:

1. Nome do Servidor: GhidraMCP
2. URL do Servidor: http://127.0.0.1:8081/sse

Exemplo 3: 5ire

Outro cliente MCP que suporta múltiplos modelos no backend é o 5ire. Para configurar o GhidraMCP, abra o 5ire e vá para Tools -> New e defina as seguintes configurações:

1. Tool Key: ghidra
2. Nome: GhidraMCP
3. Comando: python /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py

Compilando a partir do Código-Fonte

1. Copie os seguintes arquivos do seu diretório do Ghidra para o diretório lib/ deste projeto:

• 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. Compile com o Maven executando:

mvn clean package assembly:single

O arquivo zip gerado inclui o plugin Ghidra compilado e seus recursos. Esses arquivos são necessários para que o Ghidra reconheça a nova extensão.

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