Demo

Cheat Engine MCP 桥接器

让价值数十亿美元的人工智能数据中心为你分析程序内存。

快速创建模组、训练器、安全审计、游戏机器人、加速逆向工程，或是基于任何程序和游戏完成其他任何操作，所需时间仅过去的一小部分。

[!NOTE] 感谢大家的 Star，非常感激！<3

特别感谢所有贡献者！！

@libangli218, @lauralex, @iamtyroon, @HachiroSan, @Attacktive

问题

你正盯着数 GB 的内存。数百万个地址。成千上万个函数。找到那个指针、那个结构体需要几天甚至几周的手动工作。

如果你可以直接提问呢？

“找到数据包解密钩子。”
“找到角色坐标的操作码。”
“找到生命值的操作码。”
“找到唯一的 AOB 模式，让我的训练器在游戏更新后依然可靠。”

这正是此工具能做到的。

- 告别逐行点击十六进制转储，开始与内存对话。

你能获得什么：

你的 AI 现在可以：

• 瞬间读取任意内存（整数、浮点数、字符串、指针）
• 跟踪指针链：[[base+0x10]+0x20]+0x8 → 毫秒级解析
• 自动分析结构体，包含字段类型和值
• 通过 RTTI 识别 C++ 对象：“这是一个 CPlayer 对象”
• 反汇编并分析函数
• 利用硬件断点 + Ring -1 虚拟机监控程序实现隐形调试
• 以及更多！

工作原理

flowchart TD
    AI[AI Agent: Claude/Cursor/Copilot]
    
    AI -->|MCP 协议 - 基于 JSON-RPC 通过 stdio| MCP
    
    MCP[mcp_cheatengine.py - Python MCP 服务器]
    
    MCP <-->|命名管道 - 异步| PIPE
    
    PIPE["\\.\\pipe\\CE_MCP_Bridge_v99"]
    
    PIPE <--> CE
    
    subgraph CE[Cheat Engine - DBVM 模式]
        subgraph LUA[ce_mcp_bridge.lua]
            WORKER[工作线程 - 阻塞 I/O]
            MAIN[主线程 - GUI + CE API]
            WORKER <-->|同步| MAIN
        end
    end
    
    MAIN -->|内存访问| TARGET[目标 .exe]

安装

pip install -r MCP_Server/requirements.txt

或手动安装：

pip install mcp pywin32

[!NOTE] 本地管道模式仅支持 Windows，因为它使用了命名管道（pywin32）。当 MCP 服务器运行在托管 Cheat Engine 的 Windows 环境之外，且无法直接打开命名管道时，可使用 TCP 中继传输。

快速开始

1. 在 Cheat Engine 中加载桥接器

1. 如果你计划使用 DBVM 工具，请在 Cheat Engine 中启用 DBVM。
2. 打开 Cheat Engine 的 Lua 引擎或脚本执行器。
   • 推荐：文件 -> 执行脚本 -> 打开 MCP_Server/ce_mcp_bridge.lua -> 执行。
   • 如果你的 Cheat Engine 版本没有显示 文件 -> 执行脚本，请使用 表格 -> 显示作弊表 Lua 脚本，粘贴下面的 dofile(...) 行并执行：

dofile([[C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_mcp_bridge.lua]])

查找输出：[MCP v12.0.0] MCP 服务器已监听: CE_MCP_Bridge_v99

2. 配置 MCP 客户端

添加至你的 MCP 配置（例如 mcp_config.json）：

{
  "servers": {
    "cheatengine": {
      "command": "python",
      "args": ["C:/path/to/MCP_Server/mcp_cheatengine.py"]
    }
  }
}

重启 IDE 以加载 MCP 服务器配置。

对于 Codex，请在 ~/.codex/config.toml 中添加 TOML 服务器块：

[mcp_servers.cheatengine]
command = "python"
args = ['C:\path\to\cheatengine-mcp-bridge\MCP_Server\mcp_cheatengine.py']

对 Windows 路径使用单引号，以便 TOML 按字面意义处理反斜杠。

TCP 中继传输

TCP 中继让 mcp_cheatengine.py 通过 TCP 套接字与 Cheat Engine 通信，而不是自行打开 Windows 命名管道。Cheat Engine 和 Lua 桥接器仍运行在 Windows 上，而 MCP 服务器可以运行在能到达中继的任何地方：另一个 Windows 进程、虚拟机、容器、Linux 主机或远程机器。这也可用于 WSL，无需修改 Lua 桥接器。

1. 在 Windows 上，像往常一样在 Cheat Engine 中加载 MCP_Server/ce_mcp_bridge.lua。
2. 在 Windows 上启动中继：

python C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_tcp_relay.py --host 127.0.0.1 --port 9876

3. 在 MCP 服务器将要运行的环境中，安装不包含 pywin32 的 MCP 依赖，然后使用 TCP 传输运行/配置 MCP 服务器：

python3 -m pip install -r MCP_Server/requirements-tcp.txt

