英语 | 中文 | 日本语 | 韩语 | 俄语 | 阿拉伯语
作弊引擎MCP桥
让AI代理通过Cheat Engine读取、写入、扫描和调试任何进程。
120个MCP工具，用于内存分析、逆向工程、调试和游戏建模——所有这些工具都由自然语言通过任何兼容MCP的AI代理（Claude、Cursor、Copilot等）驱动。
\[！注意\] 谢谢大家的星星，非常感谢！3.
______________________________________________________________________
快速开始
先决条件
- 视窗 （必需--使用命名管道）
- 作弊引擎7.x 安装
- Python 3.10+ 使用pip
步骤1：安装Python依赖项
pip install mcp pywin32第二步：在作弊引擎中加载网桥
选项A——手动（每节课）：
- 打开作弊引擎
- 文件>执行脚本 >选择
lua/ce_mcp_bridge.lua> 执行
选项B——自动加载（推荐）： 复制 lua/ce_mcp_bridge.lua 进入作弊引擎 autorun 目录，因此每次CE启动时都会加载：
C:\Program Files\Cheat Engine 7.x\autorun\ce_mcp_bridge.lua加载后，确认输出： [MCP v11.4.0] Server started on CE_MCP_Bridge_v99，然后像往常一样附加到目标进程。
步骤3：配置您的AI客户端
将以下内容添加到MCP客户端配置中（替换 C:/path/to/cheat-engine-mcp 使用实际的克隆路径）：
{
"mcpServers": {
"cheatengine": {
"command": "python",
"args": ["-m", "ce_mcp"],
"env": {
"PYTHONPATH": "C:/path/to/cheat-engine-mcp"
}
}
}
}配置文件位置：
- 光标:
~/.cursor/mcp.json - 反重力:
~/.antigravity/mcp.json - 克劳德桌面:
%APPDATA%\Claude\claude_desktop_config.json
步骤4：验证
问你的AI代理： *“Ping作弊引擎桥”*
预期： {"success": true, "version": "11.4.0", "message": "CE MCP Bridge Active"}
______________________________________________________________________
它能做什么？
| 类别 | 工具 | 示例 |
|---|---|---|
| 记忆 | 读/写整数、浮点数、字符串、原始字节、指针链 | read_pointer_chain("game.exe+0x1234", [0x10, 0x20, 0x8]) |
| 扫描 | 值扫描、AOB模式扫描、字符串搜索、下一次扫描 | scan_all("1000") 然后 next_scan("999") |
| 分析 | 分解、分析函数、查找引用、RTTI、结构 | disassemble("game.exe+0x5000", 20) |
| 调试 | 硬件/软件断点，查找写入/访问内容，步进 | find_what_writes("0x12345678", timeout=5) |
| 作弊桌 | 创建/修改/删除条目、脚本、热键、保存/加载。CT文件 | create_table_entry("Infinite HP", address="game.exe+0x1234") |
| DBVM | 隐形环-1跟踪、代码隐藏、寄存器修改 | start_dbvm_watch("0x12345678", mode="w") |
| 脚本编写 | 执行Lua、Auto Assembler，生成注射模板 | generate_aob_injection("game.exe+0x5000") |
| 过程 | 附加、枚举模块/线程、解析符号 | open_process("game.exe") |
API完整参考： ce_mcp/ai_docs/command_reference.md
______________________________________________________________________
建筑
flowchart LR
AI["AI Agent\n(Claude / Cursor / Copilot)"]
PY["Python MCP Server\npython -m ce_mcp"]
PIPE["Named Pipe\nCE_MCP_Bridge_v99"]
LUA["Lua Bridge\nce_mcp_bridge.lua"]
TARGET["Target Process"]
AI -->|"MCP (JSON-RPC / stdio)"| PY
PY |"Binary-framed JSON-RPC"| PIPE
PIPE |"Worker Thread"| LUA
LUA -->|"CE API calls\n(main thread sync)"| TARGET- Python端 (
ce_mcp/)：将MCP工具调用转换为命名管道命令。无国籍——所有州都住在CE。 - Lua侧 (
lua/ce_mcp_bridge.lua)：在CE内部运行。工人螺纹处理管道I/O；命令通过以下方式在主线程上执行thread.synchronize因此，所有CE API都可以安全调用。 - 协议：4字节小端长度标头+UTF-8 JSON-RPC 2.0正文。
______________________________________________________________________
示例工作流
查找并冻结一个值：
You: "Scan for gold: 15000" → AI calls scan_all("15000")
You: "Gold changed to 15100" → AI calls next_scan("15100"), finds 3 addresses
You: "What writes to the first one?" → AI calls find_what_writes(addr, timeout=5)
You: "Generate an AOB injection for it" → AI calls generate_aob_injection(addr)对结构进行逆向工程：
You: "What's at [[game.exe+0x1234]+0x10]?"
AI: reads pointer chain, identifies RTTI: CPlayerInventory
AI: "0x00=vtable, 0x08=itemCount(int:24), 0x10=itemArray(ptr)..."______________________________________________________________________
关键配置
\[！小心\] 您必须禁用： 作弊引擎>设置>额外> “查询内存区域例程” 让它成为可能的原因 CLOCK_WATCHDOG_TIMEOUT DBVM或防作弊与内存区域扫描冲突时的BSOD。______________________________________________________________________
项目结构
ce_mcp/ # Python MCP Server package
├── __main__.py # Entry point (python -m ce_mcp)
├── server.py # FastMCP instance
├── client.py # Named-pipe bridge client
├── protocol.py # Shared constants
├── _compat.py # Windows stdio patch
├── tools/ # 120 MCP tools
│ ├── _helpers.py # Shared tool utilities
│ ├── process.py # Process, modules, version
│ ├── memory.py # Read / write / allocate
│ ├── scanning.py # Value & pattern scanning
│ ├── analysis.py # Disassembly, structures, symbols
│ ├── debugger.py # Breakpoints, debugger, threads
│ ├── cheat_table.py # Cheat table operations
│ ├── dbvm.py # DBVM hypervisor (Ring -1)
│ └── scripting.py # Lua eval, AA, injection gen
└── ai_docs/ # AI knowledge base
├── command_reference.md # Full API reference (all 120 tools)
├── tool_guide.md # AI agent usage guide
└── ce_lua_api.md # CE 7.6 Lua API reference
lua/ce_mcp_bridge.lua # Cheat Engine Lua bridge
tests/ # Test suite
├── test_bridge.py # Low-level pipe protocol tests
├── test_lang_display.py # Multi-language dialog tests
└── test_safe_tools.py # Comprehensive safe-tools tests
docs/ # Human-facing translations
├── README_zh.md # 中文
├── README_ja.md # 日本語
├── README_ko.md # 한국어
├── README_ru.md # Русский
└── README_ar.md # العربية
requirements.txt # pip dependencies______________________________________________________________________
致谢
核心代码来源于 cheatengine-mcp桥 通过miscusi peek。
______________________________________________________________________
免责声明
这个项目是为了 仅用于教育和研究目的它展示了模型上下文协议（MCP）用于软件分析自动化的能力。请勿将其用于恶意黑客攻击、多人游戏作弊或违反服务条款。