Frida Game Hacking MCP

🚀 Frida Game Hacking MCP

Frida Game Hacking MCPは、Fridaを通じてゲームハッキングにおけるCheat Engineのような機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。AIアシスタントや自動化ツールが、メモリスキャン、値の変更、パターンマッチング、関数フック、コードインジェクションを実行できるようにします。

✨ 主な機能

メモリ操作（Cheat Engineスタイル）

• 値のスキャン：型（int8 - 64、float、double、string）でメモリ内の値を検索します。
• スキャンの絞り込み：scan_next、scan_changed、scan_unchangedで結果を絞り込みます。
• バイト配列のパターンスキャン：ワイルドカード（??）をサポートするバイト配列（AoB）のスキャンが可能です。
• メモリの読み書き：型を意識してメモリを読み書きします。

関数フックとコードインジェクション

• 関数のインターセプト：onEnter/onLeaveのJavaScriptコールバックで関数をフックします。
• 関数の置き換え：関数がカスタム値を返すようにします。
• モジュールのフック：module!function名で関数をフックします。
• シンボルの解決：エクスポートをアドレスに解決します。

プロセス管理

• プロセスの列挙：実行中のプロセスをリストし、フィルタリングします。
• アタッチ/デタッチ：実行中のプロセスに接続したり切断したりします。
• 起動と再開：プロセスを一時停止状態で起動し、早期にフックを設定できます。

デバッグ

• ブレークポイント：フックを通じたソフトウェアブレークポイントを設定します。
• レジスタのアクセス：ブレークポイントでCPUレジスタを読み取ります。
• モジュールの分析：モジュール、エクスポート、インポートをリストします。

ウィンドウ操作（Windowsのみ）

• スクリーンショットの取得：ゲームウィンドウのスクリーンショットを撮ります。
• キーボード入力：ゲームウィンドウにキーストロークを送信します。
• ウィンドウの管理：ウィンドウをリストし、フォーカスを設定し、操作します。

📦 インストール

# PyPIからのインストール（近日公開予定）
pip install frida-game-hacking-mcp

# ソースからのインストール
git clone https://github.com/0xhackerfren/frida-game-hacking-mcp.git
cd frida-game-hacking-mcp
pip install -e .

必要条件

• Python 3.10以上
• Frida 16.0以上
• pywin32、pillow（Windows、スクリーンショット機能のため）

pip install frida frida-tools mcp pillow
# Windowsの場合は、さらに以下をインストール
pip install pywin32

🚀 クイックスタート

MCPサーバーの起動

# 直接実行
python -m frida_game_hacking_mcp

# エントリーポイントを使用
frida-game-hacking-mcp

Claude Desktopでの設定

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "frida-game-hacking": {
      "command": "python",
      "args": ["-m", "frida_game_hacking_mcp"]
    }
  }
}

その他のMCPクライアントでの設定

サーバーはデフォルトで標準入出力（stdio）トランスポートを使用します。以下の設定で接続します。

• コマンド: python -m frida_game_hacking_mcp
• トランスポート: stdio

💻 使用例

Cheat Engineワークフロー：体力の検索と変更

1. プロセスをリストし、ゲームを見つける
   > list_processes("game")
   
2. ゲームにアタッチする
   > attach("game.exe")
   
3. 現在の体力値（例：100）で初期スキャンを行う
   > scan_value(100, "int32")
   見つかったアドレス: 58,869個
   
4. ゲーム内でダメージを受ける（体力が95になる）
   > scan_next(95)
   絞り込まれたアドレス: 1,419個
   
5. アドレスが見つかるまで繰り返す
   > scan_next(90)
   絞り込まれたアドレス: 3個
   
6. 結果を取得し、変更する
   > get_scan_results()
   > write_memory("0x12345678", "E7030000")  # リトルエンディアンで999

バイト配列のパターンスキャン

# コードパターンを検索する（ゲームの更新に対応）
> attach("game.exe")
> scan_pattern("89 47 44 ?? ?? 5B 7A", "r-x")
見つかったマッチ: 2個

# ?? = ワイルドカードバイト
# "r-x" = 実行可能なメモリ領域

関数フック

# 関数をフックし、呼び出しをログに残す
> hook_function("0x401234",
    on_enter="console.log('Args:', args[0], args[1]);",
    on_leave="console.log('Return:', retval);")

# 関数が常に成功を返すようにする
> replace_function("0x401234", 1)

# モジュールと関数名でフックする
> intercept_module_function("game.dll", "CheckLicense",
    on_leave="retval.replace(1);")

早期フック（一時停止状態で起動）

# プロセスを一時停止状態で起動する
> spawn("C:/Games/game.exe")

# コードが実行される前にフックを設定する
> hook_function("0x401234", on_enter="...")

# 実行を再開する
> resume()

利用可能なツール（合計42個）

プロセス管理（6個）

メモリ操作（10個）

モジュール情報（5個）

関数フック（6個）

デバッグ（4個）

スクリプト管理（3個）

ウィンドウ操作（5個） - Windowsのみ

標準MCP（3個）

値の型

スキャン領域

プラットフォームサポート

• Windows：ネイティブサポート
• Linux：ネイティブサポート
• macOS：ネイティブサポート
• Android：frida-serverを介してサポート
• iOS：frida-serverを介して（ジェイルブレイク済み）サポート

利用シーン

• ゲームハッキング：メモリ編集、値の変更、トレーナー開発
• セキュリティ研究：脆弱性分析、エクスプロイト開発
• リバースエンジニアリング：ランタイム分析、APIフック
• ソフトウェアテスト：障害注入、動作変更
• マルウェア分析：サンドボックス環境での動的分析

セキュリティに関する注意

このツールは以下の目的に使用することを想定しています。

• 教育目的
• 所有しているまたはテスト許可を得たソフトウェアのセキュリティ研究
• シングルプレイヤー/オフライン環境でのゲームモディング

以下の目的での使用は避けてください：

• オンラインマルチプレイヤーゲームでの不正行為
• ソフトウェアの保護を違法に回避する行為
• 悪意のある目的

コントリビューション

コントリビューションを歓迎します！以下の手順で行ってください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. プルリクエストを送信します。

📄 ライセンス

MITライセンス - LICENSEを参照してください。

クレジット

• Fridaをベースに構築されています。FridaはOle Andre Vadla Ravnasによって開発されています。
• MCPプロトコルはAnthropicによって提供されています。
• Cheat Engineにインスピレーションを得ています。Cheat EngineはDark Byteによって開発されています。

リンク

• Fridaドキュメント
• MCP仕様
• 問題の報告

AI支援によるゲームハッキングとセキュリティ研究のために開発されました。