MCP Connect

# Installation Guide ## Quick Start ### Option 1: Automated Setup (Recommended) ```bash ./setup.sh ``` ### Option 2: Manual Installation #### Step 1: Install fb-idb **Via Homebrew (Recommended):** ```bash brew tap facebook/fb brew install idb-companion ``` **From Source:** ```bash git clone https://github.com/facebook/idb.git cd idb ./idb_build.sh ``` #### Step 2: Install Node Dependencies ```bash npm install ``` #### Step 3: Build the Project ```bash npm run build ``` ### Option 3: Install from npm ```bash npm install -g mcp-ios-simulator ``` ## Verify Installation Check that everything is installed correctly: ```bash # Check fb-idb idb --help # Check Node node --version # Should be v18.0.0 or higher # Check the MCP server builds npm run build ``` ## Troubleshooting ### "idb not found" The server will fall back to basic gestures. To get full functionality: ```bash brew tap facebook/fb brew install idb-companion ``` Or use the bundled binary in `resources/idb_companion`. ### "Cannot find module '@modelcontextprotocol/sdk'" ```bash npm install npm run build ``` ### Permission Issues with Simulator Make sure the Simulator app has accessibility permissions: 1. System Settings > Privacy & Security > Accessibility 2. Add "Simulator" and "Terminal" (or your terminal app) ## Running Without fb-idb The server will work without fb-idb but with limited functionality: - Screenshots - Type text - List simulators - Open URLs - Erase simulator - Basic tap/click (via AppleScript) With fb-idb: - Reliable tap gestures - Swipe gestures - UI tree inspection - Siri/volume buttons