Simctl Mcp

¿Qué es simctl-mcp?

simctl-mcp es un repositorio público alojado en GitHub, creado por el usuario ### ambar. Este proyecto está diseñado para proporcionar una interfaz de línea de comandos para gestionar y controlar simuladores de iOS. Simplifica el proceso de interacción con los simuladores, permitiendo a los desarrolladores automatizar tareas y optimizar su flujo de trabajo de desarrollo.

Características de simctl-mcp

• Interfaz de Línea de Comandos: Ofrece una interfaz de línea de comandos fácil de usar para gestionar simuladores de iOS.
• Automatización: Permite la automatización de tareas comunes como lanzar simuladores, instalar aplicaciones y ejecutar pruebas.
• Compatibilidad Multiplataforma: Funciona sin problemas en diferentes sistemas operativos, haciéndolo accesible para todos los desarrolladores.
• Código Abierto: Al ser un repositorio público, permite a los desarrolladores contribuir, modificar y mejorar la herramienta según sus necesidades.
• Documentación: Hay documentación completa disponible para ayudar a los usuarios a entender cómo utilizar la herramienta de manera efectiva.

Cómo Usar simctl-mcp

1. Instalación: Clona el repositorio desde GitHub usando el comando:

   git clone https://github.com/ambar/simctl-mcp.git
   

2. Navegar al Directorio: Cambia al directorio del proyecto:

   cd simctl-mcp
   

3. Ejecutar Comandos: Usa la interfaz de línea de comandos para gestionar simuladores. Por ejemplo, para listar todos los simuladores disponibles, puedes ejecutar:

   ./simctl list
   

4. Automatizar Tareas: Crea scripts para automatizar tareas repetitivas utilizando los comandos proporcionados por simctl-mcp.

Preguntas Frecuentes

¿En qué lenguaje de programación está escrito simctl-mcp?

simctl-mcp está escrito principalmente en Python, lo que facilita a los desarrolladores familiarizados con el lenguaje contribuir.

¿Es simctl-mcp compatible con todas las versiones de iOS?

Sí, simctl-mcp está diseñado para funcionar con varias versiones de simuladores de iOS, asegurando compatibilidad en diferentes entornos de desarrollo.

¿Puedo contribuir a simctl-mcp?

¡Absolutamente! Dado que es un proyecto de código abierto, las contribuciones son bienvenidas. Puedes bifurcar el repositorio, hacer tus cambios y enviar una solicitud de extracción.

¿Dónde puedo encontrar la documentación para simctl-mcp?

La documentación está disponible dentro del propio repositorio, generalmente en un archivo README.md o en una carpeta dedicada docs.

¿Cómo puedo reportar problemas o errores en simctl-mcp?

Puedes reportar problemas navegando a la pestaña "Issues" en el repositorio de GitHub y enviando un nuevo problema con detalles sobre el problema que encontraste.

simctl-mcp

A Model Context Protocol server implementation for iOS Simulator control.

Config

.cursor/mcp.json or .vscode/mcp.json:

{
  "mcpServers": {
    "simctl-mcp": {
      "command": "npx",
      "args": ["-y", "simctl-mcp"]
    }
  }
}

Prompts

Some examples of prompts:

• What operations does the simulator support?
• Open shortcuts://
• What is the bundle ID of the "Settings" app?
• Set clipboard content to: Hello
• What is the simulator SDK version?
• Generate an Appium connection string for the "Settings" app

Usage

The server can be started in two modes:

1. STDIO Mode (default)
2. HTTP Server Mode

STDIO Mode

In STDIO mode, the server communicates through standard input/output streams.

npx simctl-mcp

HTTP Server Mode

In HTTP server mode, the server listens for HTTP connections on a specified port.

### Start with default port (8081)
npx simctl-mcp --http

### Start with custom port using --port flag
npx simctl-mcp --http --port 3000

### Start with custom port using environment variable
PORT=3000 npx simctl-mcp --http

Tools

Device Management:

• Create new simulator devices
• Delete existing devices
• Boot devices
• Shutdown devices
• List all available devices
• List available device types
• List available runtimes

App Management:

• Install apps
• Uninstall apps
• Launch apps
• Terminate running apps
• Get app container path
• Get app information
• List installed apps

App Permissions:

• Grant permissions to apps
• Revoke app permissions
• Reset all app permissions

System Features:

• Open URLs in simulator
• Add media files
• Get/Set environment variables
• Get/Set appearance (light/dark mode)
• Send simulated push notifications

Certificate & Security:

• Add root certificates
• Add regular certificates
• Reset keychain

Media & Content:

• Take screenshots
• Get/Set pasteboard content (clipboard)