Каталог MCP
cameroncooke/xcodebuildmcp

cameroncooke/xcodebuildmcp

MCP сервер и CLI для сборки iOS и macOS проектов: запускает xcodebuild, управляет устройством, анализирует логи. Полезен AI-агентам и разработчикам, работающим с Xcode.

README

24 инструмента

Версии

Установить сервер

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

Installation

XcodeBuildMCP ships as a single package with two modes: a CLI for direct terminal use and an MCP server for AI coding agents. Either install method gives you both.

Option A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Option B — npm (Node.js 18+)

npm install -g xcodebuildmcp@latest

Verify either install:

xcodebuildmcp --help

Connect your MCP client

Drop-in config snippets for Cursor, Claude Code, Codex, can be found in the official docs page MCP Clients. Most clients can also run the MCP server on demand via npx -y xcodebuildmcp@latest mcp without a global install.

Requirements

macOS 14.5 or later
Xcode 16.x or later
Node.js 18.x or later (not required for Homebrew installation)

Skills

XcodeBuildMCP now includes two optional agent skills:

MCP Skill: Primes the agent with instructions on how to use the MCP server's tools (optional when using the MCP server).
CLI Skill: Primes the agent with instructions on how to navigate the CLI (recommended when using the CLI).

Инструменты были проиндексированы: 11.09.2026

boot_sim

Загружает iOS-симулятор для ручных сценариев и сценариев без сборки. Не требуется перед сборкой и запуском симулятора (build_run_sim).

Параметры

Без параметров.

build_run_sim

Собирает, устанавливает и запускает на iOS Simulator, загружая его при необходимости. Автоматически собирает журналы выполнения и включает путь к файлу журнала в ответ. Предпочтительный инструмент для запуска в один шаг, когда заданы настройки по умолчанию.

Параметры

extraArgsstring[]
Дополнительные аргументы xcodebuild/настроек сборки (не аргументы запуска приложения)
launchArgsstring[]
Аргументы, передаваемые запущенному процессу приложения в среде симулятора.

build_sim

Сборка для iOS sim (только компиляция, без запуска).

Параметры

buildForTestingboolean
Собирает переиспользуемые тестовые продукты без запуска тестов (по умолчанию: false)
extraArgsstring[]
testProductsPathstring
Путь вывода для пакета .xctestproducts, когда buildForTesting равен true.

clean

Очищает артефакты сборки.

Параметры

extraArgsstring[]
platformenum

discover_projsтолько чтение

Сканирует директорию (по умолчанию корневая папка рабочей области), чтобы найти файлы проекта Xcode (.xcodeproj) и рабочей области (.xcworkspace). Используйте, когда путь к проекту или рабочей области неизвестен.

Параметры

maxDepthinteger
scanPathstring
workspaceRootstringобязательный

get_app_bundle_idтолько чтение

Извлекает bundle id из .app.

Параметры

appPathstringобязательный
Путь к пакету .app

get_coverage_reportтолько чтение

Показывает покрытие кода для каждой цели из пакета xcresult.

Параметры

showFilesboolean
При значении true включает пофайловую разбивку покрытия под каждой целью.
targetstring
Фильтрует результаты по конкретному имени цели.
xcresultPathstringобязательный
Путь к пакету .xcresult

get_file_coverageтолько чтение

Показывает покрытие на уровне функций и диапазоны непокрытых строк для конкретного файла.

Параметры

filestringобязательный
Имя или путь исходного файла для проверки
showLinesboolean
Когда true, включает непокрытые диапазоны строк из архива.
xcresultPathstringобязательный
Путь к пакету .xcresult

get_sim_app_pathтолько чтение

Получает путь к приложению, собранному sim.

Параметры

platformenumобязательный

install_app_sim

Устанавливает приложение на симулятор.

Параметры

appPathstringобязательный
Путь к .app-бандлу для установки.

launch_app_sim

Запускает приложение на симуляторе. Логи выполнения автоматически сохраняются, а путь к файлу лога включается в ответ.

Параметры

envobject
Переменные среды для передачи запускаемому приложению (префикс SIMCTL_CHILD_ добавляется автоматически)
launchArgsstring[]
Аргументы, передаваемые запущенному процессу приложения в среде симулятора.

list_schemesтолько чтение

Перечисляет схемы Xcode.

Параметры

projectPathstring
Путь к файлу .xcodeproj
workspacePathstring
Путь к файлу .xcworkspace

list_simsтолько чтение

Перечисляет iOS-симуляторы.

Параметры

enabledboolean

open_simтолько чтение

Откройте фронтенд симулятора для просмотра и ручных рабочих процессов. Не требуется перед сборкой и запуском симулятора (build_run_sim).

Параметры

Без параметров.

record_sim_video

Записывает видео симуляции.

Параметры

fpsinteger
По умолчанию: 20
outputFilestring
Путь для записи MP4-файла
startboolean
stopboolean

screenshotтолько чтение

Захватывает скриншот.

Параметры

