调试器AI控制插件

为x64dbg提供MCP接口的插件,通过JSON-RPC 2.0协议实现AI助手对调试器的远程控制,支持多实例管理和完整调试工具集。

  • by HyperClockUp
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 HyperClockUp/AI-x64dbg-MCP

使用说明

AI-x64dbg-MCP

英语 | 中文


英语

x64dbg插件,为AI助手提供MCP(模型上下文协议)接口。

特性

  • MCP协议支持:通过HTTP上的JSON-RPC 2.0公开x64dbg调试功能
  • 多实例支持:通过单个路由器端口自动协调多个x64dbg实例(x32/x64)
  • 综合工具集:涵盖所有主要调试操作的12个工具类别

支持的工具

类别 描述
断点 设置、删除、启用/禁用断点
执行 运行、进入、跳过、暂停、停止
寄存器 读/写CPU寄存器
内存 读/写内存、分配、保护
Disasm 在地址处拆卸说明
符号 解析符号,获取模块信息
搜索 内存中的模式搜索
跟踪 指令跟踪
补丁 内存中的补丁字节/指令
脚本 执行x64dbg命令
堆栈 堆栈框架分析
进程 进程和线程信息

安装

  1. 下载自 发布
  2. 将插件复制到x64dbg-plugins文件夹:
    • x64dbg_mcp.dp64 → x64dbg/x64/plugins/
    • x32dbg_mcp.dp32 → x64dbg/x32/plugins/
  3. 重新启动x64dbg

用法

MCP端点

该插件在端口上启动HTTP服务器 13333 (可通过以下方式配置 X64DBG_MCP_PORT 环境变量)。

POST http://127.0.0.1:13333/mcp
Content-Type: application/json

示例请求

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

多实例模式

当多个x64dbg实例正在运行时:

  • 第一个实例变成 大师 并托管路由器
  • 其他实例注册为 奴隶
  • 所有请求都通过主机的路由器端口
  • 使用 client_id 目标特定实例的参数
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "client_id": "client_2",
    "name": "get_registers",
    "arguments": {}
  }
}

配置

变量 默认值 描述
X64DBG_MCP_PORT 13333 MCP请求的路由器端口

MCP客户端配置

克劳德桌面/光标/Kiro

{
  "mcpServers": {
    "x64dbg": {
      "url": "http://127.0.0.1:13333/mcp"
    }
  }
}

中文

为 x64dbg 提供 MCP (Model Context Protocol) 接口的插件,让 AI 助手可以直接控制调试器。

功能特性

  • MCP 协议支持:通过 HTTP JSON-RPC 2.0 暴露 x64dbg 调试功能
  • 多实例支持:自动协调多个 x64dbg 实例(x32/x64),通过单一路由端口访问
  • 完整工具集:12 个工具类别,覆盖所有主要调试操作

支持的工具

类别 描述
Breakpoint 设置、删除、启用/禁用断点
Execution 运行、单步步入、单步步过、暂停、停止
Register 读写 CPU 寄存器
Memory 读写内存、分配、保护
Disasm 反汇编指定地址的指令
Symbol 解析符号、获取模块信息
Search 内存模式搜索
Trace 指令追踪
Patch 修补内存中的字节/指令
Script 执行 x64dbg 命令
Stack 栈帧分析
Process 进程和线程信息

安装方法

  1. 从 发布 下载插件
  2. 复制插件文件到 x64dbg 插件目录:
    • x64dbg_mcp.dp64 → x64dbg/x64/plugins/
    • x32dbg_mcp.dp32 → x64dbg/x32/plugins/
  3. 重启 x64dbg

使用方法

MCP 端点

插件会在端口 13333 启动 HTTP 服务器(可通过 X64DBG_MCP_PORT 环境变量配置)。

POST http://127.0.0.1:13333/mcp
Content-Type: application/json

请求示例

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

多实例模式

当运行多个 x64dbg 实例时:

  • 第一个实例成为 大师,托管路由器
  • 后续实例注册为 奴隶
  • 所有请求通过 master 的路由端口
  • 使用 client_id 参数指定目标实例
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "client_id": "client_2",
    "name": "get_registers",
    "arguments": {}
  }
}

配置

环境变量 默认值 描述
X64DBG_MCP_PORT 13333 MCP 请求的路由端口

MCP 客户端配置

克劳德桌面/光标/Kiro

{
  "mcpServers": {
    "x64dbg": {
      "url": "http://127.0.0.1:13333/mcp"
    }
  }
}

许可证

专有-仅限二进制分发。

作者

HyperClockUp