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:
Write code → Build → Deploy to Simulator → Screenshot → Tap/Type → VerifyTools
| 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) |
