Z-x64dbg-MCP Server

Zusammengeführt & optimierter x64dbg MCP Server - Kombiniert das Beste aus duty1g/x64dbg-mcp-server (71 Tools, Zig) und bromoket/x64dbg_mcp (23 Mega-Tools, TypeScript) zu einer einheitlichen, leistungsstarken Reverse-Engineering-Plattform.

🚀 Funktionen

• 71+ MCP Tools - Einheitliches Toolset aus beiden Implementierungen

• Dual Architecture - Zig (nativ, ohne Abhängigkeiten) + TypeScript (npm-Ökosystem)

• HTTP + SSE + stdio - Mehrere Transportprotokolle

• x32 & x64 Support - Vollständige Debugger-Abdeckung

• 22+ Event Callbacks - Breakpoint-, Speicher-, Trace- und Debug-Ereignisse

• REST API Bridge - 151+ Endpunkte für KI-Agenten

• Claude Code Integration - Direkte KI-gestützte Reverse Engineering

Related MCP server: x64dbg MCP Server

📦 Installation

Schnellinstallation (PowerShell)

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

# Run the unified installer
.\install.ps1

Manuelle Einrichtung

1. x64dbg-Plugin installieren

• Kopieren Sie plugin/z-x64dbg-mcp.dp32 nach x32dbg/plugins/

• Kopieren Sie plugin/z-x64dbg-mcp.dp64 nach x64dbg/plugins/

2. MCP-Server starten

# Zig build (native, recommended)
zig build run

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

3. Claude Code konfigurieren

Fügen Sie zu Ihrer claude_desktop_config.json hinzu:

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

🛠️ Tool-Kategorien

📊 Architektur

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

🔧 Entwicklung

Aus dem Quellcode erstellen

Zig (nativ)

zig build
zig build run

TypeScript (Server)

cd server
npm install
npm run build
npm start

Plugin (C++)

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

Testen

# Run test suite
npm test

# Integration tests
npm run test:integration

📖 Dokumentation

• Vollständige API-Referenz

• Tool-Spezifikationen

• Ereignis-Callbacks

• Fehlerbehebungsanleitung

🤝 Danksagungen

Dieses Projekt vereint und optimiert:

• duty1g/x64dbg-mcp-server - 71 Tools, Zig-Implementierung

• bromoket/x64dbg_mcp - 23 Mega-Tools, TypeScript-Server

📄 Lizenz

MIT-Lizenz – Siehe LICENSE für Details.

🌟 Showcase

Beispiel: KI-gestützte Breakpoint-Analyse

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

Erstellt mit ❤️ von Zekiog | Probleme melden