デモ

Cheat Engine MCP Bridge

数十億ドル規模のAIデータセンターに、プログラムのメモリを解析させましょう。

MOD、トレーナー、セキュリティ監査、ゲームボットの作成、RE（リバースエンジニアリング）の加速など、あらゆるプログラムやゲームで行う作業を、ほんのわずかな時間で実現できます。

[!NOTE] スターを付けてくれた皆さん、本当にありがとうございます！ <3

特に、すべてのコントリビューターの皆さんに心から感謝します!!

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

問題

あなたは何ギガバイトものメモリを眺めている。何百万ものアドレス。何千もの関数。あのポインタ、あの構造体を見つけるには、数日から数週間もの手作業が必要だ。

ただ質問するだけで済んだらどうだろう？

「パケット復号化フックを見つけて。」
「キャラクター座標のOPコードを見つけて。」
「HP値のOPコードを見つけて。」
「ゲームアップデート後もトレーナーが安定する、ユニークなAOBパターンを見つけて。」

これこそが、このツールが実現することだ。

- ヘキサダンプをクリックし続けるのはやめて、メモリと会話を始めよう。

得られるもの:

あなたの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] ネイティブパイプモードは、名前付きパイプ（pywin32）を使用するためWindowsのみ対応です。MCPサーバーがCheat Engineを実行しているWindows環境の外で動作し、名前付きパイプを直接開けない場合は、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の名前付きパイプを直接開く代わりに、TCPソケットを介してCheat Engineと通信できます。Cheat EngineとLuaブリッジは引き続きWindows上で動作し、MCPサーバーはリレーに到達できる場所ならどこでも実行できます（別のWindowsプロセス、VM、コンテナ、Linuxホスト、リモートマシンなど）。また、Luaブリッジを変更せずにWSLでも使用できます。

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. 質問を始める

"What process is attached?"
"Read 16 bytes at the base address"
"Disassemble the entry point"

利用可能な約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とブリッジのバージョンが返されます。Cheat Engineがターゲットプロセスにアタッチされるまではprocess_id: 0が正常です。

環境変数

使用例

値を見つける:

You: "Scan for gold: 15000"  →  AI finds 47 results
You: "Gold changed to 15100"  →  AI filters to 3 addresses
You: "What writes to the first one?"  →  AI sets hardware BP
You: "Disassemble that function"  →  Full AddGold logic revealed

構造体を理解する:

You: "What's at [[game.exe+0x1234]+0x10]?"
AI: "RTTI: CPlayerInventory"
AI: "0x00=vtable, 0x08=itemCount(int), 0x10=itemArray(ptr)..."

プロジェクト構成

CLAUDE.md                               # Claude Code agent guidance (this repo)
README.md                               # User-facing documentation

MCP_Server/
├── mcp_cheatengine.py                  # Python MCP Server (FastMCP)
├── ce_mcp_bridge.lua                   # Cheat Engine Lua Bridge
└── test_mcp.py                         # Test Suite

AI_Context/
├── BATCH_WORKER_BRIEFING.md            # Parallel-worker task specifications (v12 overhaul)
├── MCP_Bridge_Command_Reference.md     # MCP Commands reference
├── CE_LUA_Documentation.md             # Full CheatEngine 7.6 official documentation
└── AI_Guide_MCP_Server_Implementation.md  # Full technical documentation for AI agent

テスト

テストの実行:

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ベースのデバッグの能力を示すために作成されました。悪意のあるハッキング、マルチプレイヤーゲームでのチート、利用規約への違反にこれらのツールを使用することを容認しません。これはソフトウェアエンジニアリングの自動化のデモンストレーションです。