Servidor MCP unificado para Xcode + Simulador de iOS: compila, despliega, captura pantallas e interactúa con tu aplicación iOS desde Claude Code, Codex, Cursor o cualquier cliente MCP.
Desarrollado en Swift. Binario único. No requiere entorno de ejecución de Node/Python.
Actualmente necesitas 2 o 3 herramientas separadas para realizar el ciclo completo de desarrollo de iOS con un agente de IA. xcode-studio-mcp las combina en una sola:
Write code → Build → Deploy to Simulator → Screenshot → Tap/Type → VerifyHerramienta | Descripción |
| Compila un proyecto de Xcode con salida de errores estructurada (archivo, línea, columna, gravedad, mensaje) |
| Compila y lanza una aplicación en el Simulador de iOS |
| Captura la pantalla del Simulador como una imagen PNG |
| Toca en las coordenadas x,y de la pantalla del Simulador |
| Escribe texto en el campo enfocado actualmente |
| Obtiene el árbol de accesibilidad de la pantalla actual (JSON) |
Related MCP server: xcforge
xcode_buildParámetro | Requerido | Descripción |
| Sí | Ruta al directorio del proyecto Xcode, |
| No | Esquema de compilación (detectado automáticamente si se omite) |
| No |
|
| No | Destino de compilación (predeterminado al simulador iniciado) |
xcode_runParámetro | Requerido | Descripción |
| Sí | Ruta al proyecto Xcode |
| Sí | ID del bundle de la aplicación (ej. |
| No | Esquema de compilación (detectado automáticamente) |
| No | Simulador de destino (predeterminado al iniciado) |
simulator_screenshotParámetro | Requerido | Descripción |
| No | Simulador de destino (predeterminado al iniciado) |
simulator_tapParámetro | Requerido | Descripción |
| Sí | Coordenada X |
| Sí | Coordenada Y |
| No | Duración de la pulsación en segundos (para pulsación larga) |
| No | Simulador de destino |
simulator_typeParámetro | Requerido | Descripción |
| Sí | Texto a escribir |
| No | Simulador de destino |
simulator_describeParámetro | Requerido | Descripción |
| No | Simulador de destino |
macOS con Xcode instalado
Para herramientas de interacción de interfaz de usuario (tap, type, describe):
brew tap facebook/fb && brew install idb-companion
pip3 install fb-idbgit clone https://github.com/kevinswint/xcode-studio-mcp.git
cd xcode-studio-mcp
swift build -c releaseAñade a tu configuración de MCP de Claude Code:
{
"mcpServers": {
"xcode-studio-mcp": {
"command": "/path/to/xcode-studio-mcp/.build/release/XcodeStudioMCP"
}
}
}You: Build and run my app at ~/Projects/MyApp
Claude: [calls xcode_build] Build succeeded with 0 errors
[calls xcode_run] App launched (PID 12345)
[calls simulator_screenshot] Here's what the app looks like...
[calls simulator_describe] I can see a "Sign In" button and email/password fields
[calls simulator_tap] Tapped the email field
[calls simulator_type] Typed "test@example.com"
[calls simulator_screenshot] Here's the current state...┌─────────────────────────────┐
│ MCP Protocol Layer │ stdio transport (Swift MCP SDK)
├─────────────────────────────┤
│ Tool Implementations │ 6 tools, structured error output
├──────────┬──────────────────┤
│ xcodebuild│ simctl │ idb │ native process calls
│ wrapper │ wrapper │ CLI │
└──────────┴──────────┴──────┘Desarrollado en Swift sin dependencias de tiempo de ejecución de Node/Python (la CLI de idb solo es necesaria para las herramientas de interacción de interfaz de usuario).
v0.1 (actual): Compilación básica + herramientas de simulador
v1.0: Navegación semántica de la interfaz de usuario ("toca el botón Iniciar sesión"), comparación visual, manipulación de archivos de proyecto Xcode, operaciones compuestas, captura de vista previa de SwiftUI
Proyecto | Qué hace | Diferencia |
Solo compilación + pruebas | Sin interacción de interfaz de usuario del simulador | |
Interfaz de usuario de simulador multiplataforma | Sin soporte de compilación de Xcode | |
Simulador vía IDB | Sin compilación, depende de IDB para todo |
xcode-studio-mcp combina la compilación e interacción en un solo servidor.
Las solicitudes de extracción (PRs) son bienvenidas. El código base tiene unas 750 líneas de Swift organizadas en Herramientas, Servicios y Modelos.
MIT
Get the accessibility tree of the current iOS Simulator screen as JSON. Useful for finding UI elements to interact with. Requires idb (pip3 install fb-idb).
Inputs: simulator_udid.
Capture a screenshot of the iOS Simulator screen. Returns the image as base64-encoded PNG.
Inputs: simulator_udid.
Tap at specific coordinates on the iOS Simulator screen. Requires idb (pip3 install fb-idb).
Inputs: x (required), y (required), duration, simulator_udid.
Type text into the currently focused field on the iOS Simulator. Requires idb (pip3 install fb-idb).
Inputs: text (required), simulator_udid.
Build an Xcode project or workspace. Returns structured diagnostics with file, line, column, severity, and message for each error/warning.
Inputs: project_path (required), configuration, destination, scheme.
Build an Xcode project and launch the app in the iOS Simulator. Returns build errors if the build fails, or a success message with the launched process ID.
Inputs: bundle_identifier (required), project_path (required), configuration, scheme, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
Each tool targets a distinct action: building, running, and simulator interactions (screenshot, tap, type, describe) are clearly separated. There is no overlap in purpose, making it easy for an agent to select the correct tool.
Tools are grouped into two clear namespaces: 'xcode_' for build/run and 'simulator_' for simulator interactions. However, the same verb 'run' is used for xcode_run (launch app) while the simulator tools use direct action verbs (tap, type, describe). The pattern is readable but not perfectly uniform.
With only 6 tools, the set is well-scoped for core Xcode build/run and simulator interaction workflows. Each tool serves a distinct purpose, and no tool feels redundant or missing at this scale.
The set covers building, running, and basic UI interaction (via describe/tap/type). A minor gap is the lack of a tool to terminate the running app, and no way to list available simulators, but agents can work around this for common tasks.
Cloud iPhones and Macs with Xcode for AI agents: build, run and test iOS apps, use the screen.
Cloud iPhone Simulators for AI agents: build the Xcode project, read the screen, tap by label, test.
The cloud Mac alone, with Xcode, for AI agents: run commands, build and test, use the screen.
Build, run, and inspect iOS apps in disposable hosted Simulators from cloud coding agents.
