Servidor Z-x64dbg-MCP

Servidor MCP x64dbg fusionado y optimizado - Combina lo mejor de duty1g/x64dbg-mcp-server (71 herramientas, Zig) y bromoket/x64dbg_mcp (23 mega-herramientas, TypeScript) en una plataforma unificada de ingeniería inversa de alto rendimiento.

🚀 Características

• Más de 71 herramientas MCP - Conjunto de herramientas unificado de ambas implementaciones

• Arquitectura dual - Zig (nativo, sin dependencias) + TypeScript (ecosistema npm)

• HTTP + SSE + stdio - Múltiples protocolos de transporte

• Soporte x32 y x64 - Cobertura completa del depurador

• Más de 22 devoluciones de llamada de eventos - Puntos de interrupción, memoria, trazas y eventos de depuración

• Puente API REST - Más de 151 endpoints para agentes de IA

• Integración con Claude Code - Ingeniería inversa impulsada por IA directamente

Related MCP server: x64dbg MCP Server

📦 Instalación

Instalación rápida (PowerShell)

# Clone the repository
git clone https://github.com/Zekiog/z-x64dbg-mcp.git
cd z-x64dbg-mcp

# Run the unified installer
.\install.ps1

Configuración manual

1. Instalar el complemento de x64dbg

• Copie plugin/z-x64dbg-mcp.dp32 a x32dbg/plugins/

• Copie plugin/z-x64dbg-mcp.dp64 a x64dbg/plugins/

2. Iniciar el servidor MCP

# Zig build (native, recommended)
zig build run

# Or TypeScript (npm ecosystem)
cd server
npm install
npm start

3. Configurar Claude Code

Añada a su claude_desktop_config.json:

{
  "mcpServers": {
    "z-x64dbg": {
      "command": "node",
      "args": ["/path/to/z-x64dbg-mcp/server/dist/index.js"],
      "env": {
        "X64DBG_HOST": "localhost",
        "X64DBG_PORT": "31964"
      }
    }
  }
}

🛠️ Categorías de herramientas

📊 Arquitectura

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   AI Client     │────▶│  MCP Server      │────▶│  x64dbg Plugin  │
│  (Claude Code)  │◀────│ (Zig/TypeScript) │◀────│  (C++ Bridge)   │
└─────────────────┘     └──────────────────┘     └─────────────────┘
         │                       │                        │
         │  MCP Protocol         │  REST API              │  Debugger
         │  (stdio/SSE/HTTP)     │  (localhost:31964)     │  Events

🔧 Desarrollo

Compilar desde el código fuente

Zig (nativo)

zig build
zig build run

TypeScript (servidor)

cd server
npm install
npm run build
npm start

Complemento (C++)

cd plugin
mkdir build && cd build
cmake .. -G "Visual Studio 17 2022"
cmake --build . --config Release

Pruebas

# Run test suite
npm test

# Integration tests
npm run test:integration

📖 Documentación

• Referencia completa de la API

• Especificaciones de herramientas

• Devoluciones de llamada de eventos

• Guía de solución de problemas

🤝 Créditos

Este proyecto fusiona y optimiza:

• duty1g/x64dbg-mcp-server - 71 herramientas, implementación en Zig

• bromoket/x64dbg_mcp - 23 mega-herramientas, servidor TypeScript

📄 Licencia

Licencia MIT - Consulte LICENSE para más detalles.

🌟 Demostración

Ejemplo: análisis de puntos de interrupción impulsado por IA

{
  "tool": "x64dbg.set_breakpoint",
  "arguments": {
    "address": "0x140001000",
    "type": "hardware",
    "condition": "rax == 0x42"
  }
}

Hecho con ❤️ por Zekiog | Informar de problemas