CE_MCP_TRANSPORT=tcp \
CE_MCP_HOST=127.0.0.1 \
CE_MCP_PORT=9876 \
python3 /path/to/cheatengine-mcp-bridge/MCP_Server/mcp_cheatengine.py

对于支持环境变量的 MCP 客户端配置：

{
  "servers": {
    "cheatengine": {
      "command": "python3",
      "args": ["/path/to/cheatengine-mcp-bridge/MCP_Server/mcp_cheatengine.py"],
      "env": {
        "CE_MCP_TRANSPORT": "tcp",
        "CE_MCP_HOST": "127.0.0.1",
        "CE_MCP_PORT": "9876"
      }
    }
  }
}

将中继上的 --host 和 MCP 服务器上的 CE_MCP_HOST 设置为匹配你的网络设置的地址。请确保中继仅绑定到受信任的接口，因为任何能访问它的人都可以控制 Cheat Engine 桥接器。

3. 验证连接

使用 ping 工具验证连接性：

{"success": true, "version": "12.0.0", "message": "CE MCP Bridge Active"}

4. 开始提问

"当前附加了哪个进程？"
"读取基址处的16个字节"
"反汇编入口点"

约 180 个 MCP 工具可用

内存

分析

调试

进程生命周期

内存分配

代码注入

符号管理

汇编 / 编译

窗口 / GUI 自动化

输入自动化

作弊表

内核模式 (DBK / DBVM)

更多工具请参阅 AI_Context/MCP_Bridge_Command_Reference.md

关键配置

BSOD 预防

[!CAUTION] 你必须禁用： Cheat Engine → 设置 → 额外 → "查询内存区域例程"

启用后：扫描受保护页面时，由于与 DBVM/反作弊系统冲突，会导致 CLOCK_WATCHDOG_TIMEOUT BSOD。

故障排除

Cheat Engine 显示 “too many local variables”

请使用 dofile(...) 从磁盘加载桥接器，而不是将完整脚本粘贴到作弊表脚本中。桥接器还故意将命令处理程序声明为全局函数；这样可以避免在完整桥接器一次性编译时超过 Cheat Engine 的 Lua 块限制（200 个局部变量）。

MCP 客户端无法连接

请按顺序检查以下事项：

1. Cheat Engine 已打开并显示 MCP 服务器已监听: CE_MCP_Bridge_v99。
2. 添加服务器配置后已重启 MCP 客户端。
3. 配置的 mcp_cheatengine.py 路径存在。
4. pip install -r MCP_Server/requirements.txt 已成功安装 mcp 和 pywin32。
5. 运行 MCP 的 ping 工具。成功的连接会返回 success: true 和桥接器版本。在 Cheat Engine 附加到目标进程之前，process_id: 0 属于正常情况。

环境变量

示例工作流程

查找一个值：

你: "扫描金币: 15000"  →  AI 找到 47 个结果
你: "金币变为 15100"  →  AI 过滤到 3 个地址
你: "第一个地址被什么写入了？"  →  AI 设置硬件断点
你: "反汇编那个函数"  →  完整的 AddGold 逻辑被揭示

理解一个结构体：

你: "[[game.exe+0x1234]+0x10] 里是什么？"
AI: "RTTI: CPlayerInventory"
AI: "0x00=vtable, 0x08=itemCount(int), 0x10=itemArray(ptr)..."

项目结构

CLAUDE.md                               # Claude Code 代理指南（此仓库）
README.md                               # 面向用户的文档

MCP_Server/
├── mcp_cheatengine.py                  # Python MCP 服务器 (FastMCP)
├── ce_mcp_bridge.lua                   # Cheat Engine Lua 桥接器
└── test_mcp.py                         # 测试套件

AI_Context/
├── BATCH_WORKER_BRIEFING.md            # 并行工作器任务规范（v12 重构）
├── MCP_Bridge_Command_Reference.md     # MCP 命令参考
├── CE_LUA_Documentation.md             # CheatEngine 7.6 完整官方文档
└── AI_Guide_MCP_Server_Implementation.md  # AI 代理的完整技术文档

测试

运行测试：

python MCP_Server/test_mcp.py

预期输出：

✅ 内存读取：6/6 测试通过
✅ 进程信息：4/4 测试通过  
✅ 代码分析：8/8 测试通过
✅ 断点：4/4 测试通过
✅ DBVM 功能：3/3 测试通过
✅ 实用命令：11/11 测试通过
⏭️ 跳过：1 个测试 (generate_signature)
────────────────────────────────────
总计：36/37 通过 (100% 成功)

关键要点

你不再需要成为专家。只需提出正确的问题。

⚠️ 教育免责声明

此代码仅供教育研究目的使用。它旨在展示模型上下文协议（MCP）和基于 LLM 的调试能力。我不支持将这些工具用于恶意黑客攻击、在多人在线游戏中作弊或违反服务条款。这是一个软件工程自动化的演示。