Android-MCP MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

10 herramientas: estado, clic, clic largo, escribir, deslizar, arrastrar, presionar, esperar, notificación, shell
Selección de dispositivo: serie USB, IP WiFi: puerto o detección automática
La herramienta de estado captura el árbol de la interfaz de usuario para afirmaciones automatizadas
La herramienta Shell expone el adb shell completo para operaciones avanzadas
Latencia típica de 2 a 4 segundos por acción: está bien para control de calidad, no para juegos en tiempo real

Demo en vivo

Cómo se ve en la práctica

android.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "android",
      "command": "uvx",
      "args": [
        "Android-MCP"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "android": {
      "command": {
        "path": "uvx",
        "args": [
          "Android-MCP"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add android -- uvx Android-MCP

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Android-MCP

Automatiza una prueba de humo de tu aplicación de Android

👤 Ingenieros de control de calidad móviles, equipos de desarrollo sin un marco de prueba ⏱ ~30 min intermediate

Cuándo usarlo: Desea que "la aplicación se abra, inicie sesión y se cargue la pantalla principal" se ejecute automáticamente antes de cada lanzamiento.

Requisitos previos

ADB instalado y dispositivo conectado — Android Studio incluye ADB; adb devices debería mostrar su dispositivo
El dispositivo tiene depuración USB o depuración inalámbrica activada — Configuración > Opciones de desarrollador > Depuración USB

Flujo

Capturar el estado actual

Obtener el estado de la interfaz de usuario: ¿en qué pantalla estoy y qué elementos son visibles?✓ Copiado

→ Árbol de interfaz de usuario con elementos etiquetados
Ejecutar el flujo

Toque el botón 'Iniciar sesión', escriba '[email protected]' en el campo de correo electrónico, 'P@ss' en la contraseña, envíe.✓ Copiado

→ La aplicación pasa a casa
Afirmar el éxito

Verifique que el banner de "Bienvenida" de la pantalla de inicio esté visible. Si no, fracasa.✓ Copiado

→ Veredicto de pasa/falla

Resultado: Una prueba de humo programable que puedes ejecutar en cada compilación.

Errores comunes

Cambio de coordenadas entre tamaños de dispositivos. — Prefiera consultas de State-Tool que encuentren elementos por etiqueta/id, luego haga clic en las coordenadas devueltas
El flujo se interrumpe en las pruebas A/B — Fijar configuración de compilación o deshabilitar experimentos para compilaciones de control de calidad

Combinar con: github

Ejecute una demostración repetible del producto en un dispositivo en vivo

👤 Ingenieros de ventas, gente de productos que hacen demostraciones para inversores. ⏱ ~20 min intermediate

Cuándo usarlo: Quieres que la aplicación funcione con manos libres mientras hablas.

Flujo

Guión de la demostración

Escribe estos 5 pasos con pausas de 3 segundos: abre la aplicación, toca Explorar, desplázate hasta la Categoría B, toca el elemento X y toma una captura de pantalla.✓ Copiado

→ plan de pasos
Ejecución en seco

Ejecutar. Haga una pausa entre los pasos para que pueda narrar.✓ Copiado

→ El dispositivo sigue

Resultado: Una demostración sin fallos que puedes volver a ejecutar de forma idéntica.

Notificaciones de clasificación en un dispositivo de desarrollo

👤 Desarrolladores que prueban flujos de notificación ⏱ ~10 min beginner

Cuándo usarlo: Verificando que las notificaciones push lleguen y se vean bien.

Flujo

Leer notificaciones recientes

Listar notificaciones activas. Marca cualquiera de com.myapp.prod.✓ Copiado

→ Lista filtrada
inspeccionar uno

Extraiga el contenido completo de la última notificación de myapp; ¿Coincide con nuestro formato esperado?✓ Copiado

→ Diferencia con lo esperado

Resultado: Confirmación rápida de que su proceso de envío funciona.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

android + github

Ejecute pruebas de humo en relaciones públicas y publique resultados

Cuando el PR #88 tenga un nuevo artefacto APK, instálelo en el dispositivo conectado, ejecute el flujo de prueba de humo y comente los resultados en el PR.✓ Copiado

android + filesystem

Guarde capturas de pantalla y registros como artefactos de control de calidad

Tome una captura de pantalla después de cada paso del flujo de demostración y guárdela en ./qa/2026-04-14/step-N.png.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
State-Tool	(none)	Siempre primero: sepa lo que hay en la pantalla	free
Click-Tool	x: int, y: int	Toque en un punto devuelto por el Estado	free
Long-Click-Tool	x, y, duration_ms?	Menús contextuales	free
Type-Tool	text: str, clear_first?: bool	Ingrese texto en el campo enfocado	free
Swipe-Tool	x1,y1,x2,y2, duration_ms?	Desplazarse o hacer un gesto	free
Drag-Tool	start_x,y,end_x,y	Flujos de arrastrar y soltar	free
Press-Tool	key: Back\|Home\|VolumeUp\|...	Teclas de hardware/navegación del sistema	free
Wait-Tool	ms: int	Esperar animación/transición	free
Notification-Tool	(none) or package: str	Inspeccionar notificaciones	free
Shell-Tool	cmd: str	Trampilla de escape para registros, comandos am/pm, etc.	free (but powerful — dangerous)

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguna - todas locales a través de ADB
Tokens por llamada: La herramienta de estado devuelve árboles de interfaz de usuario que pueden tener entre 2 y 10 000 tokens en pantallas densas
Monetario: Gratis
Consejo: Pídale a State que filtre por una consulta ("buscar botones con Iniciar sesión") en lugar de deshacerse de todo el árbol.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Ninguno; La confianza de ADB está en el dispositivo

Salida de datos: Todo local; ADB a través de USB o Wi-Fi local únicamente

No conceder nunca: Shell-Tool on devices with production data — it can read private files

Shell-Tool es esencialmente "adb shell": trátelo como un privilegio de root en dispositivos depurables.
La depuración inalámbrica expone ADB en su LAN; desactívela cuando no esté realizando pruebas.

Resolución de problemas

Errores comunes y soluciones

adb: device unauthorized

Acepte la solicitud de huella digital en la pantalla del dispositivo y luego vuelva a intentarlo.

Verificar: adb devices

No devices found

Verifique que la depuración de USB esté activada y que el cable USB admita datos. Para WiFi, verifique ip: puerto con adb connect.

Verificar: adb devices

Coordinates off on different screen

Utilice State-Tool para obtener las coordenadas actuales del elemento etiquetado en lugar de codificar x,y.

Verificar: Call State before click

Type-Tool inserts garbage characters

El dispositivo utiliza un teclado fuera de EE. UU.; cambie a EE. UU. o use adb shell input text a través de Shell-Tool.

Verificar: adb shell settings get secure default_input_method

Alternativas

Android-MCP vs otros

Alternativa	Cuándo usarla	Contrapartida
Appium	Quiere un marco de control de calidad completo con afirmaciones e informes	Configuración pesada; sin capa MCP
Maestro	Pruebas de UI basadas en YAML	Sin integración MCP

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills