Flipper MCP

Flipper MCP Server

Servidor MCP (Model Context Protocol) que conecta LLMs con Flipper Desktop para depurar aplicaciones Android en tiempo real.

Herramientas disponibles

Device & App

Logs & Crashes

Network & Analytics

Network Mocking

Intercepta peticiones de red en la app Android y devuelve respuestas configuradas, sin necesidad de modificar el servidor real. Funciona tanto para peticiones REST (plugin nativo Network) como GraphQL (plugin Network GraphQL).

Como funciona el enrutado:

• Si se especifica operation (nombre de operacion GraphQL) → el mock se envia al plugin Network GraphQL
• Si operation esta vacio → el mock se envia al plugin nativo Network (REST)

Ejemplos de uso:

Mock de una operacion GraphQL que devuelve error 500:

flipper_add_mock({
  requestUrl: "https://api.example.com/graphql",
  operation: "GetHotel",
  method: "POST",
  status: 500,
  data: '{"errors":[{"message":"Internal Server Error"}]}'
})

Mock de un endpoint REST que devuelve lista vacia:

flipper_add_mock({
  requestUrl: "https://api.example.com/hotels",
  method: "GET",
  status: 200,
  data: '{"hotels":[]}'
})

Data & State

UI Inspection

Memory & Push

Requisitos

• Node.js v18+
• Flipper Desktop corriendo con WebSocket habilitado (puerto 52342)
• App Android conectada a Flipper

Instalacion

npm install
npm run build

Configuracion

El servidor requiere un token de autenticacion de Flipper. Se obtiene de la URL de conexion de Flipper o de sus logs al iniciar.

Variables de entorno

Configuracion en Claude Desktop

Archivo: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "flipper": {
      "command": "node",
      "args": ["/ruta/absoluta/a/flipper-mcp/dist/index.js"],
      "env": {
        "FLIPPER_TOKEN": "tu_token"
      }
    }
  }
}

Configuracion en Claude Code

Archivo: .mcp.json en la raiz del proyecto o ~/.claude/mcp.json global:

{
  "mcpServers": {
    "flipper": {
      "command": "node",
      "args": ["/ruta/absoluta/a/flipper-mcp/dist/index.js"],
      "env": {
        "FLIPPER_TOKEN": "tu_token"
      }
    }
  }
}

Arquitectura

src/
  index.ts              # Punto de entrada, registra tools y arranca McpServer
  flipper/
    client.ts           # Cliente WebSocket hacia Flipper Desktop
    device.ts           # Resolucion de dispositivos y clientes
    types.ts            # Tipos de mensajes Flipper
  tools/
    logs.ts             # Logs del dispositivo
    analytics.ts        # Eventos de analytics
    network.ts          # Peticiones de red
    mock.ts             # Mocking de respuestas de red (REST y GraphQL)
    viewmodel.ts        # Estado de ViewModels
    preferences.ts      # SharedPreferences / DataStore (lectura y escritura)
    fcm.ts              # Envio de push notifications FCM
    crashreporter.ts    # Crash reports
    screenshot.ts       # Capturas de pantalla
    database.ts         # Bases de datos SQLite/Room
    shell.ts            # Comandos ADB shell
    navigate.ts         # Navegacion por deep links
    ui-inspector.ts     # Inspeccion de jerarquia de vistas
    leaks.ts            # Memory leaks (LeakCanary)
    device-info.ts      # Info de dispositivos y apps conectadas
  utils/
    logger.ts           # Logger con gate DEBUG

Cada archivo de tool exporta una funcion registerXxxTools(server: McpServer) que registra las herramientas usando McpServer.registerTool() con schemas Zod.

El FlipperClient mantiene una conexion WebSocket persistente con reconexion automatica. Los datos se almacenan en buffers en memoria con tamano limitado.

Desarrollo

npm run build          # Compila TypeScript a dist/
npm start              # Ejecuta el servidor

DEBUG=1 npm start      # Ejecuta con logs de depuracion

Seguridad

• No comitear el FLIPPER_TOKEN. Pasarlo siempre via variable de entorno.
• El token expira periodicamente; actualizar en la configuracion cuando sea necesario.

Licencia

MIT