Z-x64dbg-MCP Server

Объединённый и оптимизированный x64dbg MCP Server — объединяет лучшее из duty1g/x64dbg-mcp-server (71 инструмент, Zig) и bromoket/x64dbg_mcp (23 мега-инструмента, TypeScript) в единую высокопроизводительную платформу для реверс-инжиниринга.

🚀 Возможности

• 71+ MCP-инструментов — Единый набор инструментов из обеих реализаций

• Двойная архитектура — Zig (нативный, без зависимостей) + TypeScript (экосистема npm)

• HTTP + SSE + stdio — Несколько транспортных протоколов

• Поддержка x32 и x64 — Полное покрытие отладчика

• 22+ событийных обратных вызовов — События точек останова, памяти, трассировки и отладки

• REST API Bridge — 151+ конечная точка для AI-агентов

• Интеграция с Claude Code — Прямой реверс-инжиниринг с помощью ИИ

Related MCP server: x64dbg MCP Server

📦 Установка

Быстрая установка (PowerShell)

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

# Run the unified installer
.\install.ps1

Ручная настройка

1. Установка плагина x64dbg

• Скопируйте plugin/z-x64dbg-mcp.dp32 в x32dbg/plugins/

• Скопируйте plugin/z-x64dbg-mcp.dp64 в x64dbg/plugins/

2. Запуск MCP-сервера

# Zig build (native, recommended)
zig build run

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

3. Настройка Claude Code

Добавьте в ваш 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"
      }
    }
  }
}

🛠️ Категории инструментов

📊 Архитектура

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

🔧 Разработка

Сборка из исходников

Zig (нативный)

zig build
zig build run

TypeScript (сервер)

cd server
npm install
npm run build
npm start

Плагин (C++)

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

Тестирование

# Run test suite
npm test

# Integration tests
npm run test:integration

📖 Документация

• Полная справка по API

• Спецификации инструментов

• Событийные обратные вызовы

• Руководство по устранению неполадок

🤝 Благодарности

Этот проект объединяет и оптимизирует:

• duty1g/x64dbg-mcp-server — 71 инструмент, реализация на Zig

• bromoket/x64dbg_mcp — 23 мега-инструмента, сервер на TypeScript

📄 Лицензия

Лицензия MIT — см. LICENSE для подробностей.

🌟 Демонстрация

Пример: анализ точек останова с помощью ИИ

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

Создано с ❤️ Zekiog | Сообщить о проблемах