Android-Mobile-MCP

Android Mobile MCP

Descripción general

Android Mobile MCP conecta el Protocolo de Contexto del Modelo con la automatización de dispositivos Android, permitiendo que los agentes de IA interactúen con dispositivos Android mediante manipulación de la interfaz de usuario, gestión de aplicaciones y captura de pantalla.

Configuración de MCP

{
  "mcpServers": {
    "android-mobile-mcp": {
      "command": "uvx",
      "args": ["android-mobile-mcp"]
    }
  }
}

Requisitos previos

1. Conecta el dispositivo Android mediante USB o red
2. Habilita la depuración USB en tu dispositivo Android
3. Instala ADB (Android Debug Bridge)

Referencia de herramientas

Análisis de pantalla

mobile_dump_ui - Extrae elementos de la interfaz de usuario como JSON jerárquico

• Analiza el XML de la pantalla para identificar elementos enfocables y contenido de texto
• Calcula las coordenadas centrales de cada elemento interactivo
• Devuelve relaciones estructuradas entre elementos padre e hijo

mobile_take_screenshot - Captura el estado actual de la pantalla

• Devuelve datos de imagen PNG para análisis visual

Interacciones táctiles

mobile_click - Haz clic en coordenadas específicas

• Valida las coordenadas contra el estado actual de la interfaz de usuario
• Requiere una llamada previa a mobile_dump_ui para verificar las coordenadas
• Evita hacer clic en áreas no válidas o no interactivas

mobile_swipe - Realiza gestos de deslizamiento

• Ejecuta deslizamientos direccionales entre dos puntos de coordenadas
• Duración configurable para controlar la velocidad del gesto

Entrada de texto

mobile_type - Ingresa texto en campos enfocados

• Envía texto al campo de entrada actualmente activo
• Envío automático opcional con la tecla Enter

Navegación

mobile_key_press - Presiona botones del sistema

• Admite teclas físicas y virtuales: BACK, HOME, RECENT, ENTER

Gestión de aplicaciones

mobile_list_apps - Lista las aplicaciones instaladas

• Filtra aplicaciones del sistema y paquetes no iniciables
• Devuelve solo aplicaciones accesibles para el usuario

mobile_launch_app - Inicia aplicaciones por nombre de paquete

• Valida la existencia del paquete antes del intento de inicio