x64dbg-mcp-server
duty1g/x64dbg-mcp-server加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
想象你正在分析一个加壳的恶意软件，手动翻找寄存器、设置断点、追踪内存——枯燥又容易出错。现在，你可以对 AI 说一句"帮我找登录验证逻辑"，它就能自动操控调试器完成整个分析流程。这正是 x64dbg-MCP Server 正在实现的事情。
逆向工程（Reverse Engineering）一直是网络安全、恶意软件分析、软件漏洞挖掘领域的核心技能。调试器是逆向工程师的"手术刀"——通过设置断点、单步执行、读取内存，层层剥开程序的内部逻辑。
x64dbg 是 Windows 平台上最受欢迎的开源调试器之一，支持 x32 和 x64 程序调试，拥有强大的插件生态。然而，传统调试完全依赖人工操作：分析一个函数需要手动翻几十条汇编指令，找一个变量需要记住无数内存地址，整个过程重复、枯燥且容易遗漏。
x64dbg-MCP Server 的出现，改变了这一切。它将 x64dbg 的全部调试能力通过 MCP（Model Context Protocol） 接口暴露出来，让任何兼容 MCP 的 AI 助手（如 Claude Desktop、Cline、Cursor 等）都能通过自然语言操控调试器——设置断点、读取寄存器、搜索内存字符串、追踪函数调用链，所有操作都可以用对话完成。
项目的作者 @duty1g 是一位专注于二进制安全研究的独立开发者，从他在 GitHub 和 Twitter 上的动态可以看出，他长期活跃于逆向工程和红队工具领域。项目目前已获得 2033 颗星，是 MCP 协议在安全工具领域最成熟的应用之一。
x64dbg-MCP Server 提供了 84 个 MCP 工具（v1.1 版本数据），覆盖了调试器的完整功能链路：
无需调试会话即可使用（通用工具）：
| 工具 | 作用 |
|---|---|
LoadBinary | 加载可执行文件进入调试器 |
AttachProcess | 附加到正在运行的进程 |
ExecuteDebuggerCommand | 执行任意 x64dbg 原生命令 |
SearchForStrings | 在进程内存中搜索字符串 |
GetEventLog | 查看最近的调试事件日志 |
EvalExpression | 计算任意 x64dbg 表达式（地址、寄存器、算术） |
需要活跃调试会话（核心调试工具）：
| 工具 | 作用 |
|---|---|
Disassemble | 反汇编指定地址的 N 条指令 |
DisassembleFunction | 反汇编完整函数（给定边界） |
ReadMemory | 读取进程内存的十六进制数据 |
GetAllRegisters | 导出所有通用寄存器的当前值 |
GetCallStack | 获取当前线程的调用栈 |
SetBreakpoint | 在指定地址设置 INT3 软件断点 |
SetHardwareBreakpoint | 设置硬件断点（DR0-DR3，读/写/执行） |
SetConditionalBreakpoint | 设置带条件表达式和日志的条件断点 |
FindPattern | 在模块内存中扫描字节模式（支持 ?? 通配符） |
GetStrings | 从模块内存中提取 ASCII/Unicode 字符串 |
GetReferences | 查找指向目标地址的 CALL/JMP 交叉引用 |
GetFunctions | 列出已分析函数的地址和标签 |
AnalyzeModule | PE 结构分析：节区、入口点、镜像大小 |
DetectOEP | 检测加壳程序原始入口点 |
DumpMemory / DumpModule | 将内存区域或整个模块导出到文件 |
GetPEB | 读取进程环境块字段 |
TraceInto / TraceOver | 指令级跟踪（进入/跳过函数调用） |
除了工具之外，项目还实现了 22 个调试事件回调：断点命中、异常抛出、模块加载/卸载、线程创建/销毁等，AI 助手可以在这些事件触发时自动执行响应逻辑。
x64dbg-MCP Server 的技术选型非常有特色：
纯 Zig 语言实现：Zig 是一门新兴的系统级编程语言，以零标准库依赖（no_std 友好）和精确的内存控制著称。项目使用 Zig 编写，充分利用了以下优势：
zig build -Doptimize=ReleaseSafe 一条命令，同时编译出 x32 (.dp32) 和 x64 (.dp64) 两个架构的插件，且可以在 Linux、macOS、Windows、WSL 任一平台上完成 Windows 插件的构建x64dbg.dll、x64bridge.dll）的导出符号，无需静态链接插件 SDKHTTP 服务器 + JSON-RPC 双传输：
Authorization: Bearer *** Header，未认证请求返回 401，防止未经授权的调试器控制HTTP 服务器嵌入 x64dbg 地址空间：插件加载后，HTTP 服务器运行在 x64dbg 的后台线程中，与调试器共享地址空间，无需额外的外部进程或网络端口共享。
x64dbg-MCP-Server.zipx64dbg-MCP-Server.zip 中的所有文件复制到 x64dbg 根目录（会自动覆盖 x32 和 x64 两个插件目录）0.0.0.0:90940.0.0.0:9095以 Claude Desktop 为例，在 ~/.mcp.json 中添加：
{
"mcpServers": {
"x64dbg": {
"type": "http",
"url": "http://localhost:9094/",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
注意：首次运行 x64dbg 时，Token 会自动生成并保存到
mcp_config.json。在 x64dbg 菜单 Plugins > x64dbg-MCP Server > Configure MCP Server... 中可以复制或重新生成 Token。
zig build -Doptimize=ReleaseSafe --prefix dist
# 编译产物在 dist/ 目录，自动按 x32/x64 分类
你: 加载 calc.exe，在入口点设置断点并运行
AI: [调用 LoadBinary, SetBreakpoint, run, WaitForPause]
calc.exe 已加载，在 0x7FF7A1234000 处命中断点
你: 当前寄存器状态是什么？
AI: [调用 GetAllRegisters]
RAX: 0x0, RCX: 0x7FF7A1234000, RDX: 0x1, ...
你: 读取当前指令地址的 64 字节内存
AI: [调用 ReadMemory]
48 83 EC 28 E8 12 34 00 00 ...
你: 单步执行 3 条指令，显示调用栈
AI: [调用 StepOver x3, GetCallStack]
执行至 0x7FF7A1234010，调用栈：...
x64dbg-MCP Server 虽然功能强大，但也存在一些局限和值得关注的点：
平台限制：这是一个 Windows 原生插件，仅支持 Windows 平台下的 x64dbg 调试器。Linux/macOS 用户如果想使用 AI 辅助调试，需要配合 WSL2（Windows Subsystem for Linux）或虚拟机中的 Windows 实例。
安全风险：Bearer Token 以明文传输，HTTP 通信未加密。作者在免责声明中明确警告：不要将 MCP Server 暴露在不可信的网络环境中，因为任何持有 Token 的人都获得了对目标进程的完整读写控制权。
上手门槛高：尽管配置 MCP 客户端相对简单，但用户需要具备一定的逆向工程基础（理解寄存器、断点、内存布局等概念），才能有效利用 AI 返回的调试信息。此外，源码构建需要安装 Zig 0.14+ 编译器，对普通开发者并不友好。
稳定性：截至 2026 年初，该项目相对年轻（首个版本发布于 2025 年末），部分用户反馈在复杂调试场景下存在稳定性问题，生产环境使用需谨慎评估。
x64dbg-MCP Server 代表了一个重要趋势：AI 正在从"被动问答"走向"主动操控工具"。传统 AI 助手只能帮你写代码、解释代码，而 MCP 协议让 AI 获得了真正的"执行能力"——操控调试器、修改内存、触发断点，这已经是实打实的系统级操作。
在安全研究领域，AI 辅助调试的价值尤为突出：
目前，基于 MCP 协议的 AI 工具生态正在快速扩张，涵盖文件系统、数据库、Web 浏览器、Git 操作等多个领域。x64dbg-MCP Server 作为安全调试领域的先行者，为 AI 操控底层系统工具提供了一个高质量的参考实现。随着 MCP 协议的成熟和 AI 推理能力的提升，"用自然语言做逆向工程"有望成为安全研究的新范式。
数据来源：duty1g/x64dbg-mcp-server · Zig · MIT License · 2033 ⭐