Mobile MCP — Instalar & Demo en vivo

Por qué usarlo

Características clave

Agnóstico a la plataforma: mismas herramientas para iOS y Android
Funciona con simuladores, emuladores y dispositivos reales
Captura de pantalla y jerarquía de vistas equivalente al DOM
Instala APK/IPA desde URL o ruta local
No se requiere experiencia en testing móvil

Demo en vivo

Cómo se ve en la práctica

mobile-mcp.replay ▶ listo

0/0

Instalar

Elige tu cliente

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

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

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

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

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

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": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mobile-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "mobile-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mobilenext/mobile-mcp@latest"
        ]
      }
    }
  }
}

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

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest

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

Casos de uso

Usos del mundo real: Mobile MCP

Smoke test de tu app en iOS y Android desde un solo prompt

👤 QA móvil, desarrolladores sin equipo de QA dedicado ⏱ ~20 min intermediate

Cuándo usarlo: Acabas de compilar una build y quieres saber si el flujo de registro sigue funcionando en ambas plataformas.

Requisitos previos

Simulador iniciado — xcrun simctl boot "iPhone 16" y emulator -avd Pixel_7
App instalada — Arrastra el IPA/APK al simulador o usa la herramienta install_app

Flujo

Iniciar sesión

Use mobile-mcp. List all available devices.✓ Copiado

→ Simulador iOS y emulador Android listados
Ejecutar el flujo

On both devices in parallel: open my app, tap "Sign Up", enter [email protected] / password123, tap Continue. Screenshot each step.✓ Copiado

→ Secuencia de capturas en ambos dispositivos
Verificar

On each device, is the "Verify your email" screen visible? If not, report what you see.✓ Copiado

→ Resultado por plataforma con evidencia

Resultado: Informe de éxito/fallo con capturas para ambas plataformas en 2 minutos.

Errores comunes

La cuenta de prueba queda bloqueada por anti-spam — Usa emails desechables por build; rota las cuentas de prueba

Combinar con: filesystem

Generar capturas para App Store en 5 tamaños de dispositivo

👤 Desarrolladores independientes enviando a la App Store ⏱ ~25 min intermediate

Cuándo usarlo: Necesitas capturas de 6,5", 6,7" y 5,5" y no quieres hacerlo manualmente.

Requisitos previos

Simuladores para cada tamaño requerido — Créalos con xcrun simctl usando los tipos de dispositivo apropiados

Flujo

Preparar la matriz

Boot iPhone 15 Pro Max, iPhone 15, iPhone SE simulators. Install my app on each.✓ Copiado

→ Los tres dispositivos listos con la app instalada
Capturar el flujo

On each device, navigate to the 5 key screens (onboarding, feed, detail, settings, upgrade). Screenshot each at full resolution.✓ Copiado

→ Capturas guardadas por dispositivo con convención de nombres

Resultado: Capturas listas para App Store en todos los tamaños requeridos, en una sola ejecución.

Errores comunes

Las capturas incluyen la barra de estado del simulador — Usa --status-bar-style=overridden o posprocesa con crop

Combinar con: filesystem

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

mobile-mcp + filesystem

Guardar capturas en carpetas de QA con versiones

Save every screenshot under /qa/$(date)/ with the test name.✓ Copiado

mobile-mcp + xcodebuild

Compilar, instalar y probar en un solo flujo

Build the iOS app via xcodebuild, install it via mobile-mcp, run the smoke test.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list_devices	none	Siempre lo primero — conoce qué hay disponible	free
launch_app	device_id, bundle_id	Abrir tu app en el dispositivo	free
tap	device_id, selector\|coords	Interactuar con un botón o control	free
type_text	device_id, text: str	Rellenar un campo de texto (debe estar enfocado primero)	free
get_view_hierarchy	device_id	Ver qué hay en pantalla	free
screenshot	device_id, path?: str	Verificación visual	free

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Local
Tokens por llamada: La jerarquía de vistas puede superar los 10k tokens; las capturas son en base64
Monetario: Gratuito
Consejo: Prefiere toques basados en selectores antes que volcar la jerarquía de vistas completa para ahorrar tokens

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: device access (physical USB requires trust dialog)

Almacenamiento de credenciales: Ninguno

Salida de datos: Ninguno desde el MCP; las capturas fluyen al proveedor de LLM si se comparten

No conceder nunca: production device access with PII

No pruebes contra dispositivos con datos de producción — usa cuentas de QA dedicadas

Resolución de problemas

Errores comunes y soluciones

No aparecen dispositivos

Inicia un simulador primero: xcrun simctl boot / emulator -avd X

Verificar: `xcrun simctl list | grep Booted`

tap_at_coords falla

Ejecuta get_view_hierarchy y usa toque basado en selector — las coordenadas se rompen entre tamaños de pantalla

Dispositivo real no confiado

En iOS: Configuración → General → Administración de dispositivos → Confiar. En Android: activa la depuración USB.

Alternativas

Mobile MCP vs otros

Alternativa	Cuándo usarla	Contrapartida
XcodeBuildMCP	Necesitas compilación y prueba solo en iOS, no automatización de UI multiplataforma	Sin Android; más orientado a las herramientas de compilación
Appium	Quieres un framework completo de testing móvil para CI	Mucha más configuración; no es nativo de MCP

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills