Cheatengine MCP Bridge

🚀 Cheat Engine MCP Bridge

数十億ドル規模のAIデータセンターにプログラムのメモリ分析を代行してもらおう。

Cursor、Copilot、Antigravityまたはお好みのローカルAIエージェントをRooCode/Cline経由で直接Cheat Engineに接続し、あらゆるプログラムやゲームに対して、モッド作成、トレーナー作成、セキュリティ監査などを短時間で行うことができます。

💡 使用提示

皆さんからのスターをいただき、ありがとうございます！ <3

デモ

🚀 クイックスタート

問題意識

何ギガバイトものメモリ、何百万ものアドレス、何千もの関数がある中で、特定のポインタや構造体を見つけるのに、手作業では数日または数週間かかります。

もし、ただ質問するだけで済むとしたら？

"パケット復号化のフックを見つけて。"
"キャラクターの座標のオペコードを見つけて。"
"体力値のオペコードを見つけて。"
"ゲーム更新後もトレーナーが安定するような一意の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

⚠️ 重要提示

このツールはWindowsのみで動作します。（名前付きパイプ (pywin32) を使用しています）

💻 使用例

基本的な使用法

1. Cheat Engineでブリッジを読み込む

1. CheatEngineでDBVMを有効にする。
2. ファイル → スクリプトの実行 → ce_mcp_bridge.luaを開く → 実行

[MCP v11.4.0] Server started on \\.\pipe\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サーバーの設定を読み込みます。

3. 接続を確認する

ping ツールを使用して接続を確認します。

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

4. 質問を始める

"どのプロセスがアタッチされていますか？"
"ベースアドレスから16バイトを読み取ってください。"
"エントリーポイントを逆アセンブルしてください。"

高度な使用法

値を見つける

あなた: "ゴールドを15000でスキャンして。"  →  AIが47件の結果を見つける
あなた: "ゴールドが15100に変更されました。"  →  AIが3つのアドレスに絞り込む
あなた: "最初のアドレスに書き込むものは何ですか？"  →  AIがハードウェアブレークポイントを設定する
あなた: "その関数を逆アセンブルして。"  →  完全なAddGoldロジックが明らかになる

構造体を理解する

あなた: "[[game.exe+0x1234]+0x10]には何がありますか？"
AI: "RTTI: CPlayerInventory"
AI: "0x00=仮想関数テーブル, 0x08=アイテム数(int), 0x10=アイテム配列(ptr)..."

📚 ドキュメント

39のMCPツール

メモリ

分析

デバッグ

その他のツールについては AI_Context/MCP_Bridge_Command_Reference.md を参照してください。

重要な設定

BSOD防止

⚠️ 重要提示

必ず無効にする: Cheat Engine → 設定 → 追加設定 → "メモリ領域ルーチンをクエリする"

有効にすると、保護されたページをスキャンする際にDBVM/アンチチートとの競合により、CLOCK_WATCHDOG_TIMEOUT のBSODが発生します。

🔧 技術詳細

プロジェクト構造

MCP_Server/
├── mcp_cheatengine.py      # Python MCP Server (FastMCP)
├── ce_mcp_bridge.lua   # Cheat Engine Lua Bridge
└── test_mcp.py # テストスイート

AI_Context/
├── 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

期待される出力は以下の通りです。

✅ メモリ読み取り: 6/6のテストが合格
✅ プロセス情報: 4/4のテストが合格  
✅ コード分析: 8/8のテストが合格
✅ ブレークポイント: 4/4のテストが合格
✅ DBVM関数: 3/3のテストが合格
✅ ユーティリティコマンド: 11/11のテストが合格
⏭️ スキップ: 1つのテスト (generate_signature)
────────────────────────────────────
合計: 36/37のテストが合格 (100%成功)

📄 ライセンス

このコードは教育および研究目的のみで使用されることを想定しています。これは、Model Context Protocol (MCP) とLLMベースのデバッグの機能を示すために作成されています。悪意のあるハッキング、マルチプレイヤーゲームでの不正行為、またはサービス利用規約の違反にこれらのツールを使用することは容認されません。これはソフトウェアエンジニアリングの自動化のデモンストレーションです。