Demo

Ponte MCP do Cheat Engine

Deixe datacenters de IA de bilhões de dólares analisarem a memória do programa para você.

Crie mods, trainers, auditorias de segurança, bots de jogos, acelere engenharia reversa, ou faça qualquer outra coisa com qualquer programa e jogo em uma fração do tempo.

[!NOTE] Obrigado a todos pelas estrelas, muito apreciado! <3

Um agradecimento especial a todos os contribuidores!!

@libangli218, @lauralex, @iamtyroon, @HachiroSan, @Attacktive

O Problema

Você está encarando gigabytes de memória. Milhões de endereços. Milhares de funções. Encontrar aquele ponteiro, aquela estrutura leva dias ou semanas de trabalho manual.

E se você pudesse simplesmente perguntar?

"Encontre o hook do descriptografador de pacotes."
"Encontre o OPcode das coordenadas do personagem."
"Encontre o OPcode dos valores de vida."
"Encontre o padrão AOB único para tornar seu trainer confiável após atualizações do jogo."

É exatamente isso que isso faz.

- Pare de clicar em dumps hexadecimais e comece a ter conversas com a memória.

O que você obtém:

Sua IA agora pode:

• Ler qualquer memória instantaneamente (inteiros, floats, strings, ponteiros)
• Seguir cadeias de ponteiros: [[base+0x10]+0x20]+0x8 → resolvido em ms
• Analisar automaticamente estruturas com tipos e valores de campos
• Identificar objetos C++ via RTTI: "Este é um objeto CPlayer"
• Desmontar e analisar funções
• Depurar invisivelmente com breakpoints de hardware + hipervisor Ring -1
• E muito mais!

Como Funciona

flowchart 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]

Instalação

pip install -r MCP_Server/requirements.txt

Ou manualmente:

pip install mcp pywin32

[!NOTE] O modo de pipe nativo é apenas para Windows porque usa pipes nomeados (pywin32). Use o transporte de relé TCP quando o servidor MCP for executado fora do ambiente Windows que hospeda o Cheat Engine e não puder abrir o pipe nomeado diretamente.

Início Rápido

1. Carregar a Bridge no Cheat Engine

1. Habilite o DBVM no Cheat Engine se você planeja usar ferramentas DBVM.
2. Abra o Lua Engine ou executor de scripts do Cheat Engine.
   • Preferido: File -> Execute Script -> abra MCP_Server/ce_mcp_bridge.lua -> Execute.
   • Se a sua versão do Cheat Engine não mostrar File -> Execute Script, use Table -> Show Cheat Table Lua Script, cole a linha dofile(...) abaixo e execute:

dofile([[C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_mcp_bridge.lua]])

Procure por: [MCP v12.0.0] MCP Server Listening on: CE_MCP_Bridge_v99

2. Configurar o Cliente MCP

Adicione à sua configuração MCP (ex.: mcp_config.json):

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

Reinicie a IDE para carregar a configuração do servidor MCP.

Para Codex, adicione um bloco de servidor TOML em ~/.codex/config.toml:

[mcp_servers.cheatengine]
command = "python"
args = ['C:\path\to\cheatengine-mcp-bridge\MCP_Server\mcp_cheatengine.py']

Use aspas simples para o caminho do Windows para que o TOML trate as barras invertidas literalmente.

Transporte de relé TCP

O relé TCP permite que mcp_cheatengine.py converse com o Cheat Engine através de um socket TCP em vez de abrir o pipe nomeado do Windows diretamente. O Cheat Engine e a bridge Lua ainda são executados no Windows, enquanto o servidor MCP pode ser executado em qualquer lugar que consiga alcançar o relé: outro processo Windows, uma VM, um container, um host Linux ou uma máquina remota. Isso também pode ser usado com WSL sem modificar a bridge Lua.

1. No Windows, carregue MCP_Server/ce_mcp_bridge.lua no Cheat Engine como de costume.
2. No Windows, inicie o relé:

python C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_tcp_relay.py --host 127.0.0.1 --port 9876

3. No ambiente onde o servidor MCP será executado, instale a dependência MCP sem pywin32 e então execute/configure o servidor MCP com 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 configurações de cliente MCP que suportam variáveis de ambiente:

{
  "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"
      }
    }
  }
}

