Repolode
Enviar
jfarcand

jfarcand/mirroir-mcp

Servidor MCP que permite a cualquier agente de IA controlar un iPhone sin modificar mediante iPhone Mirroring en macOS, sin Developer Mode, Xcode ni WebDriverAgent.

Ver en GitHubSitio web
Estrellas
281
Forks
38
Issues abiertos
3
Último commit
hace 9 horas

¿Qué es?

mirroir-mcp es un servidor MCP para macOS que controla un iPhone real y sin modificar mediante la función iPhone Mirroring de Apple. Un cliente de IA puede observar la pantalla con OCR o visión y luego tocar, deslizar, escribir y pulsar teclas del sistema. Como funciona sobre la pantalla del propio teléfono, puede acceder a apps de App Store que el usuario no podría compilar ni instrumentar por su cuenta.

Además del ciclo básico de control, ofrece herramientas de nivel superior para navegar, desplazarse y gestionar el ciclo de vida de las apps. Un agente puede explorar una app en anchura y generar flujos de trabajo SKILL.md. Las skills se pueden compilar para reproducirlas sin un LLM mediante la CLI `mirroir test`, que genera resultados JUnit e indica de forma diferenciada si hay desviaciones, para su uso en CI.

El proyecto también incluye `mirroir-run`, un runner de Rust que combina pasos en iPhone con pasos web (Playwright), HTTP y de subprocesos en un mismo escenario. Para su parte de iOS se necesita un Mac con iPhone Mirroring conectado; las demás superficies funcionan en Linux.

Funciones clave

  • 01Controla un iPhone sin modificar mediante iPhone Mirroring: permite tocar, deslizar, escribir e introducir teclas.
  • 02Lee la pantalla mediante OCR de Apple Vision, detección opcional de iconos con YOLO o el modo de visión de IA.
  • 03Funciona con cualquier cliente MCP y ofrece 38 herramientas.
  • 04Explora apps y genera skills SKILL.md reproducibles.
  • 05Reproduce skills compiladas desde la CLI sin un LLM y genera informes JUnit.
  • 06Falla de forma segura por defecto, con configuración de permisos y listas de apps bloqueadas.

Casos de uso

  • Ejecutar pruebas smoke de extremo a extremo en apps de App Store que no se pueden instrumentar.
  • Permitir que un asistente de IA realice tareas cotidianas en el teléfono, como enviar mensajes o crear eventos en el calendario.
  • Grabar un recorrido manual y reproducirlo como escenario de CI.
  • Combinar comprobaciones en iPhone y páginas web en una única prueba que abarque varias superficies.

Inicio rápido

  1. 1

    Instala el servidor con npx (requiere macOS 15 o posterior y Duplicación del iPhone)

    npx -y mirroir-mcp install
  2. 2

    Cuando macOS lo solicite al hacer la primera captura de pantalla, concede los permisos de Grabación de pantalla y Accesibilidad

  3. 3

    Registra mirroir como servidor MCP en Claude Code

    claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp

Antes de usarlo

  • Solo funciona en macOS 15 o posterior con Duplicación del iPhone; no es compatible con Android ni con iOS Simulator.
  • No permite jugar a juegos con controles de reacción rápida o multitáctiles, porque Duplicación del iPhone solo ofrece un puntero.

En colecciones

Servidores MCP para Claude CodeHerramientas, skills y plugins para Claude CodeFrameworks y apps de agentes de IA open sourceServidores MCPApps open source para MacFrameworks de pruebas y herramientas de automatización

Temas

#mcp#ios-automation#mobile-testing#computer-use#ai-agent#macos#test-automation#ai-testing#appium-alternative#claude-code

Preguntas frecuentes

¿Qué es mirroir-mcp?
Servidor MCP que permite a cualquier agente de IA controlar un iPhone sin modificar mediante iPhone Mirroring en macOS, sin Developer Mode, Xcode ni WebDriverAgent. mirroir-mcp es un servidor MCP para macOS que controla un iPhone real y sin modificar mediante la función iPhone Mirroring de Apple. Un cliente de IA puede observar la pantalla con OCR o visión y luego tocar, deslizar, escribir y pulsar teclas del sistema. Como funciona sobre la pantalla del propio teléfono, puede acceder a apps de App Store que el usuario no podría compilar ni instrumentar por su cuenta.
¿mirroir-mcp es gratuito? ¿Qué licencia tiene?
mirroir-mcp es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mirroir-mcp sigue mantenido?
Mantenimiento activo. El último commit de mirroir-mcp fue el 6 nov 2026.
¿Para qué puedo usar mirroir-mcp?
Ejecutar pruebas smoke de extremo a extremo en apps de App Store que no se pueden instrumentar. Permitir que un asistente de IA realice tareas cotidianas en el teléfono, como enviar mensajes o crear eventos en el calendario. Grabar un recorrido manual y reproducirlo como escenario de CI. Combinar comprobaciones en iPhone y páginas web en una única prueba que abarque varias superficies.
¿Cómo se instala mirroir-mcp?
Instala el servidor con npx (requiere macOS 15 o posterior y Duplicación del iPhone): npx -y mirroir-mcp install Cuando macOS lo solicite al hacer la primera captura de pantalla, concede los permisos de Grabación de pantalla y Accesibilidad Registra mirroir como servidor MCP en Claude Code: claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp
¿Dónde consigo mirroir-mcp?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/jfarcand/mirroir-mcp

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados