XcodeBuildMCP

Сервер и CLI на основе Model Context Protocol (MCP), предоставляющие инструменты для использования агентом при работе над проектами iOS и macOS.

GitHub

6.2k

Что можно делать с Xcode Build MCP?

Build an app for the simulator — попросите агента выполнить simulator build с указанием схемы и пути к проекту, чтобы скомпилировать ваш проект для iOS или macOS.
Run tests on a specific simulator — используйте simulator test с путём к тестовым продуктам и именем симулятора, чтобы выполнить ранее подготовленные тестовые наборы.
Prepare test products without running them — вызовите simulator build с флагами --build-for-testing и --test-products-path, чтобы сгенерировать переносимые пакеты .xctestproducts.
Start the MCP server for an AI client — выполните подкоманду mcp, чтобы ваш агент кодирования мог получить доступ ко всем инструментам сборки и тестирования через протокол MCP.
List available tools from the CLI — используйте команду tools, чтобы узнать, какие операции доступны в текущей среде.
Check for and apply updates — выполните upgrade --check или upgrade --yes, чтобы обновить CLI на месте.

Документация

Сервер и CLI Model Context Protocol (MCP), предоставляющие инструменты для использования агентами при работе над проектами iOS и macOS.

Установка

XcodeBuildMCP поставляется в виде единого пакета с двумя режимами: CLI для прямого использования в терминале и MCP-сервер для AI-агентов кодирования. Любой способ установки предоставляет оба варианта.

Вариант A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Вариант B — npm (Node.js 18+)

npm install -g xcodebuildmcp@latest

Проверка любого варианта установки:

xcodebuildmcp --help

Подключение вашего MCP-клиента

Готовые фрагменты конфигурации для Cursor, Claude Code, Codex можно найти на официальной странице документации MCP Clients. Большинство клиентов также могут запускать MCP-сервер по требованию через npx -y xcodebuildmcp@latest mcp без глобальной установки.

Требования

macOS 14.5 или новее
Xcode 16.x или новее
Node.js 18.x или новее (не требуется при установке через Homebrew)

Навыки

XcodeBuildMCP теперь включает два опциональных навыка агента:

Навык MCP: Инструктирует агента по использованию инструментов MCP-сервера (опционально при использовании MCP-сервера).
Навык CLI: Инструктирует агента по навигации в CLI (рекомендуется при использовании CLI).

Установка с глобальным бинарным файлом:

xcodebuildmcp init

Или установка напрямую через npx без глобальной установки:

npx -y xcodebuildmcp@latest init

Для получения дополнительной информации об установке навыков см. Agent Skills.

Примечания

XcodeBuildMCP запрашивает xcodebuild пропустить проверку макросов, чтобы избежать ошибок при сборке проектов, использующих Swift Macros.
Инструменты для устройств требуют настройки подписи кода в Xcode. См. Device Code Signing.

Конфиденциальность

XcodeBuildMCP использует Sentry только для внутренней телеметрии ошибок времени выполнения. Подробности и инструкции по отказу см. в Privacy & Telemetry.

CLI

XcodeBuildMCP предоставляет унифицированный интерфейс командной строки. Подкоманда mcp запускает MCP-сервер, в то время как все остальные команды предоставляют прямой доступ к инструментам из терминала:

# Install globally
npm install -g xcodebuildmcp@latest

# Start the MCP server (for MCP clients)
xcodebuildmcp mcp

# List available tools
xcodebuildmcp tools

# Build for simulator
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj

# Prepare portable test products without running tests
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts

# Run previously prepared test products
xcodebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

Проверка обновлений и обновление на месте:

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

CLI использует демон для каждого рабочего пространства для операций с состоянием (захват логов, отладка и т.д.), который автоматически запускается при необходимости. См. CLI guide для полной документации.

Документация

Установка: https://xcodebuildmcp.com/docs/installation
Настройка: https://xcodebuildmcp.com/docs/setup
MCP-клиенты: https://xcodebuildmcp.com/docs/clients
Использование CLI: https://xcodebuildmcp.com/docs/cli
Конфигурация и параметры: https://xcodebuildmcp.com/docs/configuration
Справочник инструментов: https://xcodebuildmcp.com/docs/tools
Устранение неполадок: https://xcodebuildmcp.com/docs/troubleshooting
Конфиденциальность: https://xcodebuildmcp.com/docs/privacy
Навыки: https://xcodebuildmcp.com/docs/skills
Участие в разработке: https://xcodebuildmcp.com/docs/contributing

Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE. Уведомления о сторонних лицензиях см. в файле THIRD_PARTY_LICENSES. Сведения об атрибуции пакетов npm см. в файле THIRD_PARTY_PACKAGE_LICENSES.