
ghidra-mcp v6.0.0
Servidor MCP que conecta la ingeniería inversa de Ghidra con herramientas de IA: 256 herramientas para descompilación, emulación P-code, depuración en vivo, análisis de flujo de datos, operaciones por lotes y aplicación de convenciones en modos headless y GUI.
Servidor MCP de Ghidra
Si te resulta útil, por favor dale una ⭐ al repositorio — ¡ayuda a que otros lo descubran!
Si Ghidra MCP te ahorra tiempo, considera patrocinar el proyecto. Tanto el apoyo puntual como el recurrente ayudan a financiar las actualizaciones de compatibilidad, el endurecimiento para producción, la documentación y las nuevas herramientas.
Un servidor Model Context Protocol (MCP) listo para producción que conecta las potentes capacidades de ingeniería inversa de Ghidra con herramientas de IA modernas y frameworks de automatización. 219 herramientas MCP, flujos de trabajo de IA probados en batalla y la integración Ghidra-MCP más completa disponible — ahora incluyendo emulación de P-code, integración con depurador en vivo y análisis de flujo de datos mediante grafos PCode.
Inicio rápido: instalar una versión publicada (sin clonar, sin compilar)
Cada versión publicada incluye las dos
piezas que necesitas: la extensión de Ghidra (GhidraMCP-<version>.zip) y el puente
MCP (ghidra_mcp_bridge-<version>-py3-none-any.whl).
-
Instala los requisitos previos: Ghidra 12.2, Java 25 y uv. La extensión solo se carga en la versión exacta de Ghidra para la que fue compilada.
-
Instala la extensión: en la ventana del proyecto de Ghidra, File > Install Extensions, haz clic en +, selecciona el
GhidraMCP-<version>.zipque descargaste y reinicia Ghidra. -
Habilita el plugin: en la ventana del proyecto, File > Configure > Utility > Configure, marca GhidraMCPPlugin. Comprueba que responde:
curl http://127.0.0.1:8089/check_connection # {"status": "ok", "server_kind": "gui", "version": "7.0.0"} -
Instalar el puente (copie el enlace del wheel desde la misma página de la versión):
uv tool install https://github.com/bethington/ghidra-mcp/releases/download/v7.0.0/ghidra_mcp_bridge-7.0.0-py3-none-any.whl -
Apunte su cliente MCP hacia él, usando la ruta absoluta (
which bridge-mcp-ghidra, owhere.exe bridge-mcp-ghidraen Windows):{ "mcpServers": { "ghidra-mcp": { "command": "/home/<you>/.local/bin/bridge-mcp-ghidra" } } }En Windows:
"command": "C:\\Users\\<you>\\.local\\bin\\bridge-mcp-ghidra.exe". Un cliente lanzado desde una GUI o un servicio no ve el PATH de tu shell, por lo que unbridge-mcp-ghidrasin ruta falla conspawn ENOENT.
Abre un programa en Ghidra y pide a tu herramienta de IA que liste sus funciones. Capturas de pantalla de los pasos 2-3: docs/INSTALL_GUI.md. La compilación desde el código fuente, Docker, los transportes HTTP y todas las opciones de bridge se explican más abajo.
¿Qué versión debería ejecutar? Las versiones etiquetadas (7.0.0, 7.1.0, ...) son
estables. Las versiones candidatas y main son beta: con todas las funciones y probadas en vivo, pero las formas aún pueden cambiar antes de la versión final. dev es experimental:
las herramientas se fusionan, renombran y refactorizan allí libremente, así que no construyas nada sobre su
API.
¿Por qué Ghidra MCP?
La mayoría de las implementaciones de Ghidra MCP te ofrecen un puñado de herramientas de solo lectura y ya está. Este proyecto es diferente: fue creado por un ingeniero inverso que lo usa a diario en binarios reales, no como una demo.
- 219 herramientas MCP — 3 veces más que cualquier implementación competidora. No solo operaciones de lectura: acceso completo de escritura para renombrar, tipar, comentar, crear estructuras, ejecutar scripts, emulación de P-code y depuración en vivo.
- Flujos de trabajo de IA probados en batalla — Flujos de documentación probados (V5) refinados a lo largo de cientos de funciones. Incluye prompts paso a paso, referencia de notación húngara, guías de procesamiento por lotes y descubrimiento de código huérfano.
- Fiabilidad de nivel de producción — Transacciones atómicas, operaciones por lotes (93% de reducción en llamadas a la API), tiempos de espera configurables y manejo de errores elegante. Sin fallos silenciosos.
- Transferencia de documentación entre binarios — La coincidencia de hash de función SHA-256 propaga la documentación entre versiones de binarios automáticamente. Documenta una vez, aplica en todas partes.
- Integración completa con Ghidra Server — Conéctate a servidores Ghidra compartidos, gestiona repositorios, control de versiones, flujos de checkout/checkin y colaboración multiusuario.
- Modos headless y GUI — Ejecuta con o sin la GUI de Ghidra. Listo para Docker en pipelines de CI/CD y análisis automatizado a escala.
- Con criterio por diseño — v5.0 traslada las convenciones de nomenclatura, la seguridad de tipos y los estándares de documentación a la capa de herramientas. Los agentes de IA y los ingenieros humanos producen resultados consistentes sin guías de estilo en cada prompt.