Унифицированный MCP-сервер для Xcode + iOS Simulator — выполняйте сборку, развертывание, создание скриншотов и взаимодействие с вашим iOS-приложением из Claude Code, Codex, Cursor или любого другого MCP-клиента.
Написан на Swift. Один исполняемый файл. Не требует среды выполнения Node/Python.
Сегодня вам нужно 2-3 отдельных инструмента для выполнения полного цикла разработки iOS с помощью ИИ-агента. xcode-studio-mcp объединяет их в один:
Write code → Build → Deploy to Simulator → Screenshot → Tap/Type → VerifyИнструмент | Описание |
| Сборка проекта Xcode со структурированным выводом ошибок (файл, строка, столбец, серьезность, сообщение) |
| Сборка и запуск приложения в iOS Simulator |
| Захват экрана симулятора в виде PNG-изображения |
| Нажатие по координатам x,y на экране симулятора |
| Ввод текста в текущее активное поле |
| Получение дерева доступности (accessibility tree) текущего экрана (JSON) |
Related MCP server: xcforge
xcode_buildПараметр | Обязательный | Описание |
| Да | Путь к директории проекта Xcode, |
| Нет | Схема сборки (определяется автоматически, если пропущено) |
| Нет |
|
| Нет | Цель сборки (по умолчанию — запущенный симулятор) |
xcode_runПараметр | Обязательный | Описание |
| Да | Путь к проекту Xcode |
| Да | Идентификатор пакета приложения (например, |
| Нет | Схема сборки (определяется автоматически) |
| Нет | Целевой симулятор (по умолчанию — запущенный) |
simulator_screenshotПараметр | Обязательный | Описание |
| Нет | Целевой симулятор (по умолчанию — запущенный) |
simulator_tapПараметр | Обязательный | Описание |
| Да | Координата X |
| Да | Координата Y |
| Нет | Длительность удержания в секундах (для долгого нажатия) |
| Нет | Целевой симулятор |
simulator_typeПараметр | Обязательный | Описание |
| Да | Текст для ввода |
| Нет | Целевой симулятор |
simulator_describeПараметр | Обязательный | Описание |
| Нет | Целевой симулятор |
macOS с установленным Xcode
Для инструментов взаимодействия с UI (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 releaseДобавьте в настройки MCP вашего 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 │
└──────────┴──────────┴──────┘Написано на Swift без зависимостей от среды выполнения Node/Python (CLI idb требуется только для инструментов взаимодействия с UI).
v0.1 (текущая): Базовая сборка + инструменты симулятора
v1.0: Семантическая навигация по UI ("нажми кнопку Sign In"), визуальное сравнение, манипуляция файлами проекта Xcode, составные операции, захват превью SwiftUI
Проект | Что делает | Отличие |
Только сборка + тестирование | Нет взаимодействия с UI симулятора | |
Кроссплатформенный UI симулятора | Нет поддержки сборки Xcode | |
Симулятор через IDB | Нет сборки, для всего зависит от IDB |
xcode-studio-mcp объединяет сборку и взаимодействие в одном сервере.
PR приветствуются. Кодовая база состоит из ~750 строк Swift, организованных в Tools, Services и Models.
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.
