miscusi-peek/cheatengine-mcp-bridgeConnectez vos agents IA préférés directement à Cheat Engine via MCP. Automatisez l'ingénierie inverse, le scan de pointeurs et l'analyse mémoire en langage naturel.
Laissez les centres de données IA de plusieurs milliards de dollars analyser la mémoire du programme pour vous.
Créez des mods, des trainers, des audits de sécurité, des bots de jeu, accélérez la rétro-ingénierie, ou faites tout autre chose avec n'importe quel programme et jeu en une fraction de temps.
[!NOTE] Merci à tous pour les étoiles, c'est très apprécié ! <3
Un grand merci tout spécialement à tous les contributeurs !!
@libangli218, @lauralex, @iamtyroon, @HachiroSan, @Attacktive
Vous fixez des gigaoctets de mémoire. Des millions d'adresses. Des milliers de fonctions. Trouver ce pointeur, cette structure demande des jours ou des semaines de travail manuel.
Et si vous pouviez simplement demander ?
"Trouver le hook de déchiffrement de paquets."
"Trouver l'OPcode des coordonnées du personnage."
"Trouver l'OPcode des valeurs de santé."
"Trouver le motif AOB unique pour rendre mon trainer fiable après les mises à jour du jeu."
C'est exactement ce que ça fait.
- Arrêtez de cliquer dans des hex dumps et commencez à converser avec la mémoire.
| Avant (Manuel) | Après (Agent IA + MCP) |
|---|---|
| Jour 1 : Trouver l'adresse du paquet | Minute 1 : "Trouver le hook de déchiffrement de paquets RX" |
| Jour 2 : Tracer ce qui y écrit | Minute 3 : "Générer une signature AOB unique pour le rendre persistant après mise à jour" |
| Jour 3 : Trouver le hook RX | Minute 6 : "Trouver les OPcodes de mouvement" |
| Jour 4 : Documenter la structure | Minute 10 : "Créer un interpréteur Python de l'hexadécimal en texte brut" |
| Jour 5 : Mise à jour du jeu, recommencer | Fini. |
Votre IA peut maintenant :
[[base+0x10]+0x20]+0x8 → résolu 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
Ou manuellement :
pip install mcp pywin32
[!NOTE] Le mode pipe natif est Windows uniquement car il utilise des Named Pipes (
pywin32). Utilisez le transport par relais TCP lorsque le serveur MCP s'exécute en dehors de l'environnement Windows qui héberge Cheat Engine et ne peut pas ouvrir le pipe nommé directement.
Fichier -> Exécuter un script -> ouvrir MCP_Server/ce_mcp_bridge.lua -> Exécuter.Fichier -> Exécuter un script, utilisez Table -> Afficher le script Lua de la cheat table, collez la ligne dofile(...) ci-dessous, et exécutez-la :dofile([[C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_mcp_bridge.lua]])
Recherchez : [MCP v12.0.0] MCP Server Listening on: CE_MCP_Bridge_v99
Ajoutez à votre configuration MCP (par exemple, mcp_config.json) :
{
"servers": {
"cheatengine": {
"command": "python",
"args": ["C:/path/to/MCP_Server/mcp_cheatengine.py"]
}
}
}
Redémarrez l'IDE pour charger la configuration du serveur MCP.
Pour Codex, ajoutez un bloc de serveur TOML dans ~/.codex/config.toml :
[mcp_servers.cheatengine]
command = "python"
args = ['C:\path\to\cheatengine-mcp-bridge\MCP_Server\mcp_cheatengine.py']
Utilisez des guillemets simples pour le chemin Windows afin que TOML traite les antislashes littéralement.
Le relais TCP permet à mcp_cheatengine.py de communiquer avec Cheat Engine via une socket TCP au lieu d'ouvrir directement le pipe nommé Windows. Cheat Engine et le pont Lua restent sous Windows, tandis que le serveur MCP peut s'exécuter partout où il peut atteindre le relais : un autre processus Windows, une VM, un conteneur, un hôte Linux ou une machine distante. Cela peut également être utilisé avec WSL sans modifier le pont Lua.
MCP_Server/ce_mcp_bridge.lua dans Cheat Engine comme d'habitude.python C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_tcp_relay.py --host 127.0.0.1 --port 9876
pywin32, puis exécutez/configurez le serveur MCP avec le transport 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
Pour les configurations client MCP qui prennent en charge les variables d'environnement :
{
"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"
}
}
}
}
Définissez --host sur le relais et CE_MCP_HOST sur le serveur MCP pour correspondre à votre configuration réseau. Liez le relais uniquement aux interfaces de confiance, car quiconque peut l'atteindre peut contrôler le pont Cheat Engine.
Utilisez l'outil ping pour vérifier la connectivité :
{"success": true, "version": "12.0.0", "message": "CE MCP Bridge Active"}
"Quel processus est attaché ?"
"Lire 16 octets à l'adresse de base"
"Désassembler le point d'entrée"
| Outil | Description |
|---|---|
read_memory, read_integer, read_string | Lire n'importe quel type de données |
read_pointer_chain | Suivre les chemins [[base+0x10]+0x20] |
scan_all, aob_scan | Trouver des valeurs et des motifs d'octets |
| Outil | Description |
|---|---|
disassemble, analyze_function | Analyse de code |
dissect_structure | Détection automatique des champs et des types |
get_rtti_classname | Identifier les types d'objets C++ |
find_references, find_call_references | Références croisées |
| Outil | Description |
|---|---|
set_breakpoint, set_data_breakpoint | Points d'arrêt matériels |
start_dbvm_watch | Traçage invisible Ring -1 |