iOS Simulator MCP Server logo

iOS Simulator MCP Server

by joshuayoes

A Model Context Protocol (MCP) server for interacting with iOS simulators. It allows you to get information about them, control UI interactions, and inspect UI elements.

View on GitHub

Last updated: N/A

What is iOS Simulator MCP Server?

This is a Model Context Protocol (MCP) server that enables interaction with iOS simulators. It provides functionalities to retrieve simulator information, control UI interactions, and inspect UI elements.

How to use iOS Simulator MCP Server?

The server can be installed using NPX or through local development. After installation, configure your Cursor MCP settings to include the server. Then, use example prompts to interact with the simulator, such as verifying UI elements, confirming text input, checking tap responses, validating swipe actions, and taking screenshots.

Key features of iOS Simulator MCP Server

  • Get the ID of the currently booted iOS simulator

  • Describe all accessibility elements on screen

  • Tap on screen coordinates

  • Input text

  • Swipe between coordinates

  • Get information about UI elements at specific coordinates

  • Take screenshots of the simulator screen

  • Filter specific tools using environment variables

Use cases of iOS Simulator MCP Server

  • QA step in agent mode after feature implementation

  • Verifying UI elements

  • Confirming text input

  • Checking tap responses

  • Validating swipe actions

FAQ from iOS Simulator MCP Server

What is the purpose of this server?

It allows you to interact with iOS simulators programmatically for testing and automation.

What are the prerequisites for using this server?

Node.js, macOS, Xcode with iOS simulators, and Facebook IDB tool.

How do I install this server?

You can install it using NPX (recommended) or through local development by cloning the repository and installing dependencies.

How do I configure this server with Cursor?

Edit your Cursor MCP configuration file and add the iOS simulator server with the appropriate command and arguments.

Can I filter specific tools from being registered?

Yes, you can use the IOS_SIMULATOR_MCP_FILTERED_TOOLS environment variable to specify a comma-separated list of tool names to filter out.