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示例请求
{
"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 | 进程和线程信息 |
安装方法
- 从 发布 下载插件
- 复制插件文件到 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请求示例
{
"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"
}
}
}______________________________________________________________________
许可证
专有-仅限二进制分发。
