如何把任意AI客户端接入Cheat Engine:Cheat Engine MCP Bridge全客户端配置指南
如何把任意AI客户端接入Cheat Engine:Cheat Engine MCP Bridge全客户端配置指南
想让 Claude、Cursor、Copilot 这样的 AI 助手直接操控 Cheat Engine 吗?Cheat Engine MCP Bridge 正是为此而生——它基于标准 MCP(Model Context Protocol)协议,把任意支持 MCP 的 AI 客户端接入 Cheat Engine,让你只用自然语言就能完成内存扫描、指针追踪、结构分析和代码反汇编等逆向工程工作。本文是一份面向新手的完整配置指南,带你从零跑通整个接入流程。🎯
为什么需要 Cheat Engine MCP?
传统逆向要翻几 GB 内存、逐个排查地址,找"那一个指针"可能要花好几天。而接入 AI 后,你只需要"提问":
- "找到角色血量的地址"
- "解析
[[base+0x10]+0x20]这个指针链"- "这个地址是个什么 C++ 对象?"
| 手动操作 | AI 客户端 + MCP |
|---|---|
| 第 1 天:找到包地址 | 第 1 分钟:"定位 RX 解密钩子" |
| 第 2 天:追踪写入者 | 第 3 分钟:"生成唯一的 AOB 特征" |
| 第 5 天:游戏更新,重来 | 几分钟搞定 ✅ |
这套桥接当前提供约 180 个 MCP 工具,覆盖内存读写、进程生命周期、代码注入、符号管理、调试断点、GUI 自动化等,完整清单可查 AI_Context/MCP_Bridge_Command_Reference.md。
Cheat Engine MCP Bridge 的工作原理
整个系统由三层组成,AI 客户端通过标准 MCP 协议与 Cheat Engine 对话,中间无需你关心底层细节:
AI 客户端 ──(MCP / JSON-RPC over stdio)──▶ mcp_cheatengine.py (Python MCP 服务)
│
命名管道(异步通信)
▼
ce_mcp_bridge.lua(运行在 Cheat Engine 内)
▼
目标进程内存
- Python MCP 服务端:MCP_Server/mcp_cheatengine.py,负责把每个 MCP 工具调用翻译成对 Cheat Engine 的指令。
- Lua 桥接脚本:MCP_Server/ce_mcp_bridge.lua,在 Cheat Engine 内部运行,真正执行内存操作。
💡 关键点:因为它是标准 MCP 服务,所以任何支持 MCP 的 AI 客户端都能接入——这就是"全客户端"的含义。
接入前准备:3 个必要前提
前提一:准备项目文件
先获取项目代码(以 git clone 为例):
git clone https://gitcode.com/gh_mirrors/ch/cheatengine-mcp-bridge
前提二:安装 Python 依赖
Cheat Engine MCP 依赖 Python 3.10+。在 Windows 命名管道模式下,执行:
pip install -r MCP_Server/requirements.txt
这会自动安装 MCP_Server/requirements.txt 中列出的 mcp 和 pywin32 两个核心依赖。
前提三:禁用"Query memory region routines"(防蓝屏,必做)⚠️
必须关闭:Cheat Engine → Settings → Extra → "Query memory region routines"。 若保持开启,扫描受保护内存页时可能触发
CLOCK_WATCHDOG_TIMEOUT蓝屏。这是本项目的硬性要求,请务必先设置好。
第1步:在 Cheat Engine 中加载 Lua 桥
- 打开 Cheat Engine,如需使用 DBVM 工具请先开启 DBVM 模式。
- 加载桥接脚本,两种方式任选:
- 推荐:
File→Execute Script→ 打开 MCP_Server/ce_mcp_bridge.lua → 点击Execute。 - 若你的版本没有该菜单,用
Table→Show Cheat Table Lua Script,粘贴下面这一行后执行(请替换为你的实际路径):
- 推荐:
dofile([[C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_mcp_bridge.lua]])
看到如下日志就说明加载成功:
[MCP v12.0.0] MCP Server Listening on: CE_MCP_Bridge_v99
第2步:在你的 AI 客户端中配置 MCP 服务
不同客户端的配置格式略有不同,下面给出两类最通用的写法。
方式A:Claude / Cursor / Copilot(JSON 配置)
在你的 MCP 配置文件(如 mcp_config.json)中添加:
{
"servers": {
"cheatengine": {
"command": "python",
"args": ["C:/path/to/MCP_Server/mcp_cheatengine.py"]
}
}
}
保存后重启 IDE 让配置生效。
方式B:Codex(TOML 配置)
在 ~/.codex/config.toml 中添加一个服务块(注意 Windows 路径要用单引号,让反斜杠按字面处理):
[mcp_servers.cheatengine]
command = "python"
args = ['C:\path\to\cheatengine-mcp-bridge\MCP_Server\mcp_cheatengine.py']
💡 无论哪种客户端,核心都只有两件事:启动命令(
python)和参数(指向mcp_cheatengine.py的路径)。改完记得重启客户端。
第3步:用 ping 工具验证连接
配置完成后,让 AI 调用 ping 工具测试连通性。成功时会返回:
{"success": true, "version": "12.0.0", "message": "CE MCP Bridge Active"}
看到 success: true 就说明链路已打通。此时 process_id: 0 属正常现象,表示桥接已连接、但 Cheat Engine 尚未附加到目标进程。
第4步:开始用自然语言驱动 Cheat Engine
现在你可以直接"对话"了,例如:
"现在附加的是哪个进程?"
"读取基址处的 16 个字节"
"反汇编入口点"
"扫描金币:15000"
"金币变成了 15100"
"第一个结果是被谁写入的?"
一个典型流程:扫描金币 → 用变化值过滤 → 让 AI 打硬件断点定位写入者 → 反汇编出加币函数逻辑,全程只需提问。🚀
进阶:跨平台接入(TCP 中转)
命名管道模式是 Windows 专属(依赖 pywin32)。如果你的 AI 客户端跑在 WSL、Linux 主机、容器或远程机器上,而 Cheat Engine 在 Windows 里,可以用 TCP 中转把两者连起来,Lua 桥无需改动:
- Windows 侧:照常加载 MCP_Server/ce_mcp_bridge.lua,然后启动中转:
python C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_tcp_relay.py --host 127.0.0.1 --port 9876
- 客户端所在环境:安装精简依赖 MCP_Server/requirements-tcp.txt(只含
mcp,无需pywin32):
python3 -m pip install -r MCP_Server/requirements-tcp.txt
- 通过环境变量指定 TCP 传输(适合支持
env的客户端配置):
{
"servers": {
"cheatengine": {
"command": "python3",
"args": ["/path/to/MCP_Server/mcp_cheatengine.py"],
"env": {
"CE_MCP_TRANSPORT": "tcp",
"CE_MCP_HOST": "127.0.0.1",
"CE_MCP_PORT": "9876"
}
}
}
}
⚠️ 安全提醒:中转只能绑定可信网络接口,因为任何能连上它的人都可以控制你的 Cheat Engine 桥接。
常见问题排查:连不上 Cheat Engine 怎么办
按顺序检查以下几点,能解决绝大多数连接问题:
- Cheat Engine 是否打开,且显示
MCP Server Listening on: CE_MCP_Bridge_v99。 - 修改配置后是否重启了客户端。
- 配置里
mcp_cheatengine.py的路径是否存在且拼写正确。 pip install -r MCP_Server/requirements.txt是否装好了mcp和pywin32。- 手动运行
ping工具,success: true即表示连通。
遇到 "too many local variables" 提示? 请用 dofile(...) 从磁盘加载脚本,不要把整段桥接代码粘贴进 Cheat Table 脚本——否则会撞上 Cheat Engine 单个 Lua 块 200 个局部变量的上限。
安全须知(请务必了解)
- 仅用于教育与研究:本项目用于演示 MCP 与 LLM 调试能力,请勿用于多人游戏作弊或违反服务条款。
- 蓝屏防护:牢记上文"前提三",始终禁用 "Query memory region routines"。
- 反作弊安全:桥接优先使用硬件断点(DR0–DR3)与 DBVM 不可见追踪,避免软件断点(
0xCC)。 - Shell 开关默认关闭:只有显式设置环境变量
CE_MCP_ALLOW_SHELL=1才会启用run_command/shell_execute,存在任意代码执行风险,非必要请保持默认关闭。
写在最后
接入 Cheat Engine MCP Bridge 后,你不再需要是逆向高手——只要会"问对问题",AI 客户端就能替你完成大部分枯燥的内存分析工作。整个过程只有四步:装依赖 → 加载 Lua 桥 → 配置客户端 → ping 验证,几分钟即可跑通。快去让你的 AI 替你翻内存吧!
更多深度资料:架构与安全说明见 AI_Context/AI_Guide_MCP_Server_Implementation.md,Cheat Engine 7.6 Lua API 完整参考见 AI_Context/CE_LUA_Documentation.md。