Cheat Engine Bridge

Подключайте AI-агентов к Cheat Engine. Автоматизируйте реверс-инжиниринг, анализ памяти и отладку с помощью естественного языка. Экономьте недели на модах для игр и аудите безопасности. Более быстрое сканирование указателей и анализ структур.

Разработка игр Безопасность и тестирование Data Science и ML ★ 48 GitHub (48 ★)

Cheat Engine Bridge позволяет AI-агентам, таким как Cursor, Copilot и Claude, напрямую взаимодействовать с Cheat Engine, значительно сокращая время и усилия, затрачиваемые на анализ памяти. Этот инструмент позволяет автоматизировать сложные задачи, такие как поиск конкретных указателей, анализ структур памяти, дизассемблирование функций и отладка приложений, с помощью запросов на естественном языке. Он превращает традиционно утомительный и ручной процесс обратной разработки и исследования игр в эффективный, управляемый ИИ диалог с памятью программы, ускоряя создание модов, тренеров и аудит безопасности.

Ключевые особенности

0148 звезд на GitHub

02Мгновенное чтение памяти любого типа, включая отслеживание сложных цепочек указателей.

03Автоматический анализ структур памяти, определение типов C++ объектов через RTTI и дизассемблирование функций.

04Поиск значений и AOB-паттернов (Array of Bytes) с помощью запросов на естественном языке.

05Установка аппаратных точек останова и использование Ring -1 гипервизора для невидимой отладки.

06Предоставляет полный набор из 39 MCP-инструментов для операций с памятью, анализа и отладки.

Варианты использования

01Быстрый поиск игровых значений, понимание структур памяти и разработка тренеров или модов для игр.

02Автоматизация задач обратной разработки для аудита безопасности и исследования уязвимостей.

03Эффективное определение критической логики программы и данных, таких как координаты персонажа или значения здоровья.

CE_MCP_Demo_2.mp4

Cheat Engine MCP Bridge

Let multibillion $ AI datacenters analyze the program memory for you.

Connect Cursor, Copilot, Antigravity or your favorite local AI agent via RooCode/Cline directly to Cheat Engine to create mods, trainers, security audits or do anything else with any program/game in a fraction of a time.

Note

Thanks everyone for the stars, much appreciated! <3

The Problem

You're staring at gigabytes of memory. Millions of addresses. Thousands of functions. Finding that one pointer, that one structure takes days or weeks of manual work.

What if you could just ask?

"Find the packet decryptor hook."
"Find the OPcode of character coordinates."
"Find the OPcode of health values."
"Find the unique AOB pattern to make my trainer reliable after game updates."

That's exactly what this does.

- Stop clicking through hex dumps and start having conversations with the memory.

What You Get:

Before (Manual)	After (AI Agent + MCP)
Day 1: Find packet address	Minute 1: "Find RX packet decryption hook"
Day 2: Trace what writes to it	Minute 3: "Generate unique AOB signature to make it update persistent"
Day 3: Find RX hook	Minute 6: "Find movement OPcodes"
Day 4: Document structure	Minute 10: "Create python interpreter of hex to plain text"
Day 5: Game updates, start over	Done.

Your AI can now:

Read any memory instantly (integers, floats, strings, pointers)
Follow pointer chains: [[base+0x10]+0x20]+0x8 → resolved in ms
Auto-analyze structures with field types and values
Identify C++ objects via RTTI: "This is a CPlayer object"
Disassemble and analyze functions
Debug invisibly with hardware breakpoints + Ring -1 hypervisor
And much more!

How It Works

┌────────────────────────────────────────────────────────────────────────┐
│  AI Agent (Claude/Cursor/Copilot)                                      │
│       │                                                                │
│       ▼ MCP Protocol (JSON-RPC over stdio)                             │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │  mcp_cheatengine.py (Python MCP Server)                         │   │
│  │  - Translates MCP tools to JSON-RPC                             │   │
│  │  - Connects to \\.\pipe\CE_MCP_Bridge_v99                       │   │
│  └───────────────────────────┬─────────────────────────────────────┘   │
│                           ▲  │ Named Pipe (Async)                      │
│                           │  ▼                                         │
│  ┌────────────────────────┴────────────────────────────────────────┐   │
│  │  CheatEngine (Running in DBVM, attached to .exe)                │   │
│  │  ┌─────────────────────────────────────────────────────────┐    │   │
│  │  │  ce_mcp_bridge.lua                                      │    │   │
│  │  │  ┌─────────────────┐      ┌─────────────────────┐       │    │   │
│  │  ���  │ Worker Thread   │◄────►│ Main Thread (GUI)   │       │    │   │
│  │  │  │ (Blocking I/O)  │ Sync │ (Safe API Execution)│       │    │   │
│  │  │  └─────────────────┘      └─────────────────────┘       │    │   │
│  │  └─────────────────────────────────────────────────────────┘    │   │
│  └─────────────────────────────────────────────────────────────────┘   │
└────────────────────────────────────────────────────────────────────────┘

Installation

pip install -r MCP_Server/requirements.txt

Or manually:

pip install mcp pywin32

Note

Windows only - Uses Named Pipes (pywin32)

Quick Start

1. Load Bridge in Cheat Engine

1. Enable DBVM in CheatEngine.
2. File → Execute Script → Open ce_mcp_bridge.lua → Execute

Look for: [MCP v11.4.0] Server started on \\.\pipe\CE_MCP_Bridge_v99

2. Configure MCP Client

Add to your MCP configuration (e.g., mcp_config.json):

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

Restart the IDE to load the MCP server config.

3. Verify Connection

Use the ping tool to verify connectivity:

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

4. Start Asking Questions

"What process is attached?"
"Read 16 bytes at the base address"
"Disassemble the entry point"

39 MCP Tools Available

Memory

Tool	Description
`read_memory`, `read_integer`, `read_string`	Read any data type
`read_pointer_chain`	Follow `[[base+0x10]+0x20]` paths
`scan_all`, `aob_scan`	Find values and byte patterns

Analysis

Tool	Description
`disassemble`, `analyze_function`	Code analysis
`dissect_structure`	Auto-detect fields and types
`get_rtti_classname`	Identify C++ object types
`find_references`, `find_call_references`	Cross-references

Debugging

Tool	Description
`set_breakpoint`, `set_data_breakpoint`	Hardware breakpoints
`start_dbvm_watch`	Ring -1 invisible tracing

And many more at AI_Context/MCP_Bridge_Command_Reference.md

Critical Configuration

BSOD Prevention

Caution

You MUST disable: Cheat Engine → Settings → Extra → "Query memory region routines"

Enabled: Causes CLOCK_WATCHDOG_TIMEOUT BSODs due to conflicts with DBVM/Anti-Cheat when scanning protected pages.

Example Workflows

Finding a value:

You: "Scan for gold: 15000"  →  AI finds 47 results
You: "Gold changed to 15100"  →  AI filters to 3 addresses
You: "What writes to the first one?"  →  AI sets hardware BP
You: "Disassemble that function"  →  Full AddGold logic revealed

Understanding a structure:

You: "What's at [[game.exe+0x1234]+0x10]?"
AI: "RTTI: CPlayerInventory"
AI: "0x00=vtable, 0x08=itemCount(int), 0x10=itemArray(ptr)..."

Project Structure

MCP_Server/
├── mcp_cheatengine.py      # Python MCP Server (FastMCP)
├── ce_mcp_bridge.lua   # Cheat Engine Lua Bridge
└── test_mcp.py # Test Suite

AI_Context/
├── MCP_Bridge_Command_Reference.md   # MCP Commands reference
├── CE_LUA_Documentation.md   # Full CheatEngine 7.6 official documentation
└── AI_Guide_MCP_Server_Implementation.md  # Full technical documentation for AI agent

Testing

Running the test:

python MCP_Server/test_mcp.py

Expected output:

✅ Memory Reading: 6/6 tests passed
✅ Process Info: 4/4 tests passed  
✅ Code Analysis: 8/8 tests passed
✅ Breakpoints: 4/4 tests passed
✅ DBVM Functions: 3/3 tests passed
✅ Utility Commands: 11/11 tests passed
⏭️ Skipped: 1 test (generate_signature)
──────────────────────────────────��─
Total: 36/37 PASSED (100% success)

The Bottom Line

You no longer need to be an expert. Just ask the right questions.

⚠️ EDUCATIONAL DISCLAIMER

This code is for educational and research purposes only. It's created to show the capabilities of the Model Context Protocol (MCP) and LLM-based debugging. I do not condone the use of these tools for malicious hacking, cheating in multiplayer games, or violating Terms of Service. This is a demonstration of software engineering automation.

Cheat Engine Bridge MCP

Обзор

Cheat Engine Bridge — это MCP-сервер (Model Context Protocol), который подключает AI-агентов (Claude, Cursor, Copilot, RooCode, Cline и др.) напрямую к Cheat Engine. Теперь можно не рыться в гигабайтах памяти вручную, а просто дать команду на естественном языке: «Найди хук расшифровщика пакетов», «Определи структуру CPlayer», «Сгенерируй AOB-сигнатуру». Сервер переводит запросы в JSON-RPC, отправляет их в Cheat Engine через именованный канал (Named Pipe), а тот выполняет операции чтения, записи, трассировки и дизассемблирования.

Предупреждение

Инструмент предназначен исключительно для образовательных и исследовательских целей. Не допускается его использование для взлома, читерства в многопользовательских играх или нарушения лицензионных соглашений. Это демонстрация возможностей MCP и автоматизации отладки.

Установка

Установи Python-зависимости:

pip install -r MCP_Server/requirements.txt

Или вручную:

pip install mcp pywin32

Важно: только Windows — сервер использует Windows Named Pipes (pywin32).

Загрузи мост в Cheat Engine:
- Включи DBVM (Cheat Engine → Settings → Extra → Enable DBVM).
- File → Execute Script → выбери ce_mcp_bridge.lua → Execute.
- В логе должно появиться: [MCP v11.4.0] Server started on \\.\pipe\CE_MCP_Bridge_v99.
Настрой MCP-клиент (например, в mcp_config.json твоего IDE/агента):

{
  "servers": {
    "cheatengine": {
      "command": "python",
      "args": ["C:/путь/до/MCP_Server/mcp_cheatengine.py"]
    }
  }
}

Перезапусти IDE для применения конфига.

Быстрый старт

Проверь подключение:

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

Теперь можно задавать вопросы:

«Какой процесс сейчас приаттачен?»
«Прочитай 16 байт по базовому адресу»
«Дизассемблируй точку входа»

Возможности (39 MCP-инструментов)

Память (Memory)

read_memory, read_integer, read_string — чтение любых типов данных
read_pointer_chain — разыменование цепочек указателей вида [[base+0x10]+0x20]
scan_all, aob_scan — поиск значений и байтовых паттернов

Анализ (Analysis)

disassemble, analyze_function — дизассемблирование и анализ кода
dissect_structure — автоопределение полей и типов структуры
get_rtti_classname — идентификация C++-объектов по RTTI (например, «Это CPlayer»)
find_references, find_call_references — перекрёстные ссылки

Отладка (Debugging)

set_breakpoint, set_data_breakpoint — аппаратные точки останова
start_dbvm_watch — невидимая трассировка на уровне гипервизора (Ring -1)

Полный список команд: AI_Context/MCP_Bridge_Command_Reference.md

Критическая настройка: предотвращение BSOD

Обязательно отключи настройку: Cheat Engine → Settings → Extra → «Query memory region routines».

Если она включена, при сканировании защищённых страниц памяти возникает конфликт с DBVM/античитом, вызывающий CLOCK_WATCHDOG_TIMEOUT (BSOD).

Примеры рабочих процессов

Поиск значения (например, «золото»)

Вы: «Просканируй память на значение 15000» → AI находит 47 результатов. Вы: «Значение изменилось на 15100» → AI фильтрует до 3 адресов. Вы: «Что пишет в первый адрес?» → AI устанавливает аппаратный брейкпоинт. Вы: «Дизассемблируй эту функцию» → AI показывает полную логику AddGold.

Анализ структуры

Вы: «Что находится по адресу [[game.exe+0x1234]+0x10]?» AI: «RTTI: CPlayerInventory. Смещения: +0x00=vtable, +0x08=itemCount(int), +0x10=itemArray(ptr)...»

Генерация устойчивого паттерна

Вместо того чтобы после каждого обновления игры заново искать адреса, попроси AI: «Сгенерируй уникальную AOB-сигнатуру для этой структуры, чтобы она работала после патча». AI найдёт стабильный байтовый паттерн.

Структура проекта

MCP_Server/
├── mcp_cheatengine.py      # MCP-сервер на Python (FastMCP)
├── ce_mcp_bridge.lua       # Lua-мост для Cheat Engine
└── test_mcp.py             # Набор тестов

AI_Context/
├── MCP_Bridge_Command_Reference.md   # Справочник команд MCP
├── CE_LUA_Documentation.md           # Полная документация API Cheat Engine 7.6
└── AI_Guide_MCP_Server_Implementation.md  # Техническая документация для AI

Тестирование

Запусти: python MCP_Server/test_mcp.py

Ожидаемый результат:

Заключение

Cheat Engine Bridge позволяет AI-агентам напрямую общаться с памятью процессов. Вместо дней ручного анализа — минуты диалога. Но помни: инструмент создан для исследований и автоматизации разработки, а не для нарушения правил.

Источник: https://mcpmarket.com/server/cheat-engine-bridge