Sobre el proyecto

Mobile MCP es un servidor de Model Context Protocol (MCP) para desarrollo y automatización móvil. Expone una interfaz independiente de la plataforma para que agentes y LLMs puedan interactuar con aplicaciones nativas de iOS y Android sin necesidad de experiencia separada en iOS o Android. Funciona con clientes compatibles con MCP como Claude Code, Codex, Gemini, GitHub Copilot y Antigravity, y puede apuntar a dispositivos locales o remotos a través de un servicio en la nube alojado. Los objetivos compatibles incluyen simuladores de iOS (a través de Xcode y xcrun simctl), dispositivos iOS reales conectados por USB, emuladores de Android (vía adb) y dispositivos Android reales con depuración USB habilitada. El servidor se distribuye como un paquete npm y normalmente se lanza con npx, ya sea sobre stdio o como un servidor HTTP Streamable usando una bandera --listen. Un token Bearer opcional puede ser requerido para el modo HTTP mediante una variable de entorno. El conjunto de herramientas cubre gestión de dispositivos (listar dispositivos, tamaño de pantalla, orientación obtener/establecer, anulación de ubicación GPS, portapapeles leer/reemplazar), gestión de aplicaciones (listar, app en primer plano, lanzar, terminar, instalar, desinstalar), interacción con pantalla (capturas de pantalla, guardar capturas, listar elementos de UI con coordenadas, toques, doble toque, toque prolongado, deslizamientos, grabación de pantalla), entrada y navegación (escribir texto, botones de hardware, abrir URLs), y registros e informes de fallos (registros de dispositivo, listado y recuperación de fallos). Una herramienta de comando por lotes ejecuta varias herramientas en secuencia en una sola llamada. Las herramientas de dispositivos remotos permiten iniciar sesión en un proveedor de nube, listar, asignar y liberar dispositivos en la nube. El proyecto enfatiza un enfoque de accesibilidad primero: impulsa las aplicaciones desde el árbol de accesibilidad nativo en lugar de un modelo de visión, recurriendo a capturas de pantalla y coordenadas cuando es necesario, lo que el README presenta como más rápido y económico que los enfoques solo de capturas. La salida se describe como estructurada y determinista. Los requisitos previos incluyen herramientas de línea de comandos de Xcode, herramientas de plataforma de Android, Node.js v20 o posterior, y un agente o modelo compatible con MCP. Se proporcionan ejemplos de configuración para muchos clientes, incluidos Amp, Antigravity, Cline, Claude Code, Claude Desktop, Codex, Copilot, Cursor, Gemini CLI, Goose, Kiro, opencode y Windsurf. Las variables de entorno controlan la autenticación, la exclusión de telemetría, los esquemas de URL inseguros y un modo robot heredado. Se recopila telemetría anónima por defecto y se puede deshabilitar. El repositorio también señala proyectos relacionados: mobilewright para pruebas móviles deterministas repetibles, mobilecli como la CLI de dispositivo subyacente, y una oferta en la nube para dispositivos reales bajo demanda. Se enlazan documentación, una hoja de ruta, pautas de contribución y un código de conducta. El README indica que el servidor se ejecuta localmente y se comunica solo con dispositivos conectados, con una política de privacidad separada para detalles de recopilación de datos.