XcodeBuildMCP — MCP-сервер для Claude Code: что делает
Инструменты для сборки, тестирования проектов iOS и macOS через симуляторы Xcode прямо из диалога с агентом.
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Что делает XcodeBuildMCP
Пакет объединяет консольную утилиту и MCP-сервер для кодинг-ассистентов в экосистеме Apple. С его помощью агент запускает компиляцию под конкретную схему, подготавливает артефакты .xctestproducts и выполняет тесты на симуляторах. При сборке сервер велит xcodebuild пропускать валидацию макросов, чтобы проект со Swift Macros не падал с ошибкой.
Фоновые процессы вроде перехвата логов обслуживает локальный демон воркспейса. Он стартует автоматически при вызове команд. Для работы с реальными устройствами обязательно потребуется предварительно настроенная подпись кода в Xcode.
Сервер запускается только на macOS 14.5 или новее при наличии Xcode 16.x. По умолчанию утилита отсылает внутренние отчёты об ошибках в Sentry, но эту отправку можно выключить через переменную XCODEBUILDMCP_SENTRY_DISABLED.
Какие задачи решает
- собрать проект iOS или macOS под выбранный симулятор
- сгенерировать артефакты тестирования без немедленного запуска тестов
- выполнить наборы тестов на виртуальном устройстве Apple
- собирать системные логи воркспейса через фоновый демон
Примеры запросов агенту
- Собери схему MyApp в симуляторе iPhone 17 через xcodebuildmcp
- Подготовь тестовые артефакты для проекта MyApp.xcodeproj
- Запусти тесты из готового файла MyApp.xctestproducts
Как установить XcodeBuildMCP
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о XcodeBuildMCP
Как установить XcodeBuildMCP в Claude Code?
Выполните команду claude mcp add xcodebuildmcp -- npx -y xcodebuildmcp. Для передачи параметров отладки или отключения телеметрии используйте флаги --env.
Какие системные требования нужны для работы?
Необходимы компьютер с macOS 14.5 или новее и установленный Xcode 16.x. Если ставить сервер через npm, потребуется Node.js версии 18.x или выше.
Нужна ли настройка подписи для работы с физическими устройствами?
Да. Инструменты для реальных гаджетов требуют заранее настроенной конфигурации code signing внутри Xcode.
