This project provides a Model Context Protocol (MCP) server designed to interact with iOS simulators, enabling AI assistants to perform QA tasks like UI inspection, interaction, and screenshotting. It targets developers and QA engineers seeking to automate testing and validation of iOS applications directly through AI-driven tool calls.

How It Works

The server leverages the Facebook IDB tool to communicate with and control iOS simulators. It exposes an MCP interface that allows clients to send commands for retrieving simulator information, performing UI actions such as taps and swipes, inspecting UI elements via accessibility descriptions, and capturing screenshots. This approach abstracts the underlying simulator control mechanisms, providing a unified interface for AI agents.

Quick Start & Requirements

• Install: npx ios-simulator-mcp (recommended for Cursor/Claude Code) or local build.
• Prerequisites: macOS, Xcode with iOS simulators installed, Node.js, Facebook IDB tool.
• Configuration: Edit ~/.cursor/mcp.json or use claude mcp add commands.
• Docs: Cursor MCP Configuration, Claude Code MCP

Highlighted Details

• Enables AI-driven UI testing and validation of iOS applications.
• Supports actions like tapping, swiping, text input, and element inspection.
• Can take screenshots and record simulator screen activity.
• Integrates with MCP clients like Cursor and Claude Code.

Maintenance & Community

The project is maintained by joshuayoes. No specific community channels or roadmap details are provided in the README.

Licensing & Compatibility

• License: MIT
• Compatibility: Permissive MIT license allows for commercial use and integration into closed-source projects.

Limitations & Caveats

Requires macOS and Xcode, limiting its use to Apple's ecosystem. The project relies on the Facebook IDB tool, which may have its own compatibility or stability considerations.