Il2cpp Frida MCP

🚀 IL2CPP Frida MCP 服務器

這是一個基於模型上下文協議（MCP）的 IL2CPP 逆向工程工具，它能讓 AI 助手（如 Claude、Kiro）直接分析和操作 Unity IL2CPP 應用程序。

✨ 主要特性

• 🔌 Frida 集成 - 支持 USB、遠程和本地設備連接
• 📦 IL2CPP 分析 - 列出鏡像、類、方法，並支持模糊搜索
• 🔍 反彙編 - 基於 Frida 指令 API 進行方法反彙編
• 🧠 GC 堆分析 - 查找運行時對象實例
• 📤 導入/導出 - 查找模塊的導入和導出函數
• 🛠️ JS 執行 - 執行任意 JavaScript 代碼以操作 Frida API

📦 安裝指南

選項 1：使用 pip 安裝（推薦）

# 從源碼安裝
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 桌面版 / Kiro

添加到你的 MCP 配置文件中：

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

或者使用 Python 模塊運行：

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

📚 詳細文檔

Frida 基礎工具

IL2CPP 分析工具

示例

1. 連接到設備

使用 frida_connect 連接到 USB 設備上最前端的應用程序

2. 分析 IL2CPP

列出所有鏡像，然後查找包含 "Player" 的類

3. 查看方法詳細信息

列出 PlayerController 類的所有方法，然後查看 Update 方法的詳細信息

🔧 技術細節

項目結構

.
├── 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

開發

編譯代理

npm run build     # 單次編譯
npm run watch     # 監聽模式

依賴項

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

📄 許可證

MIT

致謝

• frida-il2cpp-bridge - IL2CPP 運行時橋接
• Il2CppHookScripts - 參考實現