miscusi-peek/cheatengine-mcp-bridgeConecta tus agentes de IA favoritos directamente a Cheat Engine mediante MCP. Automatiza la ingeniería inversa, el escaneo de punteros y el análisis de memoria usando lenguaje natural.
Permite que centros de datos de IA multimillonarios analicen la memoria del programa por ti.
Crea mods, trainers, auditorías de seguridad, bots de juegos, acelera la ingeniería inversa, o haz cualquier otra cosa con cualquier programa y juego en una fracción del tiempo.
[!NOTE] ¡Gracias a todos por las estrellas, muy apreciado! <3
Especialmente un gran agradecimiento a todos los colaboradores!!
@libangli218, @lauralex, @iamtyroon, @HachiroSan, @Attacktive
Estás mirando gigabytes de memoria. Millones de direcciones. Miles de funciones. Encontrar ese puntero, esa estructura lleva días o semanas de trabajo manual.
¿Qué tal si pudieras simplemente preguntar?
"Encuentra el hook del descifrador de paquetes."
"Encuentra el OPcode de las coordenadas del personaje."
"Encuentra el OPcode de los valores de salud."
"Encuentra el patrón AOB único para hacer que mi trainer sea confiable después de las actualizaciones del juego."
Eso es exactamente lo que esto hace.
- Deja de hacer clic en volcados hexadecimales y comienza a tener conversaciones con la memoria.
| Antes (Manual) | Después (Agente IA + MCP) |
|---|---|
| Día 1: Encontrar dirección del paquete | Minuto 1: "Encontrar hook de descifrado de paquetes RX" |
| Día 2: Rastrear qué escribe en ella | Minuto 3: "Generar firma AOB única para hacerla persistente a actualizaciones" |
| Día 3: Encontrar hook RX | Minuto 6: "Encontrar OPcodes de movimiento" |
| Día 4: Documentar estructura | Minuto 10: "Crear intérprete de Python de hex a texto plano" |
| Día 5: Actualizaciones del juego, empezar de nuevo | Hecho. |
Tu IA ahora puede:
[[base+0x10]+0x20]+0x8 → resuelto en msflowchart TD
AI[AI Agent: Claude/Cursor/Copilot]
AI -->|MCP Protocol - JSON-RPC over stdio| MCP
MCP[mcp_cheatengine.py - Python MCP Server]
MCP <-->|Named Pipe - Async| PIPE
PIPE["\\.\\pipe\\CE_MCP_Bridge_v99"]
PIPE <--> CE
subgraph CE[Cheat Engine - DBVM Mode]
subgraph LUA[ce_mcp_bridge.lua]
WORKER[Worker Thread - Blocking I/O]
MAIN[Main Thread - GUI + CE API]
WORKER <-->|Sync| MAIN
end
end
MAIN -->|Memory Access| TARGET[Target .exe]
pip install -r MCP_Server/requirements.txt
O manualmente:
pip install mcp pywin32
[!NOTE] El modo de pipe nativo es solo para Windows porque usa Named Pipes (
pywin32). Usa el transporte de relay TCP cuando el servidor MCP se ejecute fuera del entorno Windows que aloja Cheat Engine y no pueda abrir el named pipe directamente.
File -> Execute Script -> abrir MCP_Server/ce_mcp_bridge.lua -> Execute.File -> Execute Script, usa Table -> Show Cheat Table Lua Script, pega la línea dofile(...) a continuación, y ejecútala:dofile([[C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_mcp_bridge.lua]])
Busca: [MCP v12.0.0] MCP Server Listening on: CE_MCP_Bridge_v99
Agrega a tu configuración MCP (ej., mcp_config.json):
{
"servers": {
"cheatengine": {
"command": "python",
"args": ["C:/path/to/MCP_Server/mcp_cheatengine.py"]
}
}
}
Reinicia el IDE para cargar la configuración del servidor MCP.
Para Codex, agrega un bloque de servidor TOML a ~/.codex/config.toml:
[mcp_servers.cheatengine]
command = "python"
args = ['C:\path\to\cheatengine-mcp-bridge\MCP_Server\mcp_cheatengine.py']
Usa comillas simples para la ruta de Windows para que TOML trate las barras invertidas literalmente.
El relay TCP permite que mcp_cheatengine.py se comunique con Cheat Engine a través de un socket TCP en lugar de abrir el named pipe de Windows por sí mismo. Cheat Engine y el puente Lua aún se ejecutan en Windows, mientras que el servidor MCP puede ejecutarse en cualquier lugar que pueda alcanzar el relay: otro proceso de Windows, una VM, un contenedor, un host Linux o una máquina remota. Esto también se puede usar con WSL sin cambiar el puente Lua.
MCP_Server/ce_mcp_bridge.lua en Cheat Engine como de costumbre.python C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_tcp_relay.py --host 127.0.0.1 --port 9876
pywin32, luego ejecuta/configura el servidor MCP con transporte 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
Para configuraciones de cliente MCP que soporten variables de entorno:
{
"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"
}
}
}
}
Configura --host en el relay y CE_MCP_HOST en el servidor MCP con direcciones que coincidan con tu configuración de red. Mantén el relay vinculado solo a interfaces de confianza, porque cualquiera que pueda alcanzarlo puede controlar el puente de Cheat Engine.
Usa la herramienta ping para verificar la conectividad:
{"success": true, "version": "12.0.0", "message": "CE MCP Bridge Active"}
"¿Qué proceso está adjunto?"
"Lee 16 bytes en la dirección base"
"Desensambla el punto de entrada"
| Herramienta | Descripción |
|---|---|
read_memory, read_integer, read_string | Lee cualquier tipo de dato |
read_pointer_chain | Sigue rutas [[base+0x10]+0x20] |
scan_all, aob_scan | Encuentra valores y patrones de bytes |
| Herramienta | Descripción |
|---|---|
disassemble, analyze_function | Análisis de código |
dissect_structure | Detecta automáticamente campos y tipos |
get_rtti_classname | Identifica tipos de objetos C++ |
find_references, find_call_references | Referencias cruzadas |
| Herramienta | Descripción |
|---|---|
set_breakpoint, set_data_breakpoint | Puntos de interrupción de hardware |
start_dbvm_watch | Rastreo invisible Ring -1 |