CE-MCP — Cheat Engine MCP Server (纯 Python / 零依赖)

让 AI（Claude Desktop、VS Code Copilot、Cursor 等任意 MCP 客户端）直接操控 Cheat Engine： 进程附加、内存扫描、内存读写、地址列表、变速、Lua/Auto Assembler 执行、CT 表管理。

特点

• 纯 Python 标准库实现，无任何外部依赖，无需编译，无需 .NET / Visual Studio

• 标准 MCP 协议（stdio 传输），任何 MCP 客户端开箱即用

• 文件 IPC 桥接：CE 侧只需一个 autorun Lua 脚本，兼容 CE 7.x（无需 7.6.2+ 插件 API）

• 29 个工具，9 大模块：进程管理 / 首次·再次扫描 / AOB 特征码 / 内存读写(含批量·冻结) / 地址列表 / SpeedHack / Lua 执行 / 汇编·反汇编 / CT 文件

Related MCP server: ce-mcp

架构

MCP 客户端 (Claude 等)
   │ stdio (JSON-RPC / MCP)
ce_mcp_server.py (Python)
   │ 文件 IPC: c_X.txt(命令) → go.txt(触发) → r_X.txt(结果) → d_X.txt(完成)
autorun/ce_mcp.lua (CE 内 200ms 定时器轮询)
   │ CE Lua API
Cheat Engine → 目标进程

安装

1. 把 autorun/ce_mcp.lua 复制到 Cheat Engine 安装目录的 autorun\ 文件夹

2. （可选）复制 config.example.json 为 config.json 并按本机路径修改：

   {
     "ce_exe": "C:\\Program Files\\Cheat Engine 7.5\\cheatengine-x86_64.exe",
     "ipc_dir": "C:\\Program Files\\Cheat Engine 7.5\\ce-mcp\\ipc"
   }

   • ipc_dir 必须与 Lua 端一致。Lua 端默认使用 <CE目录>\ce-mcp\ipc\；不配置时 Python 端默认使用本仓库目录下的 ipc\，此时请在 ce_mcp.lua 顶部把 IPC_DIR 改成相同路径

   • ce_exe 用于 CE 未运行时自动拉起（可省略，手动启动 CE 即可）

3. 启动 Cheat Engine（autorun 自动加载桥接脚本）

4. 在 MCP 客户端中配置本服务器，例如 Claude Desktop claude_desktop_config.json：

   {
     "mcpServers": {
       "cheat-engine": {
         "command": "python",
         "args": ["X:\\path\\to\\ce-mcp\\ce_mcp_server.py"]
       }
     }
   }

要求：Windows + Python 3.8+ + Cheat Engine 7.x。

工具一览

测试

CE 运行且 autorun 脚本加载后：

python tests\test_all_tools.py

历史测试报告见 docs/TEST_REPORT.md（其中记录的 4 个 Bug 已在当前版本修复）。

与同类项目的区别

• ShadowNineX/ce-mcp：C# 插件 DLL + HTTP MCP，需 CE 7.6.2+ 与 .NET 10 运行时

• Eruditi/CE-MCP-Plugin：C 插件 + 自定义 TCP 协议（非 MCP）

• 本项目：纯 Python + stdio 标准 MCP + 文件 IPC，零依赖零编译，安装门槛最低

免责声明

本项目仅用于学习、研究与单机环境调试。请勿用于在线游戏或任何违反服务条款/法律法规的用途，后果自负。

License

MIT