iOS Simulator

Provides programmatic control over iOS simulators to list, boot, install apps, and launch by bundle ID via MCP.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 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": {
    "mcp-mirror-joshuarileydev_simulator-mcp-server": {
      "command": "npx",
      "args": [
        "y",
        "@joshuarileydev/simulator-mcp-server"
      ]
    }
  }
}

This MCP server gives you programmatic control over iOS simulators, allowing you to list, boot, install apps, and launch them by bundle ID from any MCP client. It standardizes simulator actions into a single interface you can automate and orchestrate in your development or testing workflows.

How to use

You connect to the iOS Simulator MCP Server from your MCP client to perform common simulator tasks. Use the exposed actions to list available simulators, boot or shut them down, install .app bundles, and launch apps by their bundle identifiers. Combine these actions to automate end-to-end testing pipelines or workflow scripts that require on-demand simulator operations.

How to install

Prerequisites you need before installing this MCP server:

Node.js installed on your system (Node.js 14+ recommended). Ensure npm is available.

How to install

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

Additional notes

To enable this MCP server in your setup, add the provided configuration to your MCP environment so tools can discover and communicate with it. There are no required environment variables shown for running this server, so you can start with the default configuration and adjust only if you have a specific local setup or security policy.

Troubleshooting

If you encounter issues connecting to the simulator MCP server, verify that Node.js is installed and that the npx command is available. Ensure the MCP client can resolve the server’s command path and that the environment where you run the client permits executing npm-based commands.

Available tools

listSimulators

Return the available iOS simulators that can be managed by this MCP server.

bootSimulator

Boot a selected simulator to bring it to the running state.

shutdownSimulator

Shutdown a running simulator to stop its processes.

installApp

Install a provided .app bundle onto a specified simulator.

launchApp

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