iOS Development MCP Server

# Quick Start Guide - iOS Dev MCP Server Get up and running with iOS simulator control in Claude Code in under 2 minutes! ## Prerequisites Check Before starting, ensure you have: - ✅ macOS (required for iOS Simulator) - ✅ Xcode with Command Line Tools - ✅ Node.js 18+ ## 3-Step Setup ### Step 1: Install & Configure (30 seconds) ```bash cd /Users/d/Documents/projects/ios-dev-mcp-server ./install-claude-code.sh ``` This script automatically: - Builds the project - Configures Claude Code - Verifies setup ### Step 2: Verify Installation (15 seconds) ```bash ./verify-setup.sh ``` You should see all green checkmarks ✅ ### Step 3: Start Using (immediate) Restart Claude Code if it's running, then try: ``` List all iOS simulators ``` ## First Commands to Try Once installed, these commands demonstrate the available functionality: ### 1. List Available Simulators ``` Show me all available iOS simulators ``` Expected: JSON list of all simulators with their states (Booted/Shutdown) ### 2. Boot a Simulator ``` Boot an iPhone 15 Pro simulator ``` Expected: Simulator boots and you get confirmation ### 3. Get Device Info ``` Get info about the booted simulator ``` Expected: Detailed device information (UDID, name, runtime, etc.) ### 4. Shutdown Simulator ``` Shut down the booted simulator ``` Expected: Simulator shuts down gracefully ## What's Available Right Now? **✅ Working (v0.1.0):** - ✅ 4 simulator device management tools - ✅ Smart device resolution ("booted" = first booted device) - ✅ Detailed error messages with recovery suggestions - ✅ Type-safe operations with validation **🚧 Coming Soon:** - Screenshot capture with compression - Tap, swipe, and gesture simulation - App installation and launch - Log streaming - Build and test automation - And 30+ more tools! ## Troubleshooting ### "No booted device" error? Boot a simulator first: ``` Boot an iPhone 15 Pro simulator ``` Or open Simulator.app manually. ### Installation failed? Run the verification script to diagnose: ```bash ./verify-setup.sh ``` ### Server not loading in Claude Code? 1. Check settings file: ```bash cat ~/.config/claude-code/settings.json ``` 2. Restart Claude Code 3. Rebuild project: ```bash npm run build ``` ## Example Workflow Here's a complete workflow showing simulator management: ``` 1. "List all iOS simulators" → See which devices are available 2. "Boot an iPhone 15 Pro simulator" → Start the simulator 3. "Get info about the booted simulator" → Verify it's running and get details 4. [Do your testing/development work] 5. "Shut down the booted simulator" → Clean up when done ``` ## Next Steps ### Learn More - [README.md](./README.md) - Full documentation - [CLAUDE_CODE_SETUP.md](./CLAUDE_CODE_SETUP.md) - Detailed setup guide - [Plan file](~/.claude/plans/) - Implementation roadmap ### Development Watch for updates as new tools are added: - UI automation (screenshots, taps, swipes) - Build automation (xcodebuild integration) - Test running and coverage - Project management - SPM integration ### Test Without Claude Code Use MCP Inspector for interactive testing: ```bash npm run inspector ``` Opens at http://localhost:6274 ## Tips & Tricks ### Use Natural Language The tools understand natural requests: - ✅ "List all iOS simulators" - ✅ "Show me available simulators" - ✅ "What simulators do I have?" All work the same way! ### Device Resolution Use "booted" to reference any running simulator: - "Get info about the booted device" ✅ - "Get info about ABC-123-DEF" ✅ (specific UDID) ### Check Status Anytime ``` List all iOS simulators ``` This shows which devices are booted, making it easy to track state. ## Common Use Cases ### Daily Development 1. Boot simulator at start of day 2. [Use other tools for development] 3. Shutdown at end of day ### Testing Multiple Devices 1. List all simulators to see options 2. Boot iPhone 15 Pro → test 3. Shutdown and boot iPad → test 4. Repeat for all target devices ### Quick Device Info ``` Get info about the booted simulator ``` Great for confirming iOS version, device type, etc. ## Support - 📖 Full docs: [README.md](./README.md) - 🔧 Detailed setup: [CLAUDE_CODE_SETUP.md](./CLAUDE_CODE_SETUP.md) - 🧪 Test tools: `npm run inspector` - ✅ Verify setup: `./verify-setup.sh` --- **Current Version:** 0.1.0 **Status:** 4 tools working, 33+ planned **Platform:** macOS only Happy coding! 🚀