returnFormatenum
Возвращает путь к изображению или данные base64 (path|base64)

session_clear_defaults

Очищает настройки по умолчанию сеанса для активного или указанного профиля.

Параметры

allboolean
Очищает все значения по умолчанию в глобальном и именованных профилях. Нельзя комбинировать с keys/profile.
keysenum[]
profilestring
Очищает значения по умолчанию для этого именованного профиля вместо активного профиля.

session_set_defaults

Задаёт стандартные параметры сеанса для активного профиля или для указанного профиля и делает его активным.

Параметры

archenum
bundleIdstring
Bundle ID по умолчанию для инструментов запуска, остановки и логирования при работе над одним приложением.
configurationstring
Конфигурация сборки для инструментов Xcode и SwiftPM (например, 'Debug' или 'Release').
createIfNotExistsboolean
Создаёт профиль с указанным именем, если он не существует. По умолчанию false.
derivedDataPathstring
Путь DerivedData по умолчанию для инструментов сборки/тестирования/очистки Xcode.
deviceIdstring
envobject
Переменные окружения по умолчанию, передаваемые запускаемым приложениям.
extraArgsstring[]
Дополнительные аргументы xcodebuild по умолчанию для инструментов, которые принимают extraArgs.
persistboolean
Сохраняет переданные значения по умолчанию в .xcodebuildmcp/config.yaml
platformstring
Платформа устройства по умолчанию для инструментов работы с устройствами (например, iOS, watchOS).
preferXcodebuildboolean
Предпочитает xcodebuild инкрементальным сборкам для инструментов Xcode build/test/clean.
profilestring
Устанавливает значения по умолчанию для этого именованного профиля и делает его активным для текущего сеанса.
projectPathstring
путь к xcodeproj (xor workspacePath)
schemestring
simulatorIdstring
Локальный для машины UDID симулятора, создаваемый из simulatorName, когда он задан; UDID не переносятся между машинами.
simulatorNamestring
Канонический, переносимый между машинами селектор симулятора (безопасен для передачи через SCM); фоновое обновление заново сопоставляет его с UDID этой машины.
simulatorPlatformenum
Кэшированная платформа, полученная из среды выполнения выбранного симулятора; должна быть очищена/пересчитана при каждом изменении селектора симулятора.
suppressWarningsboolean
useLatestOSboolean
workspacePathstring
путь к xcworkspace (xor projectPath)

session_show_defaultsтолько чтение

Показывает текущие активные настройки по умолчанию. Требуется перед первым вызовом build/run/test в сессии: не предполагайте, что настройки по умолчанию уже заданы.

Параметры

Без параметров.

session_use_defaults_profile

Переключает профиль настроек по умолчанию активного сеанса.

Параметры

globalboolean
Активирует глобальный безымянный профиль настроек по умолчанию.
persistboolean
Сохраняет activeSessionDefaultsProfile в .xcodebuildmcp/config.yaml.
profilestring
Активирует именованный профиль настроек сеанса (например, ios или watch).

show_build_settingsтолько чтение

Показывает настройки сборки.

Параметры

Без параметров.

snapshot_uiтолько чтение

Захватывает семантический снимок runtime UI rs/1 с целями elementRef. Наблюдает один раз, использует tap для одной цели или batch для нескольких целей на одном экране, и обновляет после навигации, прокрутки, изменения шторок или очевидных изменений компоновки.

Параметры

sinceScreenHashstring
Возвращает ответ без изменений, когда хеш текущего экрана совпадает с этим значением.

stop_app_sim

Останавливает приложение SIM.

Параметры

Без параметров.

test_sim

Тестирует на iOS-симуляторе.

Параметры

extraArgsstring[]
progressboolean
Показывает подробный вывод о ходе тестирования (в MCP по умолчанию true, в CLI по умолчанию false).
testProductsPathstring
Путь к подготовленному пакету .xctestproducts. Нельзя использовать вместе с входными данными исходного кода.
testRunnerEnvobject
Переменные окружения, которые нужно передать тест-раннеру (префикс TEST_RUNNER_ добавляется автоматически)
xctestrunPathstring
Путь к подготовленному файлу .xctestrun. Не комбинируется с исходными входными данными.

Github Сайт сервера

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Что он умеет?

Сервер собирает iOS-проекты для симулятора и запускает их, автоматически захватывая логи. Управляет симуляторами: перечисляет, загружает, устанавливает и останавливает приложения, пишет видео экрана и делает скриншоты. Запускает тесты и показывает покрытие кода по таргетам и файлам. Находит Xcode-проекты и схемы, читает build settings, чистит продукты сборки, достаёт bundle id, делает семантические снимки UI для тапов, переключает профили настроек сессии.

Информация о сервере

Номер в рейтинге: #25
Звезд на Github: 6365
Форков на Github: 313
Загрузок: 2 218 096
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 10.09 в 21:47
Идентификатор: W_bfYe5O-qBC3xf9
Категории: CI/CD и DevOps, Автоматизация приложений, Агенты для программирования, Инструменты для разработчиков