Android Tester MCP

Automatiza dispositivos Android usando el SDK de Gbox.

Documentación

Android Tester MCP

Un plugin de Model Context Protocol (MCP) para automatizar dispositivos Android utilizando el SDK de Gbox. Este plugin proporciona herramientas para crear cajas de Android, tomar capturas de pantalla, realizar acciones de interfaz de usuario impulsadas por IA y gestionar aplicaciones.

Características

Crear cajas de Android: Inicia dispositivos Android virtuales o físicos
Captura de pantalla: Toma capturas de pantalla de la pantalla actual
Acciones impulsadas por IA: Realiza acciones de interfaz de usuario usando instrucciones en lenguaje natural
Gestión de aplicaciones: Instala, desinstala y lanza aplicaciones Android
Gestión de cajas: Lista y obtén información sobre tus cajas de Android

Configuración

Instalar dependencias
```
npm install
```
Configurar variables de entorno

Crea un archivo .env en la raíz del proyecto:
```
GBOX_API_KEY=your_gbox_api_key_here
```
Compilar el proyecto
```
npm run build
```

Uso

Este es un servidor MCP que proporciona herramientas para la automatización de Android. Una vez en ejecución, puedes utilizar las siguientes herramientas:

Configuración en 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"
      }
    }
  }
}

Herramientas disponibles

create_android_box: Crea una nueva caja de Android con la configuración especificada
list_boxes: Lista todas las cajas actuales pertenecientes a tu clave de API
get_box: Obtén información detallada sobre una caja específica
get_screenshot: Toma una captura de pantalla del dispositivo Android
ai_action: Realiza acciones de interfaz de usuario usando lenguaje natural (por ejemplo, "haz clic en el botón de inicio de sesión")
install_apk: Instala un archivo APK desde una ruta local o URL
uninstall_apk: Desinstala una aplicación por nombre de paquete
open_app: Lanza una aplicación instalada

Requisitos

Node.js y npm
Clave de API de Gbox válida
TypeScript (para desarrollo)

Ejemplos de prompts en Cursor

Prueba el APK de este proyecto como un usuario, simplemente crea un entorno Android en gbox, instálalo y pruébalo instruyendo a la herramienta MCP ai_action. Sigue desarrollando y probando hasta que se cumplan todos los requisitos.