데모

Cheat Engine MCP 브리지

수십억 달러 규모 AI 데이터센터가 프로그램 메모리를 분석하게 하세요.

모드, 트레이너, 보안 감사, 게임 봇을 만들고, 리버스 엔지니어링을 가속화하거나, 어떤 프로그램과 게임이든 훨씬 짧은 시간에 처리할 수 있습니다.

[!NOTE] 모든 분들의 별에 감사드립니다. 정말 감사합니다! <3

특히 모든 기여자분들께 큰 감사를 드립니다!!

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

문제 상황

수 기가바이트의 메모리를 바라보고 있습니다. 수백만 개의 주소. 수천 개의 함수. 저 하나의 포인터, 저 하나의 구조체를 찾는 데 며칠 또는 몇 주의 수작업이 필요합니다.

그냥 물어볼 수 있다면?

"패킷 복호화 후크를 찾아줘."
"캐릭터 좌표의 OPcode를 찾아줘."
"체력 값의 OPcode를 찾아줘."
"게임 업데이트 후에도 트레이너가 안정적으로 작동하도록 고유한 AOB 패턴을 찾아줘."

이것이 바로 이 도구가 하는 일입니다.

- 16진수 덤프를 클릭하며 시간을 낭비하지 말고, 메모리와 대화를 시작하세요.

제공되는 기능:

이제 AI가 다음을 수행할 수 있습니다:

• 모든 메모리를 즉시 읽기 (정수, 부동소수점, 문자열, 포인터)
• 포인터 체인 추적: [[base+0x10]+0x20]+0x8 → 밀리초 단위 해결
• 필드 유형 및 값을 포함한 구조체 자동 분석
• RTTI를 통해 C++ 객체 식별: "이것은 CPlayer 객체입니다"
• 함수 디스어셈블 및 분석
• 하드웨어 중단점 + Ring -1 하이퍼바이저를 사용한 보이지 않는 디버깅
• 그 외 다양한 기능!

작동 방식

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]

설치

pip install -r MCP_Server/requirements.txt

또는 수동으로:

pip install mcp pywin32

[!NOTE] 네이티브 파이프 모드는 Windows 전용입니다. Named Pipes(pywin32)를 사용하기 때문입니다. MCP 서버가 Cheat Engine이 실행 중인 Windows 환경 외부에서 실행되어 Named Pipe를 직접 열 수 없는 경우 TCP 릴레이 전송 방식을 사용하세요.

빠른 시작

1. Cheat Engine에 브리지 로드

1. DBVM 도구를 사용하려면 Cheat Engine에서 DBVM을 활성화하세요.
2. Cheat Engine의 Lua 엔진 또는 스크립트 실행기를 엽니다.
   • 권장: File -> Execute Script -> MCP_Server/ce_mcp_bridge.lua 열기 -> Execute.
   • Cheat Engine 빌드에 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

2. MCP 클라이언트 구성

MCP 설정 (예: mcp_config.json)에 다음을 추가하세요:

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

IDE를 다시 시작하여 MCP 서버 설정을 로드하세요.

Codex의 경우, ~/.codex/config.toml에 TOML 서버 블록을 추가하세요:

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

Windows 경로는 작은따옴표를 사용하여 TOML이 백슬래시를 리터럴로 처리하도록 하세요.

TCP 릴레이 전송

TCP 릴레이를 사용하면 mcp_cheatengine.py가 Windows Named Pipe를 직접 열지 않고 TCP 소켓을 통해 Cheat Engine과 통신할 수 있습니다. Cheat Engine과 Lua 브리지는 여전히 Windows에서 실행되고, MCP 서버는 릴레이에 접근 가능한 어디서든(다른 Windows 프로세스, VM, 컨테이너, Linux 호스트, 원격 시스템) 실행될 수 있습니다. WSL에서도 Lua 브리지를 변경하지 않고 사용할 수 있습니다.

1. Windows에서 평소대로 Cheat Engine에 MCP_Server/ce_mcp_bridge.lua를 로드하세요.
2. Windows에서 릴레이를 시작하세요:

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

3. MCP 서버를 실행할 환경에서 pywin32 없이 MCP 종속성을 설치한 후 TCP 전송으로 MCP 서버를 실행/구성하세요:

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와 MCP 서버의 CE_MCP_HOST를 네트워크 설정에 맞는 주소로 설정하세요. 릴레이는 신뢰할 수 있는 인터페이스에만 바인딩하세요. 접근 가능한 사람은 누구나 Cheat Engine 브리지를 제어할 수 있습니다.

