# XcodeBuildMCP

Инструменты для сборки, тестирования проектов iOS и macOS через симуляторы Xcode прямо из диалога с агентом.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 6505
- Автор: getsentry
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/getsentry/MobileBuildMCP
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/xcodebuildmcp

## Что делает

Пакет объединяет консольную утилиту и MCP-сервер для кодинг-ассистентов в экосистеме Apple. С его помощью агент запускает компиляцию под конкретную схему, подготавливает артефакты `.xctestproducts` и выполняет тесты на симуляторах. При сборке сервер велит `xcodebuild` пропускать валидацию макросов, чтобы проект со Swift Macros не падал с ошибкой.

Фоновые процессы вроде перехвата логов обслуживает локальный демон воркспейса. Он стартует автоматически при вызове команд. Для работы с реальными устройствами обязательно потребуется предварительно настроенная подпись кода в Xcode.

Сервер запускается только на macOS 14.5 или новее при наличии Xcode 16.x. По умолчанию утилита отсылает внутренние отчёты об ошибках в Sentry, но эту отправку можно выключить через переменную `XCODEBUILDMCP_SENTRY_DISABLED`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `INCREMENTAL_BUILDS_ENABLED`, `XCODEBUILDMCP_ENABLED_WORKFLOWS`, `XCODEBUILDMCP_SENTRY_DISABLED`, `XCODEBUILDMCP_DEBUG` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env INCREMENTAL_BUILDS_ENABLED=<INCREMENTAL_BUILDS_ENABLED> --env XCODEBUILDMCP_ENABLED_WORKFLOWS=<XCODEBUILDMCP_ENABLED_WORKFLOWS> --env XCODEBUILDMCP_SENTRY_DISABLED=<XCODEBUILDMCP_SENTRY_DISABLED> --env XCODEBUILDMCP_DEBUG=<XCODEBUILDMCP_DEBUG> --transport stdio xcodebuildmcp -- npx -y xcodebuildmcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add xcodebuildmcp --env INCREMENTAL_BUILDS_ENABLED=<INCREMENTAL_BUILDS_ENABLED> --env XCODEBUILDMCP_ENABLED_WORKFLOWS=<XCODEBUILDMCP_ENABLED_WORKFLOWS> --env XCODEBUILDMCP_SENTRY_DISABLED=<XCODEBUILDMCP_SENTRY_DISABLED> --env XCODEBUILDMCP_DEBUG=<XCODEBUILDMCP_DEBUG> -- npx -y xcodebuildmcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xcodebuildmcp": {
            "command": "npx",
            "args": [
                "-y",
                "xcodebuildmcp"
            ],
            "env": {
                "INCREMENTAL_BUILDS_ENABLED": "<INCREMENTAL_BUILDS_ENABLED>",
                "XCODEBUILDMCP_ENABLED_WORKFLOWS": "<XCODEBUILDMCP_ENABLED_WORKFLOWS>",
                "XCODEBUILDMCP_SENTRY_DISABLED": "<XCODEBUILDMCP_SENTRY_DISABLED>",
                "XCODEBUILDMCP_DEBUG": "<XCODEBUILDMCP_DEBUG>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "xcodebuildmcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "xcodebuildmcp"
            ],
            "env": {
                "INCREMENTAL_BUILDS_ENABLED": "<INCREMENTAL_BUILDS_ENABLED>",
                "XCODEBUILDMCP_ENABLED_WORKFLOWS": "<XCODEBUILDMCP_ENABLED_WORKFLOWS>",
                "XCODEBUILDMCP_SENTRY_DISABLED": "<XCODEBUILDMCP_SENTRY_DISABLED>",
                "XCODEBUILDMCP_DEBUG": "<XCODEBUILDMCP_DEBUG>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e INCREMENTAL_BUILDS_ENABLED=<INCREMENTAL_BUILDS_ENABLED> -e XCODEBUILDMCP_ENABLED_WORKFLOWS=<XCODEBUILDMCP_ENABLED_WORKFLOWS> -e XCODEBUILDMCP_SENTRY_DISABLED=<XCODEBUILDMCP_SENTRY_DISABLED> -e XCODEBUILDMCP_DEBUG=<XCODEBUILDMCP_DEBUG> xcodebuildmcp npx -y xcodebuildmcp
```
Вместо <…> подставьте свои значения

## Когда брать
- собрать проект iOS или macOS под выбранный симулятор
- сгенерировать артефакты тестирования без немедленного запуска тестов
- выполнить наборы тестов на виртуальном устройстве Apple
- собирать системные логи воркспейса через фоновый демон

## Примеры запросов агенту
- Собери схему MyApp в симуляторе iPhone 17 через xcodebuildmcp
- Подготовь тестовые артефакты для проекта MyApp.xcodeproj
- Запусти тесты из готового файла MyApp.xctestproducts

## Похожие
- [e2e](https://affpapa.org/nevibecode/mcp/e2e.md) — MCP-сервер · ★ 11912
- [Measure](https://affpapa.org/nevibecode/mcp/measure.md) — MCP-сервер · ★ 1418
- [mcp](https://affpapa.org/nevibecode/mcp/sceneview-mcp.md) — MCP-сервер · ★ 1348
- [Argent](https://affpapa.org/nevibecode/mcp/argent.md) — MCP-сервер · ★ 3084
- [mcp](https://affpapa.org/nevibecode/mcp/buoy-gg-mcp.md) — MCP-сервер · ★ 691
- [Ghost in the Droid](https://affpapa.org/nevibecode/mcp/ghost-in-the-droid.md) — MCP-сервер · ★ 397

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md