Android Tester MCP

Automatize dispositivos Android usando o Gbox SDK.

GitHub

Documentação

Android Tester MCP

Um plugin Model Context Protocol (MCP) para automatizar dispositivos Android usando o SDK Gbox. Este plugin fornece ferramentas para criar boxes Android, capturar screenshots, executar ações de UI com IA e gerenciar aplicativos.

Recursos

  • Criar Boxes Android: Iniciar dispositivos Android virtuais ou físicos
  • Captura de Screenshots: Capturar screenshots da tela atual
  • Ações com IA: Executar ações de UI usando instruções em linguagem natural
  • Gerenciamento de Apps: Instalar, desinstalar e iniciar aplicativos Android
  • Gerenciamento de Boxes: Listar e obter informações sobre seus boxes Android

Configuração

  1. Instalar Dependências

    npm install

  2. Definir Variáveis de Ambiente

    Crie um arquivo .env na raiz do projeto:

    GBOX_API_KEY=your_gbox_api_key_here

  3. Compilar o Projeto

    npm run build

Uso

Este é um servidor MCP que fornece ferramentas para automação Android. Uma vez em execução, você pode usar as seguintes ferramentas:

Configuração no Cursor

{
  "mcpServers": {
    "gbox-android": {
      "command": "node",
      "args": ["/YOU_PATH_TO_THIS_REPO/android-tester-mcp/dist/index.js"],
      "env": {
        "GBOX_API_KEY": "YOUR API KEY"
      }
    }
  }
}

Ferramentas Disponíveis

  • create_android_box: Criar um novo box Android com a configuração especificada
  • list_boxes: Listar todos os boxes atuais pertencentes à sua chave de API
  • get_box: Obter informações detalhadas sobre um box específico
  • get_screenshot: Capturar um screenshot do dispositivo Android
  • ai_action: Executar ações de UI usando linguagem natural (ex.: "clique no botão de login")
  • install_apk: Instalar um arquivo APK de um caminho local ou URL
  • uninstall_apk: Desinstalar um aplicativo pelo nome do pacote
  • open_app: Iniciar um aplicativo instalado

Requisitos

  • Node.js e npm
  • Chave de API Gbox válida
  • TypeScript (para desenvolvimento)

Exemplos de Prompts no Cursor

Teste o apk deste projeto como um usuário, crie um ambiente android no gbox, instale-o e teste-o instruindo a ferramenta ai_action do MCP. Continue desenvolvendo e testando até que todos os requisitos sejam atendidos.