ph4ntom IDA Bridge 🌉

Capa de control autónoma de IA y MCP para IDA Pro 9.x
Convierte IDA Pro en una potente herramienta de ingeniería inversa agéntica. Conecta Claude Desktop, Cursor, Antigravity o agentes LLM personalizados mediante Model Context Protocol (MCP) o una API REST de alto rendimiento.

---

              ┌─────────────────────────────────────────────────────────┐
              │                       IDA Pro 9.x                       │
              │         ph4ntom_ida_bridge.py (102 REST Endpoints)      │
              │         127.0.0.1:13370 (Bearer Token Protected)        │
              └────────────────────────────┬────────────────────────────┘
                                           │ REST / JSON / SSE
          ┌────────────────────────────────┼───────────────────────────────┐
          ▼                                ▼                               ▼
   ┌───────────────┐               ┌───────────────┐               ┌───────────────┐
   │  MCP Server   │               │   CLI / SDK   │               │   AI Agents   │
   │  54 Tools     │               │  `ph4ntom-ida`│               │  Multi-LLM    │
   │  Claude       │               │  Automation   │               │  Gemini       │
   │  Cursor       │               │  Headless     │               │  Ollama       │
   │  Antigravity  │               │  Testing      │               │  Claude / GPT │
   └───────────────┘               └───────────────┘               └───────────────┘

ph4ntom IDA Bridge es una capa de control exclusiva para localhost para IDA Pro 9.x. Combina un plugin de IDA autocontenido, una API REST JSON, un cliente de Python, una CLI, 54 herramientas MCP nativas y backends de IA independientes opcionales.

La versión 6.2.0 aporta compatibilidad total con IDA 9.3, mutaciones atómicas de la base de datos, autenticación de tokens en tiempo constante, seguimiento de cursores SSE y cobertura completa de la suite de pruebas.

---

⚡ Inicio rápido: Claude Desktop y Cursor (configuración MCP en 1 clic)

Conecta Claude Desktop, Cursor o cualquier cliente MCP a tu instancia de IDA Pro en ejecución en 60 segundos:

1. Clonar e instalar

git clone https://github.com/ph4ntom-rev/ph4ntom-ida-bridge.git
cd ph4ntom-ida-bridge
python -m pip install -e ".[mcp]"

2. Instalar el plugin en IDA Pro

python cli.py install-plugin --ida-dir "C:\Program Files\IDA Professional 9.0"

(O copia ida_plugin/ph4ntom_ida_bridge.py y api_schema.json directamente en tu directorio plugins/ de IDA).

3. Añadir a tu configuración de MCP

🟣 Claude Desktop

Edita %APPDATA%\Claude\claude_desktop_config.json (Windows) o ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "ida-bridge": {
      "command": "python",
      "args": [
        "C:/path/to/ph4ntom-ida-bridge/mcp_server.py"
      ]
    }
  }
}

💻 Cursor / Windsurf

Añade a .cursor/mcp.json o Cursor Settings → MCP:

{
  "mcpServers": {
    "ida-bridge": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "cwd": "C:/path/to/ph4ntom-ida-bridge"
    }
  }
}

Inicie IDA Pro, presione Ctrl+Shift+A para alternar el servidor y solicite a su asistente de IA:

"Inspeccione la función en 0x140001000. Rastree las referencias cruzadas, analice el microcódigo, descompile a pseudocódigo C y renombre las variables ofuscadas con nombres significativos."

---

⚔️ Comparación con alternativas

Característica	ph4ntom IDA Bridge	Gepetto / IDAGPT	Hex-Rays Copilot
Arquitectura	MCP bidireccional + REST + CLI	Envoltorio de prompt único	Plugin de UI propietario
Cantidad de herramientas	54 herramientas MCP granulares	1 (prompt de descompilación)	Acciones de prompt fijas
AST y flujo de control	AST ctree completo + Microcode IR (0-7)	Solo texto de pseudocódigo	Solo texto de pseudocódigo
Mutaciones seguras	Mutaciones por lotes atómicas con rollback	Solo inserción de comentarios	Sugerencias en la UI
Depurador en vivo	Registros, pila, memoria, puntos de interrupción	No	No
Ejecución dinámica	Motor de ejecución IDAPython al vuelo	No	No
LLMs compatibles	Cualquier cliente MCP / Claude / GPT / Gemini / Ollama	Solo API de OpenAI	Nube propietaria
Seguridad y autenticación	Solo localhost, token de 256 bits, DACL de propietario	Clave de API expuesta en texto plano	Propietario
Compatibilidad con IDA Pro 9.3	Verificado y totalmente probado	Roto en IDA 9+	Oficial

---

🛠️ Referencia de herramientas MCP (54 herramientas y 2 recursos)

El servidor MCP expone 54 herramientas diseñadas específicamente para 7 dominios de ingeniería inversa: