Simctl MCP

🚀 Simulation Control Protocol (simctl-mcp)

A model context protocol server implementation for iOS simulator control.

🚀 Quick Start

📦 Installation

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

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

💡 Usage Tips

Some usage examples:

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

💻 Usage Examples

The server can run in two modes:

1. Standard Input/Output (STDIO) mode (default)
2. HTTP server mode

Basic Usage

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

npx simctl-mcp

Advanced Usage

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

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

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

# Specify a custom port using an environment variable
PORT=3000 npx simctl-mcp --http

📚 Documentation

🛠️ Tools

Device Management

• Create a new simulator device
• Delete an existing device
• Start a device
• Shut down a device
• List all available devices
• List available device types
• List available runtimes

Application Management

• Install an app
• Uninstall an app
• Launch an app
• Terminate a running app
• Get the application container path
• Get application information
• List installed apps

Application Permissions

• Grant app permissions
• Revoke app permissions
• Reset all app permissions

System Functions

• Open a URL in the simulator
• Add media files
• Get/set environment variables
• Get/set the appearance (light/dark mode)
• Send simulated push notifications

Certificates and Security

• Add a root certificate
• Add a regular certificate
• Reset the keychain