x64dbg-mcp-server

这是什么？适合谁？

x64dbg-MCP Server（duty1g/x64dbg-mcp-server）是 x64dbg 的原生 MCP（Model Context Protocol）插件，把调试器的完整功能通过 HTTP 暴露给任何 MCP 兼容的 AI 助手：下断点、单步执行、读内存、dump 寄存器、模式扫描、字符串提取、交叉引用、PE 分析、OEP 检测、模块转储等 71 个 MCP 工具，外加 22 个调试器事件回调（init/stop/breakpoint/exception/attach/DLL load 等）。

它用 Zig 编写：零依赖、单二进制输出、从任意主机交叉编译 x32 和 x64 版本。不需要 .NET、不需要 Python、不需要运行时——把插件丢进 x64dbg plugins 目录即可。MCP 服务随 x64dbg 启动自动运行，默认端口 x64 是 0.0.0.0:9094、x32 是 9095，强制 Bearer Token 认证（首次运行自动生成）。

适合人群：

• 逆向工程师/安全研究员：想让 AI Agent 直接驱动 x64dbg 做 CTF 题目、恶意样本分析、漏洞复现
• 二进制分析自动化开发者：需要把调试器事件流（断点命中、异常触发）接入 Agent 循环
• CTF 战队：AI 辅助解 reversing 题时的「眼睛和手」

不适合：不需要 Windows 逆向的人；以及期望「一键全自动破解」的用户——它是调试器控制面，分析判断仍靠 Agent 与人。

使用前提：Windows + x64dbg（x64dbg 官网 下载）；一个 MCP 兼容客户端（Claude Code / Claude Desktop / Cursor 等）。

准备工作

1. x64dbg：从 x64dbg.com 或 GitHub Releases 下载，解压即用（绿色软件）。
2. 插件文件：从本仓库 Releases 下载 dist/ 内容，复制到 x64dbg 根目录（同时部署 x32/x64 两个版本）。
3. MCP 客户端：任意支持 Streamable HTTP 或 SSE 的客户端均可。
4. 成本：插件本身 MIT 开源免费；消耗的是你自己 MCP 客户端的 LLM tokens。
5. 时间预算：安装 2 分钟；把 Agent 接入调试循环约 10 分钟。

快速上手（3 步）

第一步：安装插件

# 1. 下载 release（或从源码构建：zig build -Doptimize=ReleaseSafe）
# 2. 把 dist/ 内容复制到 x64dbg 根目录（x32/x64 两个 plugins 子目录都会就位）
# 3. 启动 x64dbg —— MCP server 自动启动，监听 9094(x64)/9095(x32)

首次启动会在 x64dbg 日志里打印自动生成的 Bearer Token。

第二步：接入 MCP 客户端

在 .mcp.json（Claude Code 等）添加：

