vsh00t/frida-mcp-native

Frida MCP Native

MCP server para Frida que usa el CLI nativo de Frida en lugar de las librerías de Python o npm.

¿Por qué?

A partir de Frida 17, el bridge de Java ya no está incluido en el runtime de GumJS. Esto afecta a:

• python-frida (pip)
• frida (npm/Node.js)

Sin embargo, el CLI de Frida (frida, frida-ps, etc.) sí incluye el bridge de Java para el REPL y frida-trace.

Este MCP server usa directamente los comandos CLI de Frida via subprocess, lo que permite:

• ✅ Acceso completo a Java.* API en Android
• ✅ Acceso completo a ObjC.* API en iOS
• ✅ Compatible con Android 16 + Frida 17.5.1
• ✅ Sin dependencias de python-frida o npm frida

Requisitos

• Python 3.10+
• Frida CLI tools instalados (pip install frida-tools o descarga desde GitHub releases)
• frida-server corriendo en el dispositivo target

Instalación

cd frida-mcp-native
pipx install .

Uso con Claude Desktop / VS Code

Agregar a tu configuración de MCP:

{
  "mcpServers": {
    "frida-native": {
      "command": "frida-mcp-native"
    }
  }
}

Herramientas disponibles (30 tools)

📱 Dispositivos

⚙️ Procesos

📜 Scripting

🔍 RMS Functions - Análisis de Apps (Phase 1-2)

🪝 RMS Functions - Hook Templates (Phase 3)

⚡ RMS Functions - Live Hooking (Phase 4)

📊 RMS Functions - API Monitor (Phase 5)

🛡️ RMS Functions - Custom Scripts Library (Phase 6)

📊 Categorías de API Monitor

🛡️ Scripts Built-in

Android (7 scripts)

iOS (4 scripts)

📝 Ejemplos de uso

Listar procesos

list_processes(device="192.168.4.220:9999", applications_only=True)

Ejecutar script con Java API

execute_script(
    device="192.168.4.220:9999",
    target="com.example.app",
    script="Java.perform(() => { console.log('Classes:', Java.enumerateLoadedClassesSync().length); })"
)

Buscar clases con regex

load_classes_with_filter(
    target="com.example.app",
    filter_pattern="Security|Crypto|Root",
    is_regex=True,
    device="192.168.4.220:9999"
)

Monitorear APIs

api_monitor(
    target="com.example.app",
    categories=["Crypto", "Network", "SharedPreferences"],
    device="192.168.4.220:9999"
)

Bypass SSL Pinning

run_custom_script(
    target="com.example.app",
    script_name="ssl_pinning_bypass",
    device="192.168.4.220:9999"
)

Bypass Root Detection

run_custom_script(
    target="com.example.app",
    script_name="root_detection_bypass",
    device="192.168.4.220:9999"
)

Cargar script personalizado

load_script_from_file(
    target="com.example.app",
    script_path="/path/to/custom_script.js",
    device="192.168.4.220:9999"
)

✅ Progreso de Implementación

Total: 30 herramientas MCP + 11 scripts built-in

🔗 Links

• Frida: https://frida.re/
• RMS (Runtime Mobile Security): https://github.com/m0bilesecurity/RMS-Runtime-Mobile-Security
• MCP Protocol: https://modelcontextprotocol.io/

📄 License

MIT License