Android-Mobile-MCP

Android Mobile MCP

Visão Geral

O Android Mobile MCP conecta o Model Context Protocol com a automação de dispositivos Android, permitindo que agentes de IA interajam com dispositivos Android por meio de manipulação de interface, gerenciamento de aplicativos e captura de tela.

Configuração do MCP

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

Pré-requisitos

1. Conecte o dispositivo Android via USB ou rede
2. Ative a depuração USB no seu dispositivo Android
3. Instale o ADB (Android Debug Bridge)

Referência de Ferramentas

Análise de Tela

mobile_dump_ui - Extrai elementos de interface como JSON hierárquico

• Analisa o XML da tela para identificar elementos focáveis e conteúdo de texto
• Calcula coordenadas centrais para cada elemento interativo
• Retorna relações estruturadas entre elementos pai e filho

mobile_take_screenshot - Captura o estado atual da tela

• Retorna dados de imagem PNG para análise visual

Interações de Toque

mobile_click - Clique em coordenadas específicas

• Valida coordenadas em relação ao estado atual da interface
• Requer chamada prévia de mobile_dump_ui para verificação de coordenadas
• Evita cliques em áreas inválidas ou não interativas

mobile_swipe - Realiza gestos de deslize

• Executa deslizes direcionais entre dois pontos de coordenadas
• Duração configurável para controle de velocidade do gesto

Entrada de Texto

mobile_type - Insere texto em campos focados

• Envia texto para o campo de entrada atualmente ativo
• Envio automático opcional com a tecla Enter

Navegação

mobile_key_press - Pressiona botões do sistema

• Suporta teclas físicas e virtuais: BACK, HOME, RECENT, ENTER

Gerenciamento de Aplicativos

mobile_list_apps - Lista aplicativos instalados

• Filtra aplicativos do sistema e pacotes não iniciáveis
• Retorna apenas aplicativos acessíveis ao usuário

mobile_launch_app - Inicia aplicativos pelo nome do pacote

• Valida a existência do pacote antes da tentativa de inicialização