3. 연결 확인

ping 도구를 사용하여 연결을 확인하세요:

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

4. 질문 시작하기

"어떤 프로세스가 연결되어 있나요?"
"베이스 주소에서 16바이트 읽기"
"진입점 디스어셈블"

약 180개의 MCP 도구 사용 가능

메모리

분석

디버깅

프로세스 생애주기

메모리 할당

코드 인젝션

심볼 관리

어셈블리 / 컴파일

창 / GUI 자동화

입력 자동화

치트 테이블

커널 모드 (DBK / DBVM)

그 외 더 많은 도구는 AI_Context/MCP_Bridge_Command_Reference.md에서 확인하세요.

중요 설정

BSOD 방지

[!CAUTION] 다음을 반드시 비활성화하세요: Cheat Engine → Settings → Extra → "Query memory region routines"

활성화 시: 보호된 페이지를 스캔할 때 DBVM/안티치트와 충돌하여 CLOCK_WATCHDOG_TIMEOUT BSOD 발생.

문제 해결

Cheat Engine에서 "too many local variables" 메시지

전체 스크립트를 치트 테이블 스크립트에 붙여넣지 말고 dofile(...)을 사용하여 디스크에서 브리지를 로드하세요. 브리지는 의도적으로 명령 핸들러를 전역 함수로 선언합니다. 이렇게 하면 전체 브리지가 한 번에 컴파일될 때 Cheat Engine의 Lua 청크 제한(로컬 변수 200개)을 피할 수 있습니다.

MCP 클라이언트가 연결할 수 없음

다음 순서로 확인하세요:

1. Cheat Engine이 열려 있고 MCP Server Listening on: CE_MCP_Bridge_v99 메시지가 표시되는지 확인.
2. 서버 설정을 추가한 후 MCP 클라이언트를 다시 시작했는지 확인.
3. 설정된 mcp_cheatengine.py 경로가 실제로 존재하는지 확인.
4. pip install -r MCP_Server/requirements.txt로 mcp와 pywin32가 모두 설치되었는지 확인.
5. MCP ping 도구를 실행하세요. 성공적인 연결은 success: true와 브리지 버전을 반환합니다. process_id: 0은 Cheat Engine이 대상 프로세스에 연결될 때까지 정상입니다.

환경 변수

예제 워크플로우

값 찾기:

사용자: "골드 15000 스캔"  →  AI가 47개 결과 발견
사용자: "골드가 15100으로 변경됨"  →  AI가 3개 주소로 필터링
사용자: "첫 번째 주소에 쓰는 것은?"  →  AI가 하드웨어 BP 설정
사용자: "해당 함수 디스어셈블"  →  전체 AddGold 로직 공개

구조체 이해하기:

사용자: "[[game.exe+0x1234]+0x10]에는 무엇이 있나요?"
AI: "RTTI: CPlayerInventory"
AI: "0x00=vtable, 0x08=itemCount(int), 0x10=itemArray(ptr)..."

프로젝트 구조

CLAUDE.md                               # Claude Code 에이전트 가이드 (이 저장소)
README.md                               # 사용자 문서

MCP_Server/
├── mcp_cheatengine.py                  # Python MCP 서버 (FastMCP)
├── ce_mcp_bridge.lua                   # Cheat Engine Lua 브리지
└── test_mcp.py                         # 테스트 스위트

AI_Context/
├── BATCH_WORKER_BRIEFING.md            # 병렬 워커 작업 사양 (v12 개편)
├── MCP_Bridge_Command_Reference.md     # MCP 명령 참조
├── CE_LUA_Documentation.md             # 전체 CheatEngine 7.6 공식 문서
└── AI_Guide_MCP_Server_Implementation.md  # AI 에이전트를 위한 전체 기술 문서

테스트

테스트 실행:

python MCP_Server/test_mcp.py

예상 출력:

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

결론

더 이상 전문가가 될 필요가 없습니다. 올바른 질문만 하면 됩니다.

⚠️ 교육적 고지

이 코드는 교육 및 연구 목적으로만 제공됩니다. Model Context Protocol (MCP)과 LLM 기반 디버깅의 기능을 보여주기 위해 만들어졌습니다. 악의적인 해킹, 멀티플레이어 게임에서의 부정 행위, 서비스 약관 위반 등에 이 도구를 사용하는 것을 용납하지 않습니다. 이는 소프트웨어 엔지니어링 자동화의 데모입니다.