Mobile Next

Mobile Next - Servidor MCP para Desarrollo y Automatización Móvil | iOS, Android, Simulador, Emulador y Dispositivos Reales

Español | 日本語 | 简体中文

Este es un Servidor MCP que permite automatización móvil escalable y desarrollo a través de una interfaz independiente de la plataforma, eliminando la necesidad de conocimientos distintos de iOS o Android. Puedes ejecutarlo en emuladores, simuladores y dispositivos reales (iOS y Android).

Este servidor permite que Agentes y LLMs interactúen con aplicaciones y dispositivos nativos de iOS/Android mediante capturas de accesibilidad estructuradas o toques basados en coordenadas a partir de capturas de pantalla.

Funciona con Claude Code, Codex, Gemini, GitHub Copilot, Antigravity — o cualquier cliente compatible con MCP.

Ejecútalo contra dispositivos en tu propia máquina, o contra dispositivos iOS y Android reales en la nube con Mobile Next Cloud — mismas herramientas, sin configuración local.

https://github.com/user-attachments/assets/bb084777-beb3-4930-ae6f-8d3fe694ddde

Casos de uso principales

Cómo ayudamos a escalar la automatización móvil:

• 📲 Automatización de aplicaciones nativas (iOS y Android) para escenarios de pruebas o entrada de datos.
• 📝 Flujos scripteados e interacciones con formularios sin controlar manualmente simuladores/emuladores o dispositivos reales (iPhone, Samsung, Google Pixel, etc.)
• 🧭 Automatización de recorridos de usuario de múltiples pasos impulsados por un LLM
• 👆 Interacción general con aplicaciones móviles para frameworks basados en agentes
• 🤖 Habilita la comunicación agente-a-agente para casos de uso de automatización móvil y extracción de datos

Características principales

• 🚀 Accesibilidad primero — rápido y económico: impulsa aplicaciones desde el árbol de accesibilidad nativo (sin modelo de visión, sin tokens de imagen), recurriendo a capturas de pantalla + coordenadas solo cuando es necesario.
• 📱 Una API, todos los objetivos: las mismas herramientas funcionan en iOS y Android — simuladores, emuladores y dispositivos reales.
• 🧠 No se requiere experiencia en plataformas: sin XCUITest, sin Espresso, sin pegamento por plataforma — describe el objetivo y el agente lo hace.
• 🧰 Control completo del dispositivo: toques, deslizamientos y gestos; instalación/lanzamiento/terminación de aplicaciones; grabación de pantalla; botones de hardware; enlaces profundos; orientación.
• 📊 Salida estructurada y determinista: lee elementos de interfaz reales y extrae datos estructurados, reduciendo la ambigüedad de los enfoques basados solo en capturas de pantalla.

🎯 Soporte de plataformas

🔧 Herramientas MCP disponibles

Gestión de dispositivos

• mobile_list_available_devices - Lista todos los dispositivos disponibles (simuladores, emuladores y dispositivos reales)
• mobile_get_screen_size - Obtiene el tamaño de pantalla del dispositivo móvil en píxeles
• mobile_get_orientation - Obtiene la orientación actual de pantalla del dispositivo
• mobile_set_orientation - Cambia la orientación de pantalla (vertical/horizontal)
• mobile_set_location - Sobrescribe la ubicación GPS reportada por el dispositivo, o limpia la sobrescritura
• mobile_clipboard - Lee o reemplaza el portapapeles del dispositivo

Dispositivos remotos (Mobile Next Cloud)

• mobile_login_to_cloud_provider - Autentica esta máquina con el proveedor de dispositivos en la nube (inicio de sesión basado en código de dispositivo en el navegador)
• mobile_list_remote_devices - Lista los modelos de dispositivos disponibles para reservar de la flota en la nube
• mobile_allocate_remote_device - Reserva un dispositivo físico en la nube para uso exclusivo
• mobile_release_remote_device - Libera un dispositivo en la nube reservado de vuelta a la flota

Gestión de aplicaciones

• mobile_list_apps - Lista todas las aplicaciones instaladas en el dispositivo
• mobile_get_foreground_app - Obtiene la aplicación actualmente en primer plano
• mobile_launch_app - Lanza una aplicación usando su nombre de paquete
• mobile_terminate_app - Detiene y termina una aplicación en ejecución
• mobile_install_app - Instala una aplicación desde archivo (.apk, .ipa, .app, .zip)
• mobile_uninstall_app - Desinstala una aplicación usando el ID de paquete o nombre de paquete

Interacción con pantalla

• mobile_take_screenshot - Toma una captura de pantalla para entender qué hay en pantalla
• mobile_save_screenshot - Guarda una captura de pantalla en un archivo
• mobile_list_elements_on_screen - Lista elementos de interfaz con sus coordenadas y propiedades
• mobile_click_on_screen_at_coordinates - Haz clic en coordenadas x,y específicas
• mobile_double_tap_on_screen - Doble toque en coordenadas específicas
• mobile_long_press_on_screen_at_coordinates - Pulsación larga en coordenadas específicas
• mobile_swipe_on_screen - Desliza en cualquier dirección (arriba, abajo, izquierda, derecha)
• mobile_start_screen_recording - Inicia la grabación de la pantalla del dispositivo en un archivo de video
• mobile_stop_screen_recording - Detiene la grabación de pantalla activa y guarda el video

Entrada y navegación

• mobile_type_keys - Escribe texto en elementos enfocados con envío opcional
• mobile_press_button - Presiona botones del dispositivo (HOME, BACK, VOLUME_UP/DOWN, ENTER, etc.)
• mobile_open_url - Abre URLs en el navegador del dispositivo

Registros e informes de fallos

• mobile_get_device_logs - Recopila registros de dispositivo en vivo (logcat en Android, registro unificado en iOS), opcionalmente guardados en un archivo
• mobile_list_crashes - Lista los informes de fallos disponibles en el dispositivo
• mobile_get_crash - Obtiene el contenido completo de un informe de fallos por su ID
• mobile_batch_commands - Ejecuta múltiples herramientas en secuencia en una sola llamada (por ejemplo, clic, escribir, clic), opcionalmente listando elementos de pantalla al final

🏗️ Arquitectura de Mobile MCP

📚 Página de wiki

Más detalles en nuestra página de wiki para preguntas relacionadas con configuración, ajustes y depuración.

Requisitos previos

Lo que necesitarás para conectar MCP con tu agente y dispositivos móviles:

• Herramientas de línea de comandos de Xcode
• Android Platform Tools
• node.js v20+
• MCP modelos fundamentales o agentes compatibles, como Claude MCP, OpenAI Agent SDK, Copilot Studio

Instalación y configuración

Configuración estándar funciona en la mayoría de las herramientas:

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

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

amp mcp add mobile-mcp -- npx @mobilenext/mobile-mcp@latest

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

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

codex mcp add mobile-mcp npx "@mobilenext/mobile-mcp@latest"

[mcp_servers.mobile-mcp]
command = "npx"
args = ["@mobilenext/mobile-mcp@latest"]

/mcp add

