Simulator

Provides programmatic control over iOS simulators via MCP, enabling listing, booting, installing apps, and launching apps.

javascript

50

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "joshuarileydev-simulator-mcp-server": {
      "command": "npx",
      "args": [
        "y",
        "@joshuarileydev/simulator-mcp-server"
      ]
    }
  }
}

This MCP server provides programmatic control over iOS simulators using a standardized interface, letting you list, boot, shut down, install apps, and launch them on your simulator fleet.

How to use

Use this MCP server with any MCP client to manage iOS simulators from scripts or automation. You can list available simulators, boot or shut them down, install .app bundles on a selected simulator, and launch installed apps by bundle ID. Integrate the server into your automation workflows to streamline testing, CI, and device management.

How to install

Prerequisites: ensure Node.js and npm are installed on your system.

Install the MCP server by configuring your Claude Config JSON with the following snippet.

{
  "mcpServers": {
    "simulator": {
      "command": "npx",
      "args": [
        "y",
        "@joshuarileydev/simulator-mcp-server"
      ]
    }
  }
}

Additional notes

The configured server entry enables you to run the MCP server locally via npx, invoking the simulator MCP server package. No additional environment variables are required for basic operation, but you can adjust environment settings if your deployment environment requires them.

Available tools

listSimulators

List available iOS simulators that are accessible to the MCP server.

bootSimulator

Boot a specified simulator instance to bring it online for testing.

shutdownSimulator

Shutdown a running simulator to free resources.

installAppBundle

Install an .app bundle onto a chosen simulator.

launchApp

Launch an installed app by its bundle ID on a target simulator.