XcodeBuildMCP

XcodeBuildMCP

getsentryMIT
5.8k звёзд288 форков
XcodeBuildMCP — это MCP-сервер от команды Sentry. Он даёт AI-ассистентам прямой доступ к инструментам Xcode: сборке, тестированию, управлению симуляторами и анализу приложений. Вам больше не нужно вручную запускать xcodebuild или переключать симуляторы — достаточно сформулировать задачу на естественном языке, и AI выполнит её. Сервер работает локально, полностью автоматизируя рутинные операции. Это избавляет разработчика от постоянного переключения между Xcode и терминалом, ускоряя цикл разработки. Инструмент подходит тем, кто хочет встроить AI-агента в свой iOS/macOS-воркфлоу без настройки CI-серверов.
Productivity
Открыть на GitHub

Установка

npx -y xcodebuildmcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикgetsentry
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Сборка проекта: запускает сборку в любой конфигурации (Debug, Release) и для любой схемы.
  • Запуск тестов: выполняет модульные и UI-тесты для выбранного таргета или схемы.
  • Архивирование: создаёт .xcarchive для публикации в App Store или TestFlight.
  • Управление симуляторами: запускает, завершает, создаёт новые симуляторы iOS, устанавливает и удаляет приложения.
  • Анализ приложений: проверяет .ipa и .app файлы — метаданные, entitlements, подписи, размер бинарника.
  • Редактирование Info.plist: читает и изменяет ключи, такие как версия сборки (CFBundleVersion) или версия приложения (CFBundleShortVersionString).
  • Очистка проекта: выполняет xcodebuild clean и другие подготовительные шаги для пересборки.
  • Обзор проекта: выводит списки схем, таргетов и конфигураций сборки.
  • Управление устройствами: подключает и настраивает физические устройства для тестирования.

Как подключить

Перед установкой убедитесь, что у вас macOS 14.5 или новее, Xcode 16 и Node.js 18+ (если установка через npm). Homebrew устанавливается без Node.js.

Установите XcodeBuildMCP через npm:

npm install -g xcodebuildmcp@latest

Или через Homebrew:

brew tap getsentry/xcodebuildmcp && brew install xcodebuildmcp

Добавьте сервер в конфигурацию вашего MCP-клиента. Для Claude Desktop отредактируйте файл claude_desktop_config.json:

{ "mcpServers": { "xcodebuildmcp": { "command": "npx", "args": ["-y", "xcodebuildmcp@latest", "mcp"] } } }

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

{ "mcpServers": { "xcodebuildmcp": { "command": "xcodebuildmcp", "args": ["mcp"] } } }

После добавления конфигурации перезапустите клиент. Если всё настроено верно, AI-ассистент получит доступ к инструментам сервера.

Примеры запросов

  • «Собери проект Xcode по схеме Production и покажи сводку ошибок, если сборка упала.»
  • «Запусти симулятор iPhone 16 Pro, установи на него текущее приложение и открой главный экран.»
  • «Найди в проекте файл Info.plist, увеличь CFBundleVersion на 1 и сохрани изменения.»
  • «Заархивируй приложение и подготовь его для отправки в TestFlight. Проверь, что entitlements настроены корректно.»
  • «Выведи список всех схем в проекте и покажи, какая из них активна по умолчанию.»

Технические детали

  • Язык разработки: TypeScript.
  • Транспорт: Stdio (стандартный ввод-вывод).
  • Лицензия: MIT.
  • Разработчик: getsentry (Sentry).
  • Минимальные требования: macOS 14.5, Xcode 16, Node.js 18 (для npm-установки).
  • Совместимые клиенты: Claude Desktop, Cursor, Visual Studio Code (через расширения MCP), Claude Code, Codex, и любые другие MCP-клиенты.
  • Категория: Инструменты разработки (Dev Tools), продуктивность.

Поделиться