cameroncooke/xcodebuildmcp

cameroncooke/xcodebuildmcp

от cameroncooke
Собирает, тестирует и отлаживает iOS и macOS проекты через Xcode. Запускает сборки, прогоняет тесты, вытаскивает логи. Официальное решение от Sentry.

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

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

Installation

MobileBuildMCP 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 mobilebuildmcp
Option B — npm (Node.js 18+)
npm install -g mobilebuildmcp@latest

Verify either install:

mobilebuildmcp --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 mobilebuildmcp@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

MobileBuildMCP 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).

Часто задаваемые вопросы

Инструменты были проиндексированы:
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. Не комбинируется с исходными входными данными.

2.7.0основная
2.6.2
2.6.1
2.6.0
2.5.2
2.5.1
2.5.0
2.5.0-beta.1
2.3.2
2.3.1
2.3.0
2.2.1
2.2.0
2.1.0
2.0.7
2.0.6
2.0.5
2.0.4
2.0.3
2.0.2
2.0.1
2.0.0
2.0.0-beta.1
1.15.1
1.15.0
1.15.0-beta.0
1.14.1
1.14.0
1.13.1
1.13.0
1.12.10
1.12.9
1.12.8
1.12.7
1.12.6
1.12.4
1.12.5
1.12.3
1.12.2
1.12.1
1.12.0
1.11.2
1.11.1
1.11.0
1.2.0-beta.3
1.10.4
1.10.3
1.10.2
1.10.1
1.10.0
26.0.0
1.9.0
1.8.0
1.7.0
1.6.1
1.6.0
1.5.0
1.4.0
1.4.0-beta.4
1.3.8
1.3.7
1.4.0-beta.3
1.4.0-beta.2
1.3.6
1.4.0-beta.1
1.3.5
1.3.4
1.3.3
1.3.2
1.3.1
1.3.0
1.2.4
1.2.3
1.2.2
1.2.1
1.2.0
1.1.0
1.0.2
1.0.1
1.0.0

Выберите клиент, чтобы установить cameroncooke/xcodebuildmcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "cameroncooke-xcodebuildmcp-62ou": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp@latest",
        "mcp"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "cameroncooke-xcodebuildmcp-62ou": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp@latest",
        "mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"cameroncooke-xcodebuildmcp-62ou\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"xcodebuildmcp@latest\",\"mcp\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "cameroncooke-xcodebuildmcp-62ou": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp@latest",
        "mcp"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add cameroncooke-xcodebuildmcp-62ou -- npx -y xcodebuildmcp@latest mcp

Либо через JSON-конфиг:

claude mcp add-json cameroncooke-xcodebuildmcp-62ou "{\"command\":\"npx\",\"args\":[\"-y\",\"xcodebuildmcp@latest\",\"mcp\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add cameroncooke-xcodebuildmcp-62ou -- npx -y xcodebuildmcp@latest mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.cameroncooke-xcodebuildmcp-62ou]
command = "npx"
args = ["-y", "xcodebuildmcp@latest", "mcp"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите cameroncooke/xcodebuildmcp, а в поле команды запуска — строку ниже:
npx -y xcodebuildmcp@latest mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "cameroncooke-xcodebuildmcp-62ou": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp@latest",
        "mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например cameroncooke-xcodebuildmcp-62ou.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: cameroncooke-xcodebuildmcp-62ou
    command: npx
    args:
      - "-y"
      - "xcodebuildmcp@latest"
      - "mcp"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Похожие MCP-сервера

perceptdot/percept

perceptdot/percept

от perceptdot

Perceptdot - MCP сервер для автоматического обнаружения и установки других MCP инструментов. Сканирует проект и рекомендует серверы для GA4, Vercel, GitHub и Sentry. Агент сам находит нужное, человек платит. Полезен разработчикам для интеграции AI-агентов.

HTML⭐ 1
jeannier/homebrew-mcp

jeannier/homebrew-mcp

от jeannier

Homebrew MCP сервер для macOS: управляйте пакетами через ИИ-агентов. Полный набор инструментов для установки, поиска, обновления и диагностики Homebrew. Интегрируется с Claude Desktop и Cursor. Для...

Python⭐ 30
conan-io/conan-mcp

conan-io/conan-mcp

от conan-io

MCP сервер для интеграции с Conan — менеджером пакетов C++. Помогает создавать проекты, устанавливать зависимости, проверять лицензии и сканировать уязвимости через простые запросы. Упрощает работу с Conan для разработчиков.

Python⭐ 11
mattijsdp/dbt-docs-mcp

mattijsdp/dbt-docs-mcp

от mattijsdp

MCP-сервер для работы с метаданными dbt-проекта: поиск моделей, источников, тестов, просмотр атрибутов узлов и отслеживание lineage как на уровне моделей, так и отдельных колонок. Помогает аналитик...

Python⭐ 23
ksterx/srunx

ksterx/srunx

от ksterx

srunx управляет SLURM-очередью: отправляет и отменяет задания, мониторит GPU и логи, запускает YAML-workflow. Работает с локальным и удалённым кластером по SSH.

Python⭐ 24
MarkItDown MCP

MarkItDown MCP

официальный

от microsoft

Конвертирует PDF, Word, Excel и изображения в Markdown, сохраняя заголовки, таблицы и ссылки. Официальная утилита Microsoft, понимает YouTube и EPUB.

Python⭐ 191167
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин