IL2CPP Frida MCP Server
Provides tools for analyzing and manipulating Unity IL2CPP applications, including listing images, classes, methods, disassembly, GC heap analysis, and more.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@IL2CPP Frida MCP ServerList all methods in the PlayerController class"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
IL2CPP Frida MCP Server
A Model Context Protocol (MCP) based IL2CPP reverse engineering tool that enables AI assistants (like Claude, Kiro) to directly analyze and manipulate Unity IL2CPP applications.
Features
š Frida Integration - Support for USB, remote, and local device connections
š¦ IL2CPP Analysis - List images, classes, methods with fuzzy search support
š Disassembly - Method disassembly based on Frida Instruction API
š§ GC Heap Analysis - Find runtime object instances
š¤ Import/Export - Find module import and export functions
š ļø JS Execution - Execute arbitrary JavaScript code to manipulate Frida API
Related MCP server: Frida MCP
Project Structure
.
āāā mcp_server.py # Entry point
āāā mcp_server/ # MCP Server module
ā āāā __init__.py
ā āāā server.py # MCP Server core
ā āāā state.py # Frida state management
ā āāā tools.py # MCP tool definitions
ā āāā transport.py # Transport layer (stdio/sse/http)
ā āāā cli.py # Command line interface
ā āāā agent_loader.py # Agent loader
ā āāā handlers/ # Tool handlers
ā āāā __init__.py
ā āāā frida_handlers.py
ā āāā il2cpp_handlers.py
āāā agent/ # Frida Agent (TypeScript)
ā āāā index.ts # Agent entry point
ā āāā core/ # Core modules
ā ā āāā il2cpp-helper.ts
ā ā āāā method-utils.ts
ā ā āāā class-finder.ts
ā āāā services/ # Service modules
ā āāā image-service.ts
ā āāā class-service.ts
ā āāā method-service.ts
ā āāā disasm-service.ts
ā āāā module-service.ts
ā āāā gc-service.ts
ā āāā exec-service.ts
āāā _agent.js # Compiled Agent
āāā package.json
āāā tsconfig.json
āāā requirements.txtInstallation
Option 1: pip install (Recommended)
# Install from source
pip install .
# Or install in development mode
pip install -e .Option 2: Manual dependency installation
pip install -r requirements.txtCompile Frida Agent
npm install
npm run buildUsage
Start MCP Server
# If installed via pip
il2cpp-frida-mcp # Interactive selection
il2cpp-frida-mcp --stdio # stdio mode
il2cpp-frida-mcp --sse # SSE mode
il2cpp-frida-mcp --http # HTTP mode
# Or run script directly
python mcp_server.py --stdio
# Custom host and port
il2cpp-frida-mcp --sse --host 0.0.0.0 --port 9000Configure MCP Client
Claude Desktop / Kiro
Add to your MCP configuration file:
{
"mcpServers": {
"il2cpp-frida": {
"command": "il2cpp-frida-mcp",
"args": ["--stdio"]
}
}
}Or run using Python module:
{
"mcpServers": {
"il2cpp-frida": {
"command": "python",
"args": ["-m", "mcp_server", "--stdio"]
}
}
}MCP Tools
Frida Basic Tools
Tool | Description |
| List all available Frida devices |
| Connect to device and target process |
| Disconnect Frida connection |
| Resume suspended process |
| List processes on device |
IL2CPP Analysis Tools
Tool | Description |
| List all IL2CPP images |
| List all classes in specified image |
| List all methods in specified class |
| Show method details |
| Find classes (fuzzy match supported) |
| Find methods (fuzzy match supported) |
| Disassemble method |
| Find export functions |
| Find import functions |
| Execute arbitrary JavaScript code |
| Find instances of specified class in heap |
| Get GC heap information |
Examples
1. Connect to Device
Use frida_connect to connect to the frontmost app on USB device2. Analyze IL2CPP
List all images, then find classes containing "Player"3. View Method Details
List all methods of PlayerController class, then view Update method detailsDevelopment
Compile Agent
npm run build # Single build
npm run watch # Watch modeDependencies
Python 3.10+
Node.js 16+
Frida 17+
frida-il2cpp-bridge
Acknowledgements
frida-il2cpp-bridge - IL2CPP runtime bridge
Il2CppHookScripts - Reference implementation
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
11Drive real devices from your AI Coding tool. Embed a client SDK (Unity, Godot, Flutter, iOS/macOS, Android, React Native, Web) in your app, then capture screenshots, traverse the UI tree, inject taps and key events, and run automated test tasks on the physical device over a secure relay.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Eā¦
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Related MCP Servers
- AlicenseBqualityCmaintenanceA bridge between Unity and AI assistants that enables AI to interact with Unity game environments through a standardized interface for code execution, scene analysis, and runtime debugging.315 npm7MIT
- AlicenseBqualityNot gradedmaintenanceEnables AI systems to interact with mobile and desktop applications through Frida's dynamic instrumentation capabilities. Provides process management, device control, JavaScript REPL execution, and script injection for runtime analysis and reverse engineering.142MIT
- AlicenseAqualityFmaintenanceProvides Cheat Engine-like capabilities for game hacking and reverse engineering through Frida, enabling memory scanning, value modification, pattern matching, function hooking, and code injection across processes.4282MIT
- AlicenseNot gradedqualityDmaintenanceExposes Frida dynamic instrumentation capabilities to AI assistants, enabling process management, memory access, and function hooking through structured tool calls.MIT