iOS Simulator MCP Server
A Model Context Protocol (MCP) server for interacting with iOS simulators. This server allows you to interact with iOS simulators by getting information about them, controlling UI interactions, and inspecting UI elements.
Features
- Get the ID of the currently booted iOS simulator
- Interact with the simulator UI:
- Filter specific tools using environment variables
Configuration
Environment Variables
IOS_SIMULATOR_MCP_FILTERED_TOOLS: A comma-separated list of tool names to filter out from being registered. For example:screenshot,record_video,stop_recording
Use Case: QA Step via MCP Tool Calls
This MCP server allows AI assistants integrated with a Model Context Protocol (MCP) client to perform Quality Assurance tasks by making tool calls. This is useful immediately after implementing features to help ensure UI consistency and correct behavior.
How to Use
After a feature implementation, instruct your AI assistant within its MCP client environment to use the available tools. For example, in Cursor's agent mode, you could use the prompts below to quickly validate and document UI interactions.
Example Prompts
- Verify UI Elements:
- Confirm Text Input:
- Check Tap Response:
- Validate Swipe Action:
- Detailed Element Check:
- Take Screenshot:
- Record Video:
- Stop Recording:
Prerequisites
- Node.js
- macOS (as iOS simulators are only available on macOS)
- Xcode and iOS simulators installed
- Facebook IDB tool (see install guide)
Installation
This section provides instructions for integrating the iOS Simulator MCP server with different Model Context Protocol (MCP) clients.
Installation with Cursor
Cursor manages MCP servers through its configuration file located at
~/.cursor/mcp.json.Option 1: Using NPX (Recommended)
- Edit your Cursor MCP configuration file. You can often open it directly from Cursor or use a command like:
- Add or update the
mcpServerssection with the iOS simulator server configuration:Ensure the JSON structure is valid, especially ifmcpServersalready exists.
- Restart Cursor for the changes to take effect.
Option 2: Local Development
- Clone this repository:
- Install dependencies:
- Build the project:
- Edit your Cursor MCP configuration file (as shown in Option 1).
- Add or update the
mcpServerssection, pointing to your local build:Important: Replace/full/path/to/your/with the absolute path to where you cloned theios-simulator-mcprepository.
- Restart Cursor for the changes to take effect.
Installation with Claude Code
Claude Code CLI can manage MCP servers using the
claude mcp commands or by editing its configuration files directly. For more details on Claude Code MCP configuration, refer to the official documentation.Option 1: Using NPX (Recommended)
- Add the server using the
claude mcp addcommand:Note: The `--args` parameter takes a single comma-separated string.
- Restart any running Claude Code sessions if necessary.
Option 2: Local Development
- Clone this repository, install dependencies, and build the project as described in the Cursor "Local Development" steps 1-3.
- Add the server using the
claude mcp addcommand, pointing to your local build:Important: Replace/full/path/to/your/with the absolute path to where you cloned theios-simulator-mcprepository.
- Restart any running Claude Code sessions if necessary.
License
MIT
iOS Simulator MCP Server
A Model Context Protocol (MCP) server for interacting with iOS simulators. This server allows you to interact with iOS simulators by getting information about them, controlling UI interactions, and inspecting UI elements.
Features
- Get the ID of the currently booted iOS simulator
- Interact with the simulator UI:
- Filter specific tools using environment variables
Configuration
Environment Variables
IOS_SIMULATOR_MCP_FILTERED_TOOLS: A comma-separated list of tool names to filter out from being registered. For example:screenshot,record_video,stop_recording
Use Case: QA Step via MCP Tool Calls
This MCP server allows AI assistants integrated with a Model Context Protocol (MCP) client to perform Quality Assurance tasks by making tool calls. This is useful immediately after implementing features to help ensure UI consistency and correct behavior.
How to Use
After a feature implementation, instruct your AI assistant within its MCP client environment to use the available tools. For example, in Cursor's agent mode, you could use the prompts below to quickly validate and document UI interactions.
Example Prompts
- Verify UI Elements:
- Confirm Text Input:
- Check Tap Response:
- Validate Swipe Action:
- Detailed Element Check:
- Take Screenshot:
- Record Video:
- Stop Recording:
Prerequisites
- Node.js
- macOS (as iOS simulators are only available on macOS)
- Xcode and iOS simulators installed
- Facebook IDB tool (see install guide)
Installation
This section provides instructions for integrating the iOS Simulator MCP server with different Model Context Protocol (MCP) clients.
Installation with Cursor
Cursor manages MCP servers through its configuration file located at
~/.cursor/mcp.json.Option 1: Using NPX (Recommended)
- Edit your Cursor MCP configuration file. You can often open it directly from Cursor or use a command like:
- Add or update the
mcpServerssection with the iOS simulator server configuration:Ensure the JSON structure is valid, especially ifmcpServersalready exists.
- Restart Cursor for the changes to take effect.
Option 2: Local Development
- Clone this repository:
- Install dependencies:
- Build the project:
- Edit your Cursor MCP configuration file (as shown in Option 1).
- Add or update the
mcpServerssection, pointing to your local build:Important: Replace/full/path/to/your/with the absolute path to where you cloned theios-simulator-mcprepository.
- Restart Cursor for the changes to take effect.
Installation with Claude Code
Claude Code CLI can manage MCP servers using the
claude mcp commands or by editing its configuration files directly. For more details on Claude Code MCP configuration, refer to the official documentation.Option 1: Using NPX (Recommended)
- Add the server using the
claude mcp addcommand:Note: The `--args` parameter takes a single comma-separated string.
- Restart any running Claude Code sessions if necessary.
Option 2: Local Development
- Clone this repository, install dependencies, and build the project as described in the Cursor "Local Development" steps 1-3.
- Add the server using the
claude mcp addcommand, pointing to your local build:Important: Replace/full/path/to/your/with the absolute path to where you cloned theios-simulator-mcprepository.
- Restart any running Claude Code sessions if necessary.
License
MIT