Английский | 中文

Реализация сервера Model Context Protocol (MCP) для x64dbg и x32dbg, позволяющая удалённую отладку через интерфейс JSON-RPC 2.0. Этот плагин позволяет внешним приложениям и AI-агентам программно взаимодействовать с отладчиком.

Теперь поддерживает архитектуры x64 и x86!

Особенности

• Полное соответствие спецификациям MCP: реализует все три основных строительных блока MCP

• Tools (79): Функции отладки, вызываемые ИИ

• Ресурсы (7 + 8 шаблонов): Источники контекстных данных, управляемые приложением

• Подсказки (10): Шаблоны рабочих процессов отладки, управляемые пользователем

• JSON-RPC 2.0 Protocol: стандартный, языково-независимый интерфейс

• Потоковый HTTP-транспорт (MCP 2025-03-26) на /mcp, плюс устаревший HTTP+SSE на /sse для старых клиентов

• Инструменты — отладка с управлением ИИ (79 функций):

• Управление выполнением (init/run/pause/step/run_to/restart/stop)

• Чтение/запись/поиск/выделение памяти

• Доступ к регистрам (50+ регистров, включая GPR, SSE, AVX)

• Управление точками остановки (программное, аппаратное, память, условное, логирование)

• Разборка и разрешение символов

• Управление потоками (список, переключение, приостановка, возобновление)

• Трассировка стека и анализ

x64dbg MCP Server Plugin

English | 中文

A Model Context Protocol (MCP) server implementation for x64dbg and x32dbg, enabling remote debugging through a JSON-RPC 2.0 interface. This plugin allows external applications and AI agents to interact with the debugger programmatically.

Now supports both x64 and x86 architectures!

Features

• Full MCP Specification Compliance: Implements all three core MCP building blocks

  • Tools (79): AI-invokable debugging functions
  • Resources (7 + 8 templates): Application-controlled context data sources
  • Prompts (10): User-guided debugging workflow templates

• JSON-RPC 2.0 Protocol: Standard, language-agnostic interface

• Streamable HTTP transport (MCP 2025-03-26) on /mcp, plus legacy HTTP+SSE on /sse for older clients

• Tools - AI-Controlled Debugging (79 functions):

  • Execution control (init/run/pause/step/run_to/restart/stop)
  • Memory read/write/search/allocate
  • Register access (50+ registers including GPR, SSE, AVX)
  • Breakpoint management (software, hardware, memory, conditional, logging)
  • Disassembly and symbol resolution
  • Thread management (list, switch, suspend, resume)
  • Stack trace and analysis
  • Dump & Analysis (module dump, memory dump, packer detection, OEP detection)
  • Script execution (execute x64dbg/x32dbg commands, batch operations)
  • Context snapshots (capture and compare debugging state)

• Resources - Context Providers (7 direct + 8 templates):

  • Direct resources: debugger state, registers, modules, threads, memory map, breakpoints, stack
  • Resource templates: memory content, disassembly, module info, symbol resolution, function analysis
  • Read-only, application-controlled access

• Prompts - Workflow Templates (10 prompts):

  • Crash analysis, vulnerability hunting, function tracing
  • Binary unpacking, algorithm reversing, execution comparison
  • String hunting, code patching, API monitoring
  • Debug session initialization

• Security: Permission-based access control

• Extensible: Plugin architecture for custom methods, resources, and prompts

Prerequisites

• Windows 10/11 (64-bit host; supports building both x64 and x86 plugins)
• CMake 3.15 or higher
• Visual Studio 2022 with C++ Desktop Development workload
• vcpkg - Package manager for C++ libraries
• Git - For cloning the repository

Quick Build

The easiest way to build is using the provided build script:

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

# Build both x64 and x86 architectures (recommended)
.\build.bat

# Build only x64 architecture
.\build.bat --x64-only

# Build only x86 architecture
.\build.bat --x86-only

# Clean rebuild
.\build.bat --clean

# The script will:
# 1. Automatically detect vcpkg installation
# 2. Download dependencies (nlohmann_json)
# 3. Configure CMake for both architectures