XcodeBuildMCP

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

Установка

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

Вариант А — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

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

npm install -g xcodebuildmcp@latest

Проверка установки:

xcodebuildmcp --help

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

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

Related MCP server: MCP Xcode Server

Требования

• macOS 14.5 или новее

• Xcode 16.x или новее

• Node.js 18.x или новее (не требуется для установки через Homebrew)

Навыки (Skills)

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

• MCP Skill: подготавливает агента с инструкциями о том, как использовать инструменты MCP-сервера (необязательно при использовании MCP-сервера).

• CLI Skill: подготавливает агента с инструкциями о том, как работать с 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

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

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.