{
  "mcpServers": {
    "mobile-mcp": {
      "type": "local",
      "command": "npx",
      "tools": [
        "*"
      ],
      "args": [
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

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

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mobile-mcp": {
      "type": "local",
      "command": [
        "npx",
        "@mobilenext/mobile-mcp@latest"
      ],
      "enabled": true
    }
  }
}

npx @mobilenext/mobile-mcp@latest

¡Lee más en nuestra wiki! 🚀

✅ Verifica que funciona

Una vez que el servidor esté configurado, pide a tu agente que liste los dispositivos:

lista los dispositivos disponibles

Deberías recibir tus simuladores, emuladores y dispositivos conectados en ejecución. Si es así, Mobile MCP está conectado correctamente. Si la lista está vacía, asegúrate de que un simulador o emulador esté en ejecución (consulta Requisitos previos) — para más ayuda, consulta la wiki.

☁️ Escala, usa un dispositivo en la nube

¿Quieres escalar a cientos de dispositivos? ¿Usar Mobile MCP en tu pipeline de CI/CD?

En tu agente, solicita:

log in to mobile next cloud and then show me which remote devices are available to me

Modo de servidor HTTP Streamable

Por defecto, Mobile MCP se ejecuta sobre stdio. Para iniciar un servidor Streamable HTTP en su lugar, usa la bandera --listen:

npx @mobilenext/mobile-mcp@latest --listen 3000

Esto se vincula a localhost:3000. Para vincularse a una interfaz específica:

npx @mobilenext/mobile-mcp@latest --listen 0.0.0.0:3000

Luego configura tu cliente MCP para conectarse a http://<host>:3000/mcp (o https://…/mcp detrás de TLS). El endpoint acepta Streamable HTTP (POST en /mcp); el modo remoto es sin estado (sin afinidad de sesión requerida), lo que funciona bien con Smithery y otros hosts horizontales.

Nota de migración: --listen anteriormente servía el transporte HTTP+SSE obsoleto en /mcp. Los clientes deben usar Streamable HTTP contra http(s)://host:port/mcp. El flujo antiguo de solo SSE en /mcp ya no está disponible.

Al vincularse a localhost, la protección de rebinding de DNS del encabezado Host se habilita automáticamente.

Autorización

Para requerir autorización de token Bearer en el servidor HTTP, establece la variable de entorno MOBILEMCP_AUTH:

MOBILEMCP_AUTH=my-secret-token npx @mobilenext/mobile-mcp@latest --listen 3000

Cuando se establece, todas las solicitudes deben incluir el encabezado Authorization: Bearer my-secret-token. Cuando no se establece, el servidor acepta conexiones no autenticadas y registra una advertencia.

🛠️ Cómo usar

Después de agregar el servidor MCP a tu IDE/Cliente, puedes indicar a tu asistente de IA que use las herramientas disponibles. Por ejemplo, en el modo agente de Cursor, podrías usar las indicaciones a continuación para validar, probar e iterar rápidamente en interacciones de interfaz, leer información de la pantalla y recorrer flujos de trabajo complejos. Sé descriptivo, directo al punto.

✨ Ejemplos de indicaciones

Flujos de trabajo

Puedes especificar flujos de trabajo detallados en una sola indicación, verificar lógica de negocio, configurar automatizaciones. Puedes volverte loco: Busca un video, coméntalo, dale "me gusta" y compártelo.

Find the video called " Beginner Recipe for Tonkotsu Ramen" by Way of
Ramen, click on like video, after liking write a comment " this was
delicious, will make it next Friday", share the video with the first
contact in your whatsapp list.

Descarga una app contadora de pasos exitosa, regístrate, configura tu entrenamiento y califica la app con 5 estrellas

Find and Download a free "Pomodoro" app that has more than 1k stars.
Launch the app, register with my email, after registration find how to
start a pomodoro timer. When the pomodoro timer started, go back to the
app store and rate the app 5 stars, and leave a comment how useful the
app is.

Busca en Substack, lee, resalta, comenta y guarda un artículo

Open Substack website, search for "Latest trends in AI automation 2025",
open the first article, highlight the section titled "Emerging AI trends",
and save article to reading list for later review, comment a random
paragraph summary.

Reserva una clase de entrenamiento, configura un temporizador

Open ClassPass, search for yoga classes tomorrow morning within 2 miles,
book the highest-rated class at 7 AM, confirm reservation,
setup a timer for the booked slot in the phone

Encuentra un evento local, configura un evento en el calendario

Open Eventbrite, search for AI startup meetup events happening this
weekend in "Austin, TX", select the most popular one, register and RSVP
yes to the event, setup a calendar event as a reminder.

Revisa el pronóstico del clima y envía un mensaje por Whatsapp/Telegram/Slack

Open Weather app, check tomorrow's weather forecast for "Berlin", and
send the summary via Whatsapp/Telegram/Slack to contact "Lauren Trown",
thumbs up their response.

• Agenda una reunión en Zoom y comparte la invitación por correo electrónico

Open Zoom app, schedule a meeting titled "AI Hackathon" for tomorrow at
10AM with a duration of 1 hour, copy the invitation link, and send it via
Gmail to contacts "team@example.com".

Ejecución y configuración

Variables de entorno

Simuladores, Emuladores y Dispositivos Reales

Cuando se inicia, Mobile MCP puede conectarse a:

• Simuladores de iOS en macOS/Linux
• Emuladores de Android en Linux/Windows/macOS
• Dispositivos reales de iOS o Android (requiere herramientas de plataforma y controladores adecuados)

Asegúrate de tener tus SDKs de plataforma móvil (Xcode, Android SDK) instalados y configurados correctamente antes de ejecutar Mobile Next Mobile MCP.

Telemetría

Mobile MCP recopila telemetría de uso anónima a través de PostHog y Scarf. Para desactivarla, configura la variable de entorno MOBILEMCP_DISABLE_TELEMETRY:

MOBILEMCP_DISABLE_TELEMETRY=1 npx @mobilenext/mobile-mcp@latest

Para configuraciones json:

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

Ejecución en modo "headless" en Simuladores/Emuladores

Cuando no tienes un dispositivo real conectado a tu máquina, puedes ejecutar Mobile MCP con un emulador o simulador en segundo plano.

Por ejemplo, en Android:

1. Inicia un emulador (comando avdmanager / emulator).
2. Ejecuta Mobile MCP con las banderas deseadas

En iOS, necesitarás Xcode y ejecutar el Simulador antes de usar Mobile MCP con esa instancia de simulador.

• xcrun simctl list
• xcrun simctl boot "iPhone 16"

🧩 Parte de Mobile Next

Mobile MCP es una pieza de un conjunto de herramientas para controlar dispositivos móviles reales:

• mobilewright — "Playwright para móvil." Cuando estés listo para convertir la exploración impulsada por agentes en pruebas repetibles y deterministas para iOS y Android, pasa a mobilewright.
• mobilecli — el CLI universal de dispositivos sobre el que se construye Mobile MCP: controla dispositivos, simuladores y emuladores desde la línea de comandos o una API JSON-RPC.
• Mobile Next Cloud — la misma pila, alquilada: dispositivos iOS y Android reales bajo demanda. Solo dile a tu agente: log in to mobile next cloud and then show me which remote devices are available to me para comenzar.

🚀 Hoja de ruta

Estamos mejorando continuamente Mobile MCP. Consulta lo que estamos construyendo a continuación en ROADMAP.md — las prioridades están fuertemente influenciadas por los comentarios de la comunidad, así que cuéntanos qué te gustaría ver.

🤝 Contribuciones

Las contribuciones son bienvenidas: código, documentación, informes de errores e ideas.

• ⭐ Dale una estrella al repositorio — la forma más fácil de ayudar a otros a descubrir Mobile MCP.
• Lee CONTRIBUTING.md para saber cómo compilar, probar y abrir una solicitud de extracción.
• Explora problemas abiertos para encontrar algo en lo que trabajar.
• Las preguntas e ideas también son bienvenidas en nuestra comunidad de Slack.

También revisa nuestro Código de Conducta.

Gracias a todos los contribuyentes ❤️

Apreciamos a todos los que han ayudado a mejorar este proyecto.

Política de Privacidad

Mobile MCP se ejecuta localmente y solo se comunica con los dispositivos que conectas. Consulta la política de privacidad de Mobile Next en https://mobilenext.ai/privacy para obtener información sobre recopilación de datos, uso, retención e información de contacto.