Android ADB Server

Controla dispositivos Android usando el Android Debug Bridge (ADB).

GitHub
27

Documentación

English 简体中文

🚀 mcp-android-adb-server

smithery badge

Un servicio MCP para operar dispositivos Android a través de ADB.

2025-04-01: Se añadió soporte para obtener contenido de descripción de pantalla utilizando modelos visuales como qwen2.5-vl.

Instalación 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

Configuración

{
  "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"
      }
    }
  }
}

Variables de Entorno

  • DEVICE_ID : Obligatorio. El ID del dispositivo Android, obtenible mediante el comando adb devices.
  • SCREEN_LOCK_PASSWORD : Opcional. La contraseña de bloqueo de pantalla del dispositivo, utilizada para desbloquear la pantalla.
  • VISUAL_MODEL_ON : Opcional. Si se habilita el modelo visual, por defecto es false.
  • VISUAL_MODEL_API_KEY : Clave de API.
  • VISUAL_MODEL_BASE_URL : URL base de la API.
  • VISUAL_MODEL_NAME : Nombre del modelo.

Funciones y Herramientas

Gestión de Aplicaciones

  • install_app : Instalar una aplicación en el dispositivo Android
  • uninstall_app : Desinstalar una aplicación del dispositivo Android
  • terminate_app : Terminar una aplicación en ejecución en el dispositivo Android
  • launch_app : Iniciar una aplicación en el dispositivo Android
  • list_app : Listar todas las aplicaciones instaladas en el dispositivo Android
  • is_app_installed : Comprobar si una aplicación específica está instalada

Control de Pantalla

  • unlock_screen : Desbloquear la pantalla del dispositivo Android
  • lock_screen : Bloquear la pantalla del dispositivo Android
  • is_screen_locked : Comprobar si la pantalla del dispositivo Android está bloqueada
  • is_screen_active : Comprobar si la pantalla del dispositivo Android está activa

Control de Entrada

  • input_text : Introducir texto en el dispositivo Android
  • input_key : Introducir una pulsación de tecla en el dispositivo Android
  • tap : Realizar una operación de toque en la pantalla en una posición especificada
  • long_tap : Realizar una operación de pulsación larga en la pantalla en una posición especificada
  • back : Realizar una operación de retroceso

Control de Gestos

  • swipe_up : Realizar un gesto de deslizamiento hacia arriba en la pantalla del dispositivo Android
  • swipe_down : Realizar un gesto de deslizamiento hacia abajo en la pantalla del dispositivo Android
  • swipe_left : Realizar un gesto de deslizamiento hacia la izquierda en la pantalla del dispositivo Android
  • swipe_right : Realizar un gesto de deslizamiento hacia la derecha en la pantalla del dispositivo Android

Información del Dispositivo

  • screen_size : Obtener el tamaño de pantalla del dispositivo Android
  • screen_dpi : Obtener los DPI de pantalla del dispositivo Android
  • screenshot_description : Obtener la descripción de la captura de pantalla del dispositivo Android
  • system_info : Obtener información del sistema del dispositivo Android

Otras Funciones

  • shell_command : Ejecutar un comando shell en el dispositivo Android