AI-x64dbg-MCP
英语 | 中文
英语
x64dbg插件，为AI助手提供MCP（模型上下文协议）接口。
特性
- MCP协议支持：通过HTTP上的JSON-RPC 2.0公开x64dbg调试功能
- 多实例支持：通过单个路由器端口自动协调多个x64dbg实例（x32/x64）
- 综合工具集：涵盖所有主要调试操作的12个工具类别
支持的工具
| 类别 | 描述 |
|---|---|
| 断点 | 设置、删除、启用/禁用断点 |
| 执行 | 运行、进入、跳过、暂停、停止 |
| 寄存器 | 读/写CPU寄存器 |
| 内存 | 读/写内存、分配、保护 |
| Disasm | 在地址处拆卸说明 |
| 符号 | 解析符号，获取模块信息 |
| 搜索 | 内存中的模式搜索 |
| 跟踪 | 指令跟踪 |
| 补丁 | 内存中的补丁字节/指令 |
| 脚本 | 执行x64dbg命令 |
| 堆栈 | 堆栈框架分析 |
| 进程 | 进程和线程信息 |
安装
- 下载自 发布
- 将插件复制到x64dbg-plugins文件夹：
-x64dbg_mcp.dp64→x64dbg/x64/plugins/
-x32dbg_mcp.dp32→x64dbg/x32/plugins/ - 重新启动x64dbg
用法
MCP端点
该插件在端口上启动HTTP服务器 13333 （可通过以下方式配置 X64DBG_MCP_PORT 环境变量）。```
POST http://127.0.0.1:13333/mcp
Content-Type: application/json
#### 示例请求```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}
多实例模式
当多个x64dbg实例正在运行时：
- 第一个实例变成 大师 并托管路由器
- 其他实例注册为 奴隶
- 所有请求都通过主机的路由器端口
- 使用
client_id目标特定实例的参数```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"client_id": "client_2",
"name": "get_registers",
"arguments": {}
}
}
### 配置
|变量|默认值|描述|
|----------|---------|-------------|
| `X64DBG_MCP_PORT` | `13333` |MCP请求的路由器端口|
### MCP客户端配置
#### 克劳德桌面/光标/Kiro```json
{
"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 | 进程和线程信息 |
安装方法
- 从 发布 下载插件
- 复制插件文件到 x64dbg 插件目录：
-x64dbg_mcp.dp64→x64dbg/x64/plugins/
-x32dbg_mcp.dp32→x64dbg/x32/plugins/ - 重启 x64dbg
使用方法
MCP 端点
插件会在端口 13333 启动 HTTP 服务器（可通过 X64DBG_MCP_PORT 环境变量配置）。```
POST http://127.0.0.1:13333/mcp
Content-Type: application/json
#### 请求示例```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}
多实例模式
当运行多个 x64dbg 实例时：
- 第一个实例成为 大师，托管路由器
- 后续实例注册为 奴隶
- 所有请求通过 master 的路由端口
- 使用
client_id参数指定目标实例```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"client_id": "client_2",
"name": "get_registers",
"arguments": {}
}
}
### 配置
| 环境变量 | 默认值 | 描述 |
|----------|--------|------|
| `X64DBG_MCP_PORT` | `13333` | MCP 请求的路由端口 |
### MCP 客户端配置
#### 克劳德桌面/光标/Kiro```json
{
"mcpServers": {
"x64dbg": {
"url": "http://127.0.0.1:13333/mcp"
}
}
}
许可证
专有-仅限二进制分发。
作者
HyperClockUp
