XcodeBuildMCP (теперь MobileBuildMCP)
XcodeBuildMCP
MCP-сервер и CLI от Sentry для сборки, запуска и тестирования iOS и macOS проектов Xcode из AI-агента
- 6 513 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает xcodebuild, симуляторы и приложения на машине
- Отправляет телеметрию ошибок в Sentry
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/xcodebuildmcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает xcodebuild, симуляторы и приложения на машине
- Отправляет телеметрию ошибок в Sentry
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект переименован: прежний XcodeBuildMCP теперь называется MobileBuildMCP, старый пакет xcodebuildmcp остается в npm. Бинарь mobilebuildmcp работает в двух режимах: подкоманда mcp запускает MCP-сервер, остальные подкоманды (simulator build, simulator test, tools) дают те же инструменты из терминала. Инструменты описаны манифестами в папке manifests и сгруппированы в рабочие наборы: сборка и запуск в симуляторе, на устройстве и на macOS, тесты с отчетом о покрытии, автоматизация интерфейса (тапы, жесты, скриншоты, запись видео) и отладка через LLDB с точками останова. Параметры проекта (проект или workspace, схема, симулятор, конфигурация) запоминаются в сессии, а постоянные лежат в .mobilebuildmcp/config.yaml. Для операций с состоянием, таких как захват логов, на рабочую папку автоматически поднимается демон. Команда init ставит два необязательных скилла, MCP Skill и CLI Skill.
Для кого. Для iOS и macOS разработчиков, которые используют Claude Code, Cursor или Codex.
Подходит, если
- После правки SwiftUI-экрана агент должен сам собрать схему MyApp под iPhone 17, запустить приложение и прислать скриншот, чтобы вы увидели результат без открытия Xcode
- В CI или на удаленном Mac нужно собрать тестовые продукты командой simulator build --build-for-testing, а прогнать их позже через simulator test
- Тест падает только при определенном состоянии, и агенту нужно поставить точку останова, посмотреть стек и переменные через инструменты debug_*
- Нужен отчет о покрытии кода и покрытие отдельного файла после прогона тестов (инструменты get_coverage_report и get_file_coverage)
- Вы хотите быстро создать каркас нового iOS или macOS проекта: для этого есть инструменты scaffold_ios_project и scaffold_macos_project
Не подходит, если
- У вас Linux или Windows: нужны macOS 14.5 или новее и Xcode 16 или новее
- Нужны только скриншоты и тапы в симуляторе без сборки: проще iOS Simulator MCP Server из каталога
- Задача про ускорение самой сборки, а не про ее запуск из агента: посмотрите Xcode Build Optimization Agent Skill
- Приложение собирается Gradle или Flutter, а не Xcode: для них нужны другие инструменты, этот сервер работает только с проектами Xcode
Пример запроса к агенту
В проекте ./Weather.xcodeproj собери схему Weather под iPhone 17, запусти приложение в симуляторе, сделай скриншот главного экрана и прогони тесты, при падении покажи стекMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
XCODEBUILDMCP_SENTRY_DISABLED- Управляет отправкой телеметрии ошибок в Sentry
Ограничения
Доступ: расширенный. Сервер запускает xcodebuild, управляет симуляторами и подключенными устройствами, нажимает в интерфейсе, делает скриншоты и видео, подключает отладчик и пишет в папку DerivedData и в .mobilebuildmcp. Инструменты устройств требуют настроенной подписи кода в Xcode. Нужны macOS 14.5 или новее, Xcode 16 или новее, а для установки через npm Node.js 18 или новее (через Homebrew Node.js не нужен). Сборка запускается с пропуском проверки макросов Swift. Телеметрия ошибок самого инструмента уходит в Sentry; отключается ключом sentryDisabled в config.yaml или переменной MOBILEBUILDMCP_SENTRY_DISABLED. Лицензия MIT, платных частей нет.
Как отключить. Выполните claude mcp remove XcodeBuildMCP или удалите блок сервера из конфигурации MCP, затем npm uninstall -g xcodebuildmcp или brew uninstall xcodebuildmcp.
Частые вопросы
Проект раньше был у другого автора?
Да, изначально его вел Cameron Cooke, теперь репозиторий принадлежит Sentry.
Как обновиться?
Командой mobilebuildmcp upgrade --yes, проверить наличие новой версии можно через upgrade --check.
Как подключить к Claude Code, Cursor или Codex?
Установите пакет через brew install mobilebuildmcp или npm install -g mobilebuildmcp@latest и добавьте в конфигурацию клиента запуск команды mobilebuildmcp mcp. Готовые фрагменты для Cursor, Claude Code и Codex лежат в документации MCP Clients. Большинство клиентов умеют запускать сервер через npx -y mobilebuildmcp@latest mcp.
Как проверить, что все работает?
Выполните mobilebuildmcp --help для проверки установки, затем mobilebuildmcp tools покажет список доступных инструментов. Для проверки среды есть инструмент doctor, он описан в манифестах репозитория.
Чем это отличается от iOS Simulator MCP Server?
MobileBuildMCP покрывает весь цикл: сборку, тесты, управление интерфейсом приложения и отладку через LLDB. iOS Simulator MCP Server из каталога управляет приложением в симуляторе: тапы, свайпы, ввод текста, скриншоты и видео. Сборки и тестов в его описании нет.
Что делать, если на устройстве не собирается?
Инструменты устройств требуют настроенной подписи кода в Xcode: проверьте подпись и профиль в проекте, как описано в разделе Device Code Signing документации. На симуляторе подпись не нужна.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
MCP-сервер, который принимает команды на обычном языке и управляет iOS-симулятором через idb: приложения, нажатия, логи
MCP-сервер для iOS Simulator: тапы, свайпы, ввод текста, дерево доступности, скриншоты, видео и управление приложениями
MCP-сервер к официальной документации Apple: поиск по фреймворкам, API, примерам кода и сессиям WWDC прямо из агента
MCP-сервер для управления Android-устройством через ADB: навигация по приложениям, ввод и авто-тесты
MCP-сервер управляет реальным iPhone через macOS iPhone Mirroring: агент видит экран, нажимает, листает и вводит текст
Коротко о README
README описывает установку через Homebrew или npm, требования к macOS, Xcode и Node.js и запуск сервера через npx. Рассказано о двух скиллах и их установке командой init, об особенностях сборки и телеметрии. Приведены примеры команд CLI для сборки и тестов в симуляторе. Настройки для клиентов вынесены на сайт xcodebuildmcp.com. Лицензия MIT.