kevinswint/xcode-studio-mcp

**Unified MCP server for Xcode + iOS Simulator** — build, deploy, screenshot, and interact with your iOS app from Claude Code, Codex, Cursor, or any MCP client.
Built in Swift. Single binary. No Node/Python runtime required.
Why This Exists
Today you need 2-3 separate tools to do the full iOS dev loop with an AI agent. **xcode-studio-mcp** combines them into one:
Tools
| Tool | Description |
|------|-------------|
| xcode_build | Build an Xcode project with structured error output (file, line, column, severity, message) |
| xcode_run | Build and launch an app in the iOS Simulator |
| simulator_screenshot | Capture the Simulator screen as a PNG image |
| simulator_tap | Tap at x,y coordinates on the Simulator screen |
| simulator_type | Type text into the currently focused field |
| simulator_describe | Get the accessibility tree of the current screen (JSON) |
Tool Parameters
xcode_build
| Parameter | Required | Description |
|-----------|----------|-------------|
| project_path | Yes | Path to Xcode project directory, .xcodeproj, or .xcworkspace |
| scheme | No | Build scheme (auto-detected if omitted) |
| configuration | No | Debug (default) or Release |
| destination | No | Build destination (defaults to booted simulator) |
xcode_run
| Parameter | Required | Description |
|-----------|----------|-------------|
| project_path | Yes | Path to Xcode project |
| bundle_identifier | Yes | App bundle ID (e.g. com.example.MyApp) |
| scheme | No | Build scheme (auto-detected) |
| simulator_udid | No | Target simulator (defaults to booted) |
simulator_screenshot
| Parameter | Required | Description |
|-----------|----------|-------------|
| simulator_udid | No | Target simulator (defaults to booted) |
simulator_tap
| Parameter | Required | Description |
|-----------|----------|-------------|
| x | Yes | X coordinate |
| y | Yes | Y coordinate |
| duration | No | Hold duration in seconds (for long press) |
| simulator_udid | No | Target simulator |
simulator_type
| Parameter | Required | Description |
|-----------|----------|-------------|
| text | Yes | Text to type |
| simulator_udid | No | Target simulator |
simulator_describe
| Parameter | Required | Description |
|-----------|----------|-------------|
| simulator_udid | No | Target simulator |
Quick Start
Prerequisites
- macOS with Xcode installed
- For UI interaction tools (tap, type, describe):
Build
Configure Claude Code
Add to your Claude Code MCP settings:
Example Workflow
Architecture
Built in Swift with zero Node/Python runtime dependencies (idb CLI is only needed for UI interaction tools).