Servidor MCP del simulador de iOS

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con simuladores de iOS. Este servidor permite interactuar con simuladores de iOS obteniendo información sobre ellos, controlando las interacciones de la interfaz de usuario e inspeccionando sus elementos.

https://github.com/user-attachments/assets/453ebe7b-cc93-4ac2-b08d-0f8ac8339ad3

Características

• Obtener el ID del simulador de iOS iniciado actualmente
• Interactúe con la interfaz de usuario del simulador:
  • Describe todos los elementos de accesibilidad en la pantalla.
  • Toque las coordenadas de la pantalla
  • Texto de entrada
  • Desliza entre coordenadas
  • Obtenga información sobre los elementos de la interfaz de usuario en coordenadas específicas
  • Tomar capturas de pantalla de la pantalla del simulador
• Filtrar herramientas específicas mediante variables de entorno

Configuración

Variables de entorno

• IOS_SIMULATOR_MCP_FILTERED_TOOLS : Lista de herramientas separadas por comas que se deben excluir del registro. Por ejemplo: screenshot,record_video,stop_recording

💡 Caso de uso: Paso de control de calidad en modo agente

Este MCP se puede utilizar de manera efectiva en modo agente como un paso de control de calidad inmediatamente después de implementar funciones, asegurando la consistencia de la interfaz de usuario y un comportamiento correcto.

Cómo utilizar

Después de implementar una función:

1. Activar el modo agente en Cursor.
2. Utilice las indicaciones a continuación para validar y documentar rápidamente las interacciones de la interfaz de usuario.

Ejemplos de indicaciones

• Verificar elementos de la interfaz de usuario:
  Verify all accessibility elements on the current screen
• Confirmar entrada de texto:
  Enter "QA Test" into the text input field and confirm the input is correct
• Comprobar respuesta del grifo:
  Tap on coordinates x=250, y=400 and verify the expected element is triggered
• Validar acción de deslizamiento:
  Swipe from x=150, y=600 to x=150, y=100 and confirm correct behavior
• Comprobación detallada de elementos:
  Describe the UI element at position x=300, y=350 to ensure proper labeling and functionality
• Tomar captura de pantalla:
  Take a screenshot of the current simulator screen and save it to my_screenshot.png
• Grabar vídeo:
  Start recording a video of the simulator screen (saves to ~/Downloads/simulator_recording_$DATE.mp4 by default)
• Detener la grabación:
  Stop the current simulator screen recording

Prerrequisitos

• Node.js
• macOS (los simuladores de iOS solo están disponibles en macOS)
• Simuladores de Xcode e iOS instalados
• Herramienta IDB de Facebook (ver guía de instalación)

Instalación

Opción 1: Usar NPX (recomendado)

1. Edite la configuración de su Cursor MCP:
   cursor ~/.cursor/mcp.json
2. Añade el servidor del simulador de iOS a tu configuración:
   { "mcpServers": { "ios-simulator": { "command": "npx", "args": ["-y", "ios-simulator-mcp"] } } }
3. Reiniciar cursor.

Opción 2: Desarrollo local

1. Clonar este repositorio:
   git clone https://github.com/joshuayoes/ios-simulator-mcp cd ios-simulator-mcp
2. Instalar dependencias:
   npm install
3. Construir el proyecto:
   npm run build
4. Edite la configuración de su Cursor MCP:
   cursor ~/.cursor/mcp.json
5. Añade el servidor del simulador de iOS a tu configuración:
   { "mcpServers": { "ios-simulator": { "command": "node", "args": ["/path/to/your/ios-simulator-mcp/build/index.js"] } } }
   Reemplace "/path/to/your" con la ruta real al directorio de su proyecto.
6. Reiniciar cursor.

Licencia

Instituto Tecnológico de Massachusetts (MIT)