ios-simulator-mcp

This repository provides an MCP server for interacting with iOS simulators, enabling UI element inspection, UI interaction control, and screenshot capture. It facilitates QA processes by automating UI validation and documentation.

277
3

iOS Simulator MCP Server

NPM Version

This Model Context Protocol (MCP) server facilitates interaction with iOS simulators, enabling retrieval of simulator information, UI control, and UI element inspection.

Features

  • Retrieves the ID of the currently booted iOS simulator.
  • Enables UI interaction: describes accessibility elements, taps coordinates, inputs text, swipes between coordinates, gets UI element information at specific coordinates, and takes screenshots.

Use Case: QA Step in Agent Mode

This MCP is designed for Quality Assurance in agent mode, ensuring UI consistency and correct behavior after feature implementation. Example prompts are provided for verifying UI elements, confirming text input, checking tap responses, validating swipe actions, performing detailed element checks, and capturing screenshots or recordings.

Prerequisites

  • Node.js
  • macOS
  • Xcode and iOS simulators
  • Facebook IDB tool

Installation

Two installation options are available: using NPX (recommended) or local development. Both methods require editing the Cursor MCP configuration file to include the iOS simulator server details.

License

MIT

Repository

JO
joshuayoes

joshuayoes/ios-simulator-mcp

Created

March 20, 2025

Updated

March 28, 2025

Language

JavaScript

Category

Developer Tools