Android ADB Server

🚀 mcp-android-adb-server

Um serviço MCP para operar dispositivos Android via ADB.

2025-04-01: Adicionado suporte para obter conteúdo de descrição de tela usando modelos visuais como qwen2.5-vl.

Instalação Manual

# clone the repo and build
git clone https://github.com/github-hewei/mcp-android-adb-server.git
cd mcp-android-adb-server
go build

Configuração

{
  "mcpServers": {
    "mcp-android-adb-server": {
      "command": "D:\\www\\golang\\mcp-android-adb-server\\mcp-android-adb-server.exe",
      "env": {
        "DEVICE_ID": "xxxxx",
        "SCREEN_LOCK_PASSWORD": "123456",
        "VISUAL_MODEL_ON": "true",
        "VISUAL_MODEL_API_KEY": "sk-or-xxxxxxxxxxxxxxxxxxx",
        "VISUAL_MODEL_BASE_URL": "https://openrouter.ai/api/v1/",
        "VISUAL_MODEL_NAME": "qwen/qwen2.5-vl-72b-instruct:free"
      }
    }
  }
}

Variáveis de Ambiente

• DEVICE_ID : Obrigatório. O ID do dispositivo Android, obtido através do comando adb devices.
• SCREEN_LOCK_PASSWORD : Opcional. A senha de bloqueio de tela do dispositivo, usada para desbloquear a tela.
• VISUAL_MODEL_ON : Opcional. Se deve habilitar o modelo visual, o padrão é falso.
• VISUAL_MODEL_API_KEY : Chave da API.
• VISUAL_MODEL_BASE_URL : URL base da API.
• VISUAL_MODEL_NAME : Nome do modelo.

Recursos e Ferramentas

Gerenciamento de Aplicativos

• install_app : Instalar um aplicativo no dispositivo Android
• uninstall_app : Desinstalar um aplicativo do dispositivo Android
• terminate_app : Encerrar um aplicativo em execução no dispositivo Android
• launch_app : Iniciar um aplicativo no dispositivo Android
• list_app : Listar todos os aplicativos instalados no dispositivo Android
• is_app_installed : Verificar se um aplicativo específico está instalado

Controle de Tela

• unlock_screen : Desbloquear a tela do dispositivo Android
• lock_screen : Bloquear a tela do dispositivo Android
• is_screen_locked : Verificar se a tela do dispositivo Android está bloqueada
• is_screen_active : Verificar se a tela do dispositivo Android está ativa

Controle de Entrada

• input_text : Inserir texto no dispositivo Android
• input_key : Inserir pressionamento de tecla no dispositivo Android
• tap : Realizar uma operação de toque na tela em uma posição especificada
• long_tap : Realizar uma operação de toque longo na tela em uma posição especificada
• back : Realizar uma operação de voltar

Controle de Gestos

• swipe_up : Realizar um gesto de deslizar para cima na tela do dispositivo Android
• swipe_down : Realizar um gesto de deslizar para baixo na tela do dispositivo Android
• swipe_left : Realizar um gesto de deslizar para a esquerda na tela do dispositivo Android
• swipe_right : Realizar um gesto de deslizar para a direita na tela do dispositivo Android

Informações do Dispositivo

• screen_size : Obter o tamanho da tela do dispositivo Android
• screen_dpi : Obter o DPI da tela do dispositivo Android
• screenshot_description : Obter a descrição da captura de tela do dispositivo Android
• system_info : Obter informações do sistema do dispositivo Android

Outras Funções

• shell_command : Executar um comando shell no dispositivo Android