Il2cpp Frida MCP

🚀 IL2CPP Frida MCP Server

Model Context Protocol (MCP)ベースのIL2CPP逆エンジニアリングツールです。このツールにより、ClaudeやKiroなどのAIアシスタントがUnity IL2CPPアプリケーションを直接分析および操作できます。

✨ 主な機能

• 🔌 Frida統合 - USB、リモート、ローカルデバイス接続をサポート
• 📦 IL2CPP分析 - イメージ、クラス、メソッドを一覧表示し、ファジー検索をサポート
• 🔍 逆アセンブル - Frida Instruction APIに基づくメソッドの逆アセンブル
• 🧠 GCヒープ分析 - ランタイムオブジェクトインスタンスを検索
• 📤 インポート/エクスポート - モジュールのインポートとエクスポート関数を検索
• 🛠️ JS実行 - 任意のJavaScriptコードを実行してFrida APIを操作

📁 プロジェクト構造

.
├── mcp_server.py           # エントリーポイント
├── mcp_server/             # MCPサーバーモジュール
│   ├── __init__.py
│   ├── server.py           # MCPサーバーコア
│   ├── state.py            # Frida状態管理
│   ├── tools.py            # MCPツール定義
│   ├── transport.py        # トランスポート層 (stdio/sse/http)
│   ├── cli.py              # コマンドラインインターフェース
│   ├── agent_loader.py     # エージェントローダー
│   └── handlers/           # ツールハンドラー
│       ├── __init__.py
│       ├── frida_handlers.py
│       └── il2cpp_handlers.py
├── agent/                  # Fridaエージェント (TypeScript)
│   ├── index.ts            # エージェントエントリーポイント
│   ├── core/               # コアモジュール
│   │   ├── il2cpp-helper.ts
│   │   ├── method-utils.ts
│   │   └── class-finder.ts
│   └── services/           # サービスモジュール
│       ├── image-service.ts
│       ├── class-service.ts
│       ├── method-service.ts
│       ├── disasm-service.ts
│       ├── module-service.ts
│       ├── gc-service.ts
│       └── exec-service.ts
├── _agent.js               # コンパイル済みエージェント
├── package.json
├── tsconfig.json
└── requirements.txt

📦 インストール

オプション1: pip install (推奨)

# ソースからインストール
pip install .

# または開発モードでインストール
pip install -e .

オプション2: 手動で依存関係をインストール

pip install -r requirements.txt

Fridaエージェントをコンパイル

npm install
npm run build

💻 使用例

MCPサーバーを起動

# pipでインストールした場合
il2cpp-frida-mcp                        # インタラクティブ選択
il2cpp-frida-mcp --stdio                # stdioモード
il2cpp-frida-mcp --sse                  # SSEモード
il2cpp-frida-mcp --http                 # HTTPモード

# またはスクリプトを直接実行
python mcp_server.py --stdio

# カスタムホストとポート
il2cpp-frida-mcp --sse --host 0.0.0.0 --port 9000

MCPクライアントを設定

Claude Desktop / Kiro

MCP設定ファイルに以下を追加します。

{
  "mcpServers": {
    "il2cpp-frida": {
      "command": "il2cpp-frida-mcp",
      "args": ["--stdio"]
    }
  }
}

またはPythonモジュールを使用して実行します。

{
  "mcpServers": {
    "il2cpp-frida": {
      "command": "python",
      "args": ["-m", "mcp_server", "--stdio"]
    }
  }
}

🛠️ MCPツール

Frida基本ツール

IL2CPP分析ツール

💻 使用例

1. デバイスに接続

frida_connectを使用して、USBデバイス上の最前面のアプリに接続します。

2. IL2CPPを分析

すべてのイメージを一覧表示し、「Player」を含むクラスを検索します。

3. メソッドの詳細を表示

PlayerControllerクラスのすべてのメソッドを一覧表示し、Updateメソッドの詳細を表示します。

🔧 開発

エージェントをコンパイル

npm run build     # 単一ビルド
npm run watch     # ウォッチモード

依存関係

• Python 3.10以上
• Node.js 16以上
• Frida 17以上
• frida-il2cpp-bridge

🙏 謝辞

• frida-il2cpp-bridge - IL2CPPランタイムブリッジ
• Il2CppHookScripts - 参考実装

📄 ライセンス

MIT