Defina --host no relé e CE_MCP_HOST no servidor MCP para endereços que correspondam à sua configuração de rede. Mantenha o relé vinculado apenas a interfaces confiáveis, porque qualquer um que possa alcançá-lo pode controlar a bridge do Cheat Engine.

3. Verificar Conexão

Use a ferramenta ping para verificar a conectividade:

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

4. Comece a Fazer Perguntas

"Qual processo está anexado?"
"Leia 16 bytes no endereço base"
"Desmonte o ponto de entrada"

~180 Ferramentas MCP Disponíveis

Memória

Análise

Depuração

Ciclo de Vida do Processo

Alocação de Memória

Injeção de Código

Gerenciamento de Símbolos

Montagem / Compilação

Janela / Automação de GUI

Automação de Entrada

Tabela de Cheats

Modo Kernel (DBK / DBVM)

E muitas mais em AI_Context/MCP_Bridge_Command_Reference.md

Configuração Crítica

Prevenção de BSOD

[!CAUTION] Você DEVE desabilitar: Cheat Engine → Configurações → Extra → "Query memory region routines"

Habilitado: Causa BSODs CLOCK_WATCHDOG_TIMEOUT devido a conflitos com DBVM/Anti-Cheat ao escanear páginas protegidas.

Solução de Problemas

Cheat Engine diz "too many local variables"

Carregue a bridge a partir do disco com dofile(...) em vez de colar o script completo em um script de tabela de cheats. A bridge também declara manipuladores de comando como funções globais intencionalmente; isso evita o limite de chunks Lua do Cheat Engine de 200 variáveis locais quando a bridge completa é compilada de uma só vez.

Cliente MCP não consegue conectar

Verifique nesta ordem:

1. O Cheat Engine está aberto e mostra MCP Server Listening on: CE_MCP_Bridge_v99.
2. O cliente MCP foi reiniciado após adicionar a configuração do servidor.
3. O caminho configurado para mcp_cheatengine.py existe.
4. pip install -r MCP_Server/requirements.txt instalou tanto mcp quanto pywin32.
5. Execute a ferramenta ping do MCP. Uma conexão bem-sucedida retorna success: true e a versão da bridge. process_id: 0 é normal até que o Cheat Engine seja anexado a um processo alvo.

Variáveis de Ambiente

Fluxos de Trabalho de Exemplo

Encontrando um valor:

Você: "Escaneie por ouro: 15000"  →  IA encontra 47 resultados
Você: "Ouro mudou para 15100"  →  IA filtra para 3 endereços
Você: "O que escreve no primeiro?"  →  IA define BP de hardware
Você: "Desmonte essa função"  →  Lógica completa de AddGold revelada

Entendendo uma estrutura:

Você: "O que tem em [[game.exe+0x1234]+0x10]?"
IA: "RTTI: CPlayerInventory"
IA: "0x00=vtable, 0x08=itemCount(int), 0x10=itemArray(ptr)..."

Estrutura do Projeto

CLAUDE.md                               # Orientação do agente Claude Code (este repositório)
README.md                               # Documentação para o usuário

MCP_Server/
├── mcp_cheatengine.py                  # Servidor MCP Python (FastMCP)
├── ce_mcp_bridge.lua                   # Bridge Lua do Cheat Engine
└── test_mcp.py                         # Conjunto de testes

AI_Context/
├── BATCH_WORKER_BRIEFING.md            # Especificações de tarefas para trabalhadores paralelos (revisão v12)
├── MCP_Bridge_Command_Reference.md     # Referência de comandos MCP
├── CE_LUA_Documentation.md             # Documentação oficial completa do CheatEngine 7.6
└── AI_Guide_MCP_Server_Implementation.md  # Documentação técnica completa para o agente de IA

Testes

Executando o teste:

python MCP_Server/test_mcp.py

Saída esperada:

✅ 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)

Conclusão

Você não precisa mais ser um especialista. Apenas faça as perguntas certas.

⚠️ AVISO EDUCACIONAL

Este código é apenas para fins educacionais e de pesquisa. Ele foi criado para demonstrar as capacidades do Model Context Protocol (MCP) e da depuração baseada em LLM. Não endosso o uso dessas ferramentas para hacking malicioso, trapaça em jogos multiplayer ou violação de Termos de Serviço. Esta é uma demonstração de automação de engenharia de software.