英語 |中文

x64dbgおよびx32dbg向けのモデルコンテキストプロトコル(MCP)サーバー実装で、JSON-RPC 2.0インターフェースを通じたリモートデバッグを可能にします。このプラグインにより、外部アプリケーションやAIエージェントがデバッガとプログラム的にやり取りできます。

現在はx64とx86の両方のアーキテクチャをサポートしています!

特徴

• 完全なMCP仕様準拠:3つのMCPコアビルディングブロックすべてを実装

• ツール(79):AI呼び出し可能なデバッグ機能

• リソース(7 + 8テンプレート):アプリケーション制御コンテキストデータソース

• プロンプト(10):ユーザー主導のデバッグワークフローテンプレート

• JSON-RPC 2.0 プロトコル:標準的で言語に依存しないインターフェース

• Streamable HTTP トランスポート(MCP 2025-03-26)は/mcpで、さらに古いクライアント向けのレガシーHTTP+SSEは/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