# Instrucciones para el agente: GhidraMCP: conecta tu agente con el análisis de binarios

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/LaurieWired/GhidraMCP (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/ghidra-mcp-analysis

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba que tienes Ghidra 12.1.4 y uv/uvx con Python ≥3.10. Importa el ZIP de la extensión desde File → Install Extensions, reinicia Ghidra y activa GhidraMCPPlugin en File → Configure → Developer, como indica el README. Abre un binario de prueba. El servidor HTTP MCP se inicia con el comando documentado:

```sh
uvx --from git+https://github.com/LaurieWired/GhidraMCP ghidra-mcp --transport streamable-http --mcp-host 127.0.0.1 --mcp-port 8081 --ghidra-server http://127.0.0.1:8080/
```

Añade `http://127.0.0.1:8081/mcp` como servidor remoto en tu cliente, según el README.

## Comprobación

Comprueba que puedes consultar una función visible en Ghidra y que sus direcciones coinciden. Empieza por lectura antes de permitir anotaciones.

## Si algo falla

Si no conecta, comprueba la extensión y la dirección del servicio de Ghidra. Si una operación no existe, revisa la versión de la integración.

Consulta [el README oficial](https://github.com/LaurieWired/GhidraMCP#readme) para requisitos y variantes de instalación.
