영어 | 中文

x64dbg 및 x32dbg용 모델 컨텍스트 프로토콜(MCP) 서버 구현으로, JSON-RPC 2.0 인터페이스를 통한 원격 디버깅을 가능하게 합니다. 이 플러그인은 외부 애플리케이션과 AI 에이전트가 디버거와 프로그래밍적으로 상호작용할 수 있도록 합니다.

이제 x64와 x86 아키텍처 모두를 지원합니다!

특징

• 완전한 MCP 사양 준수: 세 가지 핵심 MCP 빌딩 블록 모두를 구현함

• 도구 (79): AI 호출 가능한 디버깅 기능

• 리소스 (7 + 8 템플릿): 애플리케이션 제어 컨텍스트 데이터 소스

• 프롬프트 (10): 사용자 주도 디버깅 워크플로우 템플릿

• JSON-RPC 2.0 프로토콜: 표준, 언어 무립 인터페이스

• Streamable HTTP 전송(MCP 2025-03-26)이 /mcp에 제공되며, 구형 클라이언트를 위한 /sse에 레거시 HTTP+SSE가 제공됩니다

• 도구 - AI 제어 디버깅 (79개 기능):

• 실행 제어 (init/run/pause/step/run_to/restart/stop)

• 메모리 읽기/쓰기/검색/할당

• 레지스터 접근 권한 (GPR, SSE, AVX 포함 50+ 레지스터)

• 브레이크포인트 관리(소프트웨어, 하드웨어, 메모리, 조건문, 로깅)

• 분해 및 심볼 해석

• 스레드 관리 (리스트, 스위치, 일시 중지, 재개)

• 스택 추적 및 분석

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