Skip to content
Back to search

x64dbg-mcp-server-win

Windows x32/x64 build of duty1g/x64dbg-mcp-server v1.8 (x64dbg MCP plugin) — prebuilt .dp32/.dp64 + one-click installer

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jaraim--x64dbg-mcp-server-win/badge.svg)](/listings/jaraim--x64dbg-mcp-server-win)

HTML

<a href="/listings/jaraim--x64dbg-mcp-server-win"><img src="/api/listings/jaraim--x64dbg-mcp-server-win/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

方式一:一键批处理(推荐)

1. 下载并解压(或用 `git clone` 本仓库)。 2. 双击 `安装到x64dbg.bat`,把 x64dbg 根目录拖进窗口后回车(也可直接粘贴路径)。 3. 脚本自动判断目录形态并复制对应插件,旧插件先备份到 `plugins_backup`。

支持三种目录形态:

| x64dbg 形态 | 特征 | 复制目标 | |---|---|---| | 便携版(release 层) | 根目录下有 `release\x64\x64dbg.exe` | `release\x32\plugins\`、`release\x64\plugins\` | | 多架构版 | 根目录下直接有 `x32\`、`x64\` 两个文件夹 | `x32\plugins\`、`x64\plugins\` | | 单架构版 | 目标目录自身含 `x64dbg.exe`(目录名 x32 / x64) | 该目录的 `plugins\` |

方式二:手动复制

- 便携版:`x32\plugins\x64dbg-MCP-Server.dp32` → `<根>\release\x32\plugins\`;`x64\plugins\x64dbg-MCP-Server.dp64` → `<根>\release\x64\plugins\` - 多架构版:分别放进 `<根>\x32\plugins\` 与 `<根>\x64\plugins\` - 单架构版:只放与架构匹配的那一个到 `plugins\`

x64dbg 只加载与本进程架构一致的插件:64 位主程序读 `.dp64`,32 位主程序读 `.dp32`。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 113 lines
  1. # x64dbg-MCP Server 1.8 — Windows x32 / x64 构建
  2. [x64dbg](https://x64dbg.com) 的原生 MCP 插件:把调试器的完整能力通过 HTTP(Streamable HTTP + SSE,JSON-RPC 2.0,MCP 2024-11-05)暴露给 AI 客户端。84 个 MCP 工具、22 个调试事件回调,纯原生单文件插件,无 .NET / Python 运行时依赖。
  3. 本仓库是上游 [duty1g/x64dbg-mcp-server](https://github.com/duty1g/x64dbg-mcp-server) **v1.8** 的 Windows 预编译产物,附带一键安装脚本,省去自建 Zig 工具链的步骤。
  4. - 上游版本:v1.8(上游提交 2026-11-15)
  5. - 编译:Zig 0.15.2,`zig build -Doptimize=ReleaseSafe --prefix dist`,`x86-windows-gnu` / `x86_64-windows-gnu` 交叉编译
  6. - 产物校验:`PE32 DLL (GUI) Intel 80386` / `PE32+ DLL (GUI) x86-64`;导入 `KERNEL32 / WS2_32 / USER32 / ntdll / ADVAPI32 / GDI32`
  7. - 许可证:MIT(见 [LICENSE](LICENSE))
  8. ## 下载
  9. - 懒人包:到 [Releases](../../releases) 下载 `x64dbg-MCP-Server-1.8-win.zip`
  10. - 或直接在本仓库取插件文件
  11. ## 仓库结构
  12. ```
  13. .
  14. ├─ x64/plugins/x64dbg-MCP-Server.dp64 64 位 x64dbg 插件(端口 9094)
  15. ├─ x32/plugins/x64dbg-MCP-Server.dp32 32 位 x64dbg 插件(端口 9095)
  16. ├─ 安装到x64dbg.bat 一键安装(自动识别目录结构 + 备份旧插件)
  17. ├─ 查看Token和MCP配置.bat 读取 mcp_config.json,输出 Token 与 MCP 配置片段
  18. ├─ show_config.ps1 上面批处理调用的 PowerShell 脚本
  19. ├─ SKILL-工具使用指南.md 面向 AI 客户端的工具使用规范(84 个工具的调用纪律)
  20. └─ LICENSE
  21. ```
  22. ## 安装
  23. ### 方式一:一键批处理(推荐)
  24. 1. 下载并解压(或用 `git clone` 本仓库)。
  25. 2. 双击 `安装到x64dbg.bat`,把 x64dbg 根目录拖进窗口后回车(也可直接粘贴路径)。
  26. 3. 脚本自动判断目录形态并复制对应插件,旧插件先备份到 `plugins_backup`。
  27. 支持三种目录形态:
  28. | x64dbg 形态 | 特征 | 复制目标 |
  29. |---|---|---|
  30. | 便携版(release 层) | 根目录下有 `release\x64\x64dbg.exe` | `release\x32\plugins\`、`release\x64\plugins\` |
  31. | 多架构版 | 根目录下直接有 `x32\`、`x64\` 两个文件夹 | `x32\plugins\`、`x64\plugins\` |
  32. | 单架构版 | 目标目录自身含 `x64dbg.exe`(目录名 x32 / x64) | 该目录的 `plugins\` |
  33. ### 方式二:手动复制
  34. - 便携版:`x32\plugins\x64dbg-MCP-Server.dp32` → `<根>\release\x32\plugins\`;`x64\plugins\x64dbg-MCP-Server.dp64` → `<根>\release\x64\plugins\`
  35. - 多架构版:分别放进 `<根>\x32\plugins\` 与 `<根>\x64\plugins\`
  36. - 单架构版:只放与架构匹配的那一个到 `plugins\`
  37. x64dbg 只加载与本进程架构一致的插件:64 位主程序读 `.dp64`,32 位主程序读 `.dp32`。
  38. ## 首次运行
  39. 1. 启动 x64dbg,插件自动启动 HTTP 服务:x64 监听 `0.0.0.0:9094`,x32 监听 `0.0.0.0:9095`。
  40. 2. 首次运行会在 x64dbg.exe 同目录生成 `mcp_config.json`,内含自动生成的 Bearer Token。
  41. 3. 双击 `查看Token和MCP配置.bat` 即可读出 Token,并生成可直接粘贴到 MCP 客户端(Claude Code、`.mcp.json`、Cherry Studio 等)的配置片段。
  42. 修改绑定地址 / 端口 / Token:菜单 `Plugins > x64dbg-MCP Server > Configure MCP Server...`,保存后服务自动重启。对话框内 `Generate` 可轮换 Token,`Copy` 复制到剪贴板。
  43. ### MCP 客户端配置示例
  44. ```json
  45. {
  46. "mcpServers": {
  47. "x64dbg": {
  48. "type": "http",
  49. "url": "http://localhost:9094/",
  50. "headers": {
  51. "Authorization": "Bearer YOUR_TOKEN_HERE"
  52. }
  53. }
  54. }
  55. }
  56. ```
  57. SSE 传输(旧客户端):
  58. ```json
  59. {
  60. "mcpServers": {
  61. "x64dbg": {
  62. "type": "sse",
  63. "url": "http://localhost:9094/sse",
  64. "headers": { "Authorization": "Bearer YOUR_TOKEN_HERE" }
  65. }
  66. }
  67. }
  68. ```
  69. ## 常见问题
  70. - **端口未监听**:先确认插件文件在正确的 `plugins` 目录;x64dbg 启动后到 `Plugins` 菜单查看是否有 `x64dbg-MCP Server` 项;再看 x64dbg 日志窗口是否打印启动信息。
  71. - **401 Unauthorized**:客户端 `Authorization` 头缺失或 Token 不匹配,用 `查看Token和MCP配置.bat` 重新取一次。
  72. - **WSL / 远程连不上**:配置对话框把绑定地址改为 `0.0.0.0`,客户端 URL 换成宿主机 IP(如 `http://172.x.x.x:9094/`),并确认 Windows 防火墙已放行 9094 / 9095。
  73. - **32 位与 64 位同时运行**:两套端口独立(9094 / 9095),Token 各自独立(各自目录下的 `mcp_config.json`)。
  74. ## 重新编译(Linux / macOS / WSL)
  75. ```bash
  76. git clone https://github.com/duty1g/x64dbg-mcp-server.git
  77. cd x64dbg-mcp-server
  78. zig build -Doptimize=ReleaseSafe --prefix dist
  79. ```
  80. 注意工具链版本:Zig **0.15.2** 可以成功编译;Zig 0.16.0 稳定版把 winsock 绑定从 `std.os.windows.ws2_32` 移除,并把 `BOOL` 改为枚举类型 `os.windows.Bool(c_int)`,源码会在 24 处报错(`SOCKET` / `WSADATA` 缺失、`@bitCast` 失败等),需用旧版工具链或改源码适配。
  81. ## 安全
  82. 服务对调试目标有完全控制能力(读写内存、执行代码、改寄存器),仅 Bearer Token 认证且为明文 HTTP。只在本机或可信内网使用,不要把端口暴露到公网。
  83. 本仓库仅重新分发上游遵循 MIT 许可证的构建产物,版权归上游作者所有。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.