AI导哈

内存调试工具

Cheat Engine MCP Bridge 是一个通过自然语言驱动AI代理进行内存分析、逆向工程、调试和游戏修改的工具。

  • by drdon1234
  • Lua
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 drdon1234/cheat-engine-mcp

使用说明

英语 | 中文 | 日本语 | 韩语 | 俄语 | 阿拉伯语

作弊引擎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——手动（每节课）：

  1. 打开作弊引擎
  2. 文件>执行脚本 >选择 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）用于软件分析自动化的能力。请勿将其用于恶意黑客攻击、多人游戏作弊或违反服务条款。

相关 MCP