Mobile Next

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

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que permite automatización móvil escalable y desarrollo a través de una interfaz independiente de 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 instantáneas estructuradas de accesibilidad 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 reales de iOS y Android en la nube con Mobile Next Cloud — las 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 con scripts 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

• 🚀 Prioridad a la accesibilidad — 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 código de integración por plataforma — describe el objetivo y el agente lo hace.
• 🧰 Control total del dispositivo: toques, deslizamientos y gestos; instalación/inicio/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 la pantalla del dispositivo
• mobile_set_orientation - Cambia la orientación de la pantalla (vertical/horizontal)

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 - Inicia 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 un 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 - Hace 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 (INICIO, ATRÁS, SUBIR/BAJAR VOLUMEN, ENTER, etc.)
• mobile_open_url - Abre URLs en el navegador del dispositivo

Informes de fallos

• 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

🏗️ 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
• Herramientas de plataforma de Android
• node.js v20+
• Modelos fundamentales o agentes compatibles con MCP, como Claude MCP, OpenAI Agent SDK, Copilot Studio

Para dispositivos reales de iOS (los simuladores y Android no necesitan estos), también necesitarás go-ios, WebDriverAgent instalado en el dispositivo, y un túnel de dispositivo iOS. Consulta la wiki para la configuración.

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 obtener 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, revisa 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, escribe el prompt:

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

Modo de servidor SSE

Por defecto, Mobile MCP se ejecuta sobre stdio. Para iniciar un servidor SSE 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.

Autorización

Para requerir autorización con token Bearer en el servidor SSE, 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.

🛠️ 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 los prompts a continuación para validar rápidamente, probar e iterar en interacciones de interfaz, leer información de la pantalla, y recorrer flujos de trabajo complejos. Sé descriptivo, directo al punto.

✨ Ejemplos de prompts

Flujos de trabajo

Puedes especificar flujos de trabajo detallados en un solo prompt, verificar lógica de negocio, configurar automatizaciones. Puedes ir más allá:

Busca un video, comenta, 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 aplicación exitosa de contador de pasos, regístrate, configura un entrenamiento y califica la aplicación 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 de 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 tiempo y envía un mensaje de 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.

• Programa 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 iOS o Android (requiere herramientas y controladores de plataforma adecuados)

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

Telemetría

Mobile MCP recopila telemetría de uso anónima a través de PostHog. Para desactivarla, establece 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óviles." 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 basa 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 muy 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.

• ⭐ Marca el repositorio con una estrella — 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 y contacto.