mcp -simulator-ios-idb

This MCP server provides a bridge between large language models and iOS simulators via natural language commands. It exposes a suite of capabilities to manage simulator sessions, install and control apps, interact with the UI, and perform debugging tasks. You can either integrate it into your MCP workflow or run it as a standalone library in your project. Typical usage involves creating a simulator session, performing actions (tap, swipe, launch/terminate apps), and retrieving results like screenshots or logs. The integration example shows how to add the server to your MCP configuration so an LLM can emit natural language instructions that are translated into concrete simulator actions by the orchestrator and IDB manager. The server supports advanced operations such as recording UI interactions, capturing screenshots, and handling media or keychain data, enabling comprehensive test and automation scenarios for iOS simulators.

Prerequisites:

• macOS (required for iOS simulator support)
• Node.js v14.0.0 or higher
• Homebrew (for installing dependencies like idb-companion)
• XCode with iOS simulators installed

Installation steps (manual):

1. Clone the repository git clone https://github.com/InditexTech/mcp-server-simulator-ios-idb.git cd mcp-server-simulator-ios-idb

2. Install dependencies npm install

3. Build the project npm run build

4. Start the server npm start

5. Run tests (optional) npm test

Notes:

• The installation process may install idb-companion via Homebrew and fb-idb via a Python virtual environment as part of setup. Keep the virtual environment activated while using the server (source venv/bin/activate on Unix/macOS). If you restart your terminal, reactivate the environment before running npm start.
• If you prefer a deployment-based approach, you can also integrate via the provided MCP usage example by adding the server configuration to your MCP settings.

Tips and common considerations:

• Ensure you are on macOS to use iOS simulators.
• The MCP server expects a running Node environment and access to the iOS simulator tooling (idb, etc.).
• When configuring MCP integration, provide the correct path to the built distribution (dist/index.js).
• If you encounter issues with simulator availability, verify Xcode command line tools and simulator runtimes are installed and up-to-date.
• Use the advanced commands (location simulation, media injection, URL scheme handling, keychain operations) to automate complex test flows. Remember to keep your environment variables properly configured if you rely on external services or authentication.
• For library usage, you can instantiate the components directly (IDBManager, NLParser, MCPOrchestrator) and call processInstruction with natural language commands.