{
  "mcpServers": {
    "x64dbg": {
      "type": "http",
      "url": "http://localhost:9094/",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

旧客户端可走 SSE："type": "sse", "url": "http://localhost:9094/sse"。

第三步：跑第一个逆向任务

让 Agent 干一件真实的事，例如：

用 x64dbg 打开 crackme.exe，找到校验函数的入口地址，
在它上面下断点，然后单步跟一遍，告诉我校验逻辑是什么。

预期结果：Agent 依次调用 attach/模块枚举/反汇编/断点/单步工具，把每一步的寄存器与内存变化读回来，最后给出分析结论。

常见踩坑

踩坑 1：连不上 9094 端口

• 现象：MCP 客户端报连接拒绝。
• 原因：插件没被 x64dbg 加载（放错目录），或 x64dbg 还没启动。
• 解决：确认 dist/ 解压到 x64dbg 根目录后，plugins 目录里能看到对应 .dp32/.dp64 文件；先启动 x64dbg 再连。端口可在 Plugins 菜单的 Config Dialog 里改。

踩坑 2：401 Unauthorized

• 现象：HTTP 401，工具调用全部失败。
• 原因：Bearer Token 不对——每个首次启动都会生成新 token。
• 解决：从 x64dbg 日志窗口复制当前 token 填进客户端配置；也可在 Config Dialog 里自定义。

踩坑 3：默认绑定 0.0.0.0 的安全暴露

• 现象：MCP 端口监听在所有网卡上。
• 原因：默认配置面向本机快速起步，但没有绑定 127.0.0.1。
• 解决：务必保留 Bearer Token；在不可信网络下用防火墙拦掉外部访问，或改绑回环地址。

踩坑 4：工具一次没全出现

• 现象：客户端只列出一部分工具。
• 原因：部分工具需要调试会话存在（进程已 attach/加载）才会可用。
• 解决：先让 Agent 打开目标进程，再重新枚举工具。

踩坑 5：长时间单步任务超时

• 现象：Agent 循环单步几百次后客户端超时。
• 原因：每次工具调用一轮 LLM 交互，token 与时延累积。
• 解决：优先用批量读内存/模式扫描缩小范围，把单步留给关键片段；或用事件回调（断点触发）代替轮询。

踩坑 6：x32 目标连错端口

• 现象：32 位目标进程操作全部报错。
• 原因：x32 与 x64 是两个独立 MCP server（9095 vs 9094）。
• 解决：32 位调试实例用 9095 端口配置第二个 server 条目。

初级用法

1. 远程操控三件套：让 Agent「枚举模块 → 搜字符串 → 下断点」，跑通最基本的逆向侦察。
2. 寄存器快照对比：断点命中前后各 dump 一次寄存器，让 Agent 推断哪条指令改了关键值。
3. 字符串定位法：用字符串提取工具找到关键提示语地址，再查交叉引用回溯校验函数——CTF crackme 通用套路。
4. PE 分析快速画像：让 Agent 用 PE 分析工具列出导入表，判断样本是网络型还是注册表型恶意行为。

高级玩法

1. 事件驱动的自动化分析：注册 22 个事件回调，让 Agent 在 DLL load / exception 事件发生时自动采集现场，实现「无人值守」的样本行为记录。
2. 脱壳流水线：OEP 检测工具 + 模块转储工具组合，让 Agent 在壳代码执行完跳到 OEP 时自动停住并转储——把手工脱壳变成一条 prompt。
3. 多 Agent 协作：一个 Agent 负责 x64dbg 控制，另一个负责 IDA/Ghidra 侧的静态分析（通过各自 MCP server），人只做结论审核。
4. 补丁验证：Agent 直接用内存分配/写入工具打补丁，再单步验证行为变化，最后产出 diff 报告。

小技巧

1. Config Dialog 改配置即重启：Plugins 菜单改 IP/端口/token 后 server 自动重启，无需重启 x64dbg。
2. token 别提交进仓库：.mcp.json 里填 token 时记得加进 .gitignore。
3. Streamable HTTP 优先：新客户端用 type: http，兼容性和断线重连都比 SSE 好。
4. 调试自己写的 MCP 调用：先用 curl 直接打 http://localhost:9094/ 带 token，确认 server 存活再排查客户端。
5. 交叉编译：Linux/macOS/WSL 上 zig build 即可产出 Windows 插件，CI 出包很方便。

常见问题 FAQ

Q1：它和「让 AI 读反汇编文本」有什么区别？

A：区别是 Agent 拿到了活的调试器而不是死的文本——可以下断点、改内存、响应异常，做动态分析而非静态猜测。

Q2：支持哪些 x64dbg 版本？

A：作为原生插件跟随 x64dbg 插件 API；以仓库 Releases 页标注的兼容版本为准。

Q3：能同时调试多个进程吗？

A：一个 x64dbg 实例一个 MCP server；多实例就开多个 x64dbg（端口不同），客户端分别接入。

Q4：会拖慢调试器吗？

A：Zig 单二进制、按需响应 HTTP 请求，空闲时几乎零开销；只有 Agent 主动调用工具才有交互。

Q5：和 Ghidra MCP / IDA MCP 冲突吗？

A：不冲突，互补——静态（Ghidra/IDA）+ 动态（x64dbg）是逆向标配组合，Agent 可以同时挂两个。

进阶学习建议

• 吃透 71 个工具清单：读仓库 README 的 Tools 一节，按「内存类/寄存器类/断点类/搜索类/PE 类」给自己画一张能力地图，写 Agent prompt 时直接点名工具，比泛泛说「帮我分析」效率高一个量级。
• 事件回调编程：研究 22 个 event callback 的触发时机（breakpoint/exception/DLL load），把「事件 → 自动采集 → LLM 判断」写成循环，这是从「遥控器」升级到「自动化分析员」的分水岭。
• 结合 OEP 检测做脱壳：拿一个 UPX 壳样本走一遍「OEP 检测 → 断点 → 转储」流程，理解 runtime dump 与静态 dump 的差异。

参考链接

• x64dbg-mcp-server GitHub 仓库
• x64dbg 官网
• x64dbg GitHub
• MCP 协议官网

免责声明：本文基于官方仓库 README 与 GitHub 公开数据整理，AI 辅助生成，MagicNetWorld 尚未完成独立实测。逆向工程请遵守当地法律法规，仅用于授权安全测试与学习研究。