ios-simulator-skill

This MCP server provides a Python-based iOS simulator automation skill for Claude Code. It exposes 21 production scripts organized into categories such as Build & Development, Navigation & Interaction, Testing & Analysis, Advanced Testing & Permissions, and Device Lifecycle. The toolset relies on semantic navigation through iOS accessibility APIs to interact with UI elements by meaning (text, type, or ID) rather than pixel coordinates, making automation resilient to UI changes. Typical workflows include launching apps on the simulator, mapping the current screen, interacting with UI elements (tap, enter text), performing accessibility audits, taking visual diffs, and managing device lifecycles. Claude can orchestrate multiple scripts automatically (e.g., booting a simulator, launching an app, navigating through login, validating accessibility) or you can invoke individual scripts manually for debugging and scripted test scenarios.

Prerequisites:

• macOS 12+ with Xcode Command Line Tools installed (xcode-select --install)
• Python 3.x installed
• Optional: IDB for interactive features

Installation steps:

1. Clone the skill repository into Claude’s skills directory (adjust paths as needed):

   Personal installation: git clone https://github.com/your-org/ios-simulator-skill.git ~/.claude/skills/ios-simulator-skill

   Project installation (within Claude’s skills folder): git clone https://github.com/your-org/ios-simulator-skill.git .claude/skills/ios-simulator-skill

2. Install Python dependencies (if any are specified in the skill's requirements.txt or setup.py):

   python3 -m pip install -r ~/.claude/skills/ios-simulator-skill/requirements.txt

3. Ensure the skill is discoverable by Claude:

   • Restart Claude Code or reload skills so the iOS Simulator Skill is loaded.
   • Verify the skill appears in Claude Code’s skill marketplace or tool list.

4. Run the MCP server for testing (example):

   python -m ios_simulator_skill

Note: If you use a different installation path, adjust the module path accordingly and ensure the package is importable from your Python environment.

Tips and common considerations:

• The skill targets macOS with Xcode; ensure Xcode Command Line Tools are installed and functional.
• If you see module import errors, verify PYTHONPATH includes the skill directory and any dependencies.
• For interactive features, IDB may be required; install via Homebrew as described in prerequisites.
• The skill outputs structured data (JSON) by design; use --verbose or --json modes as needed for machine parsing.
• If Claude’s environment uses virtual environments, activate the correct one before starting the MCP server.
• Keep the skill up to date with the latest 21 scripts to ensure compatibility with newer iOS/macOS versions and Xcode changes.