XcodeBuildMCP

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

GitHub
6.5k

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

  • Build for simulator — Попросите вашего ИИ скомпилировать приложение для iOS или macOS для конкретного симулятора, используя именованную схему и путь к проекту.
  • Prepare test products — Пусть ваш ИИ создаст переносимые тестовые пакеты без запуска тестов, нацеленные на выбранный симулятор.
  • Run prepared tests — Поручите вашему ИИ выполнить ранее собранные тестовые продукты на указанном симуляторе.
  • List available tools — Попросите ваш ИИ показать полный набор команд CLI и возможностей MCP-сервера, которые он может вызывать.
  • Check for updates — Запросите у вашего ИИ проверку установленной версии и обновление инструмента на месте при необходимости.

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

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

CI npm version License: MIT Node.js Xcode 16 macOS MCP Ask DeepWiki AgentAudit Security pkg.pr.new

Установка

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

Вариант A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

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

npm install -g mobilebuildmcp@latest

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

mobilebuildmcp --help

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

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

Требования

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

Навыки

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

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

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

Для установки с глобальным бинарником:

mobilebuildmcp init

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

npx -y mobilebuildmcp@latest init

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

Примечания

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

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

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

CLI

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

# Install globally
npm install -g mobilebuildmcp@latest

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

# List available tools
mobilebuildmcp tools

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

# Prepare portable test products without running tests
mobilebuildmcp 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
mobilebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

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

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

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

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

Лицензия

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