XC-MCP
MCP-сервер XC-MCP дает агенту 81 инструмент Xcode и симулятора iOS и сжимает вывод сборки в короткие сводки с деталями по запросу.
- 102 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Инструменты запускают `xcodebuild` и `simctl`, устанавливают и удаляют приложения в симуляторе.
- Отдельные инструменты стирают устройство, отчеты о сбоях и связку ключей симулятора.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/xc-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструменты запускают `xcodebuild` и `simctl`, устанавливают и удаляют приложения в симуляторе.
- Отдельные инструменты стирают устройство, отчеты о сбоях и связку ключей симулятора.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает `xcodebuild`, `simctl` и `idb` в 81 инструмент и следит за размером ответа. Одна инкрементальная сборка в реальном приложении дает около 419 тысяч токенов лога, а агент получает сводку примерно на 285 токенов. Полный вывод кешируется на 30 минут и доступен ссылкой на ресурс либо инструментом `xcodebuild-get-details`. Для работы с интерфейсом симулятора сервер читает дерево доступности и находит нужную кнопку без скриншотов. Есть тапы, ввод, жесты, снимки состояния, аудит доступности, управление устройствами и приложениями, разбор сбоев и зависаний. Режим `--build-only` оставляет 18 инструментов сборки.
Для кого. iOS-разработчикам на macOS, которые поручают сборку, тесты и проверку интерфейса в симуляторе агенту в Claude Code или Codex.
Подходит, если
- Сборка падает с сотнями строк лога, а агенту нужен только список ошибок.
- Экран проверяют в симуляторе: найти кнопку входа, нажать и сравнить результат.
- Перед релизом прогоняют аудит доступности приложения.
- После крэша нужно разобрать отчет `.ips` и найти место сбоя.
Не подходит, если
- Разработка ведется не под macOS: сервер требует Xcode.
- Нужен только Android или кроссплатформенный стек без Xcode.
- Контекст клиента ограничен, а все 81 инструмент не нужны: подойдет режим `--build-only`.
Пример запроса к агенту
Собери проект MyApp, покажи только ошибки, запусти в симуляторе iPhone, нажми «Sign In» через дерево доступности и приложи снимок состояния.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
XC_MCP_CACHE_DIR- Папка для сохраняемых кешей; по умолчанию `~/.xc-mcp`.
Ограничения
Нужны macOS 13 или новее, Node.js 20 или новее, Xcode с Command Line Tools 15 и новее. Инструменты `idb-*` требуют `idb` и idb-companion 1.5.1 или новее из тапа `facebook/fb`; для новых жестов нужна версия 1.7. Если idb-companion устарел, на Xcode 27 тапы молча теряются, и инструменты отказываются работать. Часть инструментов стирает данные: `simctl-erase`, `idb-crash-delete`, `idb-clear-keychain`; клиент помечается подсказкой о разрушающем действии. Лицензия в репозитории не указана. Функции для iPhone Duo используют закрытые интерфейсы и экспериментальны.
Как отключить. Выполните `claude mcp remove xc-mcp`. Кеш лежит в `~/.xc-mcp`, его можно удалить вручную.
Частые вопросы
Как подключить XC-MCP к Claude Code?
Выполните `claude mcp add xc-mcp -- npx -y xc-mcp`. Для Codex есть аналог `codex mcp add xc-mcp -- npx -y xc-mcp`.
Что делать, если тапы проходят, а в симуляторе ничего не происходит?
Обновите idb-companion до 1.5.1 или новее: `brew upgrade facebook/fb/idb-companion`. Сервер сам откажется выполнять тап, если обнаружит такую пару версий. Состояние проверяет `idb-doctor`.
Как уменьшить расход контекста?
Добавьте флаги `--mini` для коротких описаний и `--build-only` для 18 инструментов сборки. Подробности по любому инструменту отдает `rtfm`.
Нужен ли Simulator.app?
Нет, это зависит от Xcode: в Xcode 27 его заменил DeviceHub.app, а `simctl-boot` с `openGui` открывает то, что есть.
Где хранится кеш?
В `~/.xc-mcp`, путь меняет `XC_MCP_CACHE_DIR`. Отчеты зависаний и записи тестов лежат в подпапках, их пути задают две другие переменные.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Xcode на macOS: агент создает проекты, собирает и тестирует приложения, ставит зависимости и управляет симулятором iOS
MCP-сервер, который принимает команды на обычном языке и управляет iOS-симулятором через idb: приложения, нажатия, логи
MCP-сервер для iOS Simulator: тапы, свайпы, ввод текста, дерево доступности, скриншоты, видео и управление приложениями
XcodeBuildMCP (теперь MobileBuildMCP)
XcodeBuildMCP
MCP-сервер и CLI от Sentry для сборки, запуска и тестирования iOS и macOS проектов Xcode из AI-агента
Плагин Claude Code для iOS: восемь небольших MCP-серверов и восемь скиллов, чтобы собирать, тестировать и управлять симулятором.
Скилл со скриптами для сборки iOS-приложений и управления симулятором через дерево доступности, с экономным выводом для агента
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| XC-MCP (эта карточка) | нет | не нужна | 102 | |
| XcodeBuildMCP (теперь MobileBuildMCP) | да | не нужна | 6 565 | сборка и запуск проектов Xcode от Sentry; XC-MCP упор делает на сжатие вывода и автоматизацию симулятора через дерево доступности |
| iOS Simulator MCP Server | нет | не нужна | 2 217 | MCP для действий в iOS Simulator; XC-MCP добавляет сборку, тесты и диагностику |
Коротко о README
Сервер сжимает громоздкий вывод Xcode: сводка сразу, полный лог по запросу. Интерфейс симулятора предпочтительно читается деревом доступности, скриншот нужен там, где дерево недоступно. Каждый инструмент объявляет, читает он или меняет данные.