iOS Simulator MCP

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 filtrar para evitar su registro. Por ejemplo: screenshot,record_video,stop_recording

💡 Caso de uso: Paso de control de calidad mediante llamadas a la herramienta MCP

Este servidor MCP permite que los asistentes de IA integrados con un cliente de Protocolo de Contexto de Modelo (MCP) realicen tareas de control de calidad mediante llamadas a herramientas. Esto resulta útil inmediatamente después de implementar funciones para garantizar la coherencia de la interfaz de usuario y un comportamiento correcto.

Cómo utilizar

Tras la implementación de una función, indique a su asistente de IA, dentro de su entorno de cliente MCP, que utilice las herramientas disponibles. Por ejemplo, en el modo de agente de Cursor, podría usar las siguientes indicaciones 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

Esta sección proporciona instrucciones para integrar el servidor MCP del Simulador de iOS con diferentes clientes del Protocolo de contexto de modelo (MCP).

Instalación con cursor

Cursor administra los servidores MCP a través de su archivo de configuración ubicado en ~/.cursor/mcp.json .

Opción 1: Usar NPX (recomendado)

1. Edite el archivo de configuración de Cursor MCP. Normalmente puede abrirlo directamente desde Cursor o usar un comando como:
   # Open with your default editor (or use 'code', 'vim', etc.) open ~/.cursor/mcp.json # Or use Cursor's command if available # cursor ~/.cursor/mcp.json
2. Agregue o actualice la sección mcpServers con la configuración del servidor del simulador de iOS:
   { "mcpServers": { // ... other servers might be listed here ... "ios-simulator": { "command": "npx", "args": ["-y", "ios-simulator-mcp"] } } }
   Asegúrese de que la estructura JSON sea válida, especialmente si mcpServers ya existe.
3. Reinicie el cursor para que los cambios surtan efecto.

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 el archivo de configuración de Cursor MCP (como se muestra en la Opción 1).
5. Agregue o actualice la sección mcpServers , apuntando a su compilación local:
   { "mcpServers": { // ... other servers might be listed here ... "ios-simulator": { "command": "node", "args": ["/full/path/to/your/ios-simulator-mcp/build/index.js"] } } }
   Importante: reemplace /full/path/to/your/ con la ruta absoluta a donde clonó el repositorio ios-simulator-mcp .
6. Reinicie el cursor para que los cambios surtan efecto.

Instalación con Claude Code

La CLI de Claude Code permite administrar servidores MCP mediante los comandos claude mcp o editando directamente sus archivos de configuración. Para más detalles sobre la configuración de Claude Code MCP, consulte la documentación oficial .

Opción 1: Usar NPX (recomendado)

1. Agregue el servidor usando el comando claude mcp add :
   claude mcp add ios-simulator --command npx --args "-y,ios-simulator-mcp"
   Nota: El parámetro --args toma una única cadena separada por comas.
2. Reinicie cualquier sesión de Claude Code que esté en ejecución si es necesario.

Opción 2: Desarrollo local

1. Clone este repositorio, instale las dependencias y construya el proyecto como se describe en los pasos 1 a 3 del "Desarrollo local" del Cursor.
2. Agregue el servidor usando el comando claude mcp add , apuntando a su compilación local:
   claude mcp add ios-simulator --command node --args "/full/path/to/your/ios-simulator-mcp/build/index.js"
   Importante: reemplace /full/path/to/your/ con la ruta absoluta a donde clonó el repositorio ios-simulator-mcp .
3. Reinicie cualquier sesión de Claude Code que esté en ejecución si es necesario.

Licencia

Instituto Tecnológico de Massachusetts (MIT)