miscusi-peek/cheatengine-mcp-bridgeПодключите своих любимых AI-агентов напрямую к Cheat Engine через MCP. Автоматизируйте реверс-инжиниринг, сканирование указателей и анализ памяти с помощью естественного языка.
Позвольте многомиллиардным дата-центрам ИИ анализировать память программ за вас.
Создавайте моды, тренеры, аудит безопасности, игровых ботов, ускоряйте реверс-инжиниринг или делайте что угодно с любой программой и игрой в разы быстрее.
[!NOTE] Спасибо всем за звёзды, очень ценю! <3
Особая благодарность всем контрибьюторам!!
@libangli218, @lauralex, @iamtyroon, @HachiroSan, @Attacktive
Вы смотрите на гигабайты памяти. Миллионы адресов. Тысячи функций. Поиск того самого указателя, той самой структуры занимает дни или недели ручной работы.
Что, если бы вы могли просто спросить?
"Найди хук расшифровщика пакетов." "Найди опкод координат персонажа." "Найди опкод значений здоровья." "Найди уникальный AOB-паттерн, чтобы мой тренер был надёжным после обновлений игры."
Именно это и делает этот инструмент.
– Хватит кликать по hex-дампам, начните общаться с памятью.
| До (вручную) | После (AI-агент + MCP) |
|---|---|
| День 1: Найти адрес пакета | Минута 1: "Найди хук расшифровки RX-пакетов" |
| День 2: Отследить, что пишет по этому адресу | Минута 3: "Сгенерируй уникальную AOB-сигнатуру, чтобы она сохранялась после обновлений" |
| День 3: Найти RX-хук | Минута 6: "Найди опкоды движения" |
| День 4: Документировать структуру | Минута 10: "Создай python-интерпретатор hex в обычный текст" |
| День 5: Обновление игры, начать заново | Готово. |
Теперь ваш ИИ может:
[[base+0x10]+0x20]+0x8 → разрешено за миллисекундыflowchart TD
AI[AI-агент: Claude/Cursor/Copilot]
AI -->|Протокол MCP - JSON-RPC через stdio| MCP
MCP[mcp_cheatengine.py - Python MCP-сервер]
MCP <-->|Именованный канал - Асинхронно| PIPE
PIPE["\\.\\pipe\\CE_MCP_Bridge_v99"]
PIPE <--> CE
subgraph CE[Cheat Engine - Режим DBVM]
subgraph LUA[ce_mcp_bridge.lua]
WORKER[Рабочий поток - блокирующий ввод/вывод]
MAIN[Главный поток - GUI + API Cheat Engine]
WORKER <-->|Синхронно| MAIN
end
end
MAIN -->|Доступ к памяти| TARGET[Целевой .exe]
pip install -r MCP_Server/requirements.txt
Или вручную:
pip install mcp pywin32
[!NOTE] Режим нативных каналов доступен только в Windows, так как используются именованные каналы (
pywin32). Используйте TCP-ретранслятор, когда MCP-сервер работает вне среды Windows, на которой запущен Cheat Engine, и не может напрямую открыть именованный канал.
File -> Execute Script -> откройте MCP_Server/ce_mcp_bridge.lua -> Execute.File -> Execute Script, используйте Table -> Show Cheat Table Lua Script, вставьте строку dofile(...) ниже и выполните: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
Добавьте в конфигурацию MCP (например, mcp_config.json):
{
"servers": {
"cheatengine": {
"command": "python",
"args": ["C:/path/to/MCP_Server/mcp_cheatengine.py"]
}
}
}
Перезапустите IDE, чтобы загрузить конфигурацию MCP-сервера.
Для Codex добавьте блок сервера TOML в ~/.codex/config.toml:
[mcp_servers.cheatengine]
command = "python"
args = ['C:\path\to\cheatengine-mcp-bridge\MCP_Server\mcp_cheatengine.py']
Используйте одинарные кавычки для пути Windows, чтобы TOML обрабатывал обратные слеши буквально.
TCP-ретранслятор позволяет mcp_cheatengine.py общаться с Cheat Engine через TCP-сокет, а не открывать самому Windows-именованный канал. Cheat Engine и Lua-мост по-прежнему работают в Windows, а MCP-сервер может работать где угодно, откуда есть доступ к ретранслятору: другой процесс Windows, виртуальная машина, контейнер, Linux-хост или удалённая машина. Это также можно использовать с WSL без изменения Lua-моста.
MCP_Server/ce_mcp_bridge.lua в Cheat Engine как обычно.python C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_tcp_relay.py --host 127.0.0.1 --port 9876
pywin32, затем запустите/настройте MCP-сервер с TCP-транспортом:python3 -m pip install -r MCP_Server/requirements-tcp.txt
CE_MCP_TRANSPORT=tcp \
CE_MCP_HOST=127.0.0.1 \
CE_MCP_PORT=9876 \
python3 /path/to/cheatengine-mcp-bridge/MCP_Server/mcp_cheatengine.py
Для конфигураций MCP-клиента, поддерживающих переменные окружения:
{
"servers": {
"cheatengine": {
"command": "python3",
"args": ["/path/to/cheatengine-mcp-bridge/MCP_Server/mcp_cheatengine.py"],
"env": {
"CE_MCP_TRANSPORT": "tcp",
"CE_MCP_HOST": "127.0.0.1",
"CE_MCP_PORT": "9876"
}
}
}
}
Установите --host на ретрансляторе и CE_MCP_HOST на MCP-сервере на адреса, соответствующие вашей сетевой конфигурации. Держите ретранслятор привязанным только к доверенным интерфейсам, потому что любой, кто имеет к нему доступ, может управлять мостом Cheat Engine.
Используйте инструмент ping для проверки связи:
{"success": true, "version": "12.0.0", "message": "CE MCP Bridge Active"}
"Какой процесс присоединён?"
"Прочитай 16 байт по базовому адресу"
"Дизассемблируй точку входа"
| Инструмент | Описание |
|---|---|
read_memory, read_integer, read_string | Чтение любого типа данных |
read_pointer_chain | Проход по пути [[base+0x10]+0x20] |
scan_all, aob_scan | Поиск значений и байтовых паттернов |
| Инструмент | Описание |
|---|---|
disassemble, analyze_function | Анализ кода |
dissect_structure | Автоопределение полей и типов |
get_rtti_classname | Определение типов C++-объектов |
find_references, find_call_references | Перекрёстные ссылки |
| Инструмент | Описание |
|---|---|
set_breakpoint, set_data_breakpoint | Аппаратные точки останова |
start_dbvm_watch | Невидимое трассирование Ring -1 |
| Инструмент | Описание |
|---|---|
open_process, get_process_list | Присоединение к запущенным процессам или их перечисление |
create_process | Запуск нового процесса под управлением CE |
pause_process, unpause_process | Приостановка / возобновление выполнения цели |