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 - 参考实现