Xcode MCP Server
MCP-сервер для Xcode на macOS: агент создает проекты, собирает и тестирует приложения, ставит зависимости и управляет симулятором iOS
- 387 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент пишет файлы в папке проектов, запускает сборку и произвольные команды xcrun и pod, а еще архивирует и экспортирует приложение для App Store
- Один из инструментов выполняет любые команды pod, а доступ к файлам ограничен только заданными вами каталогами
Установка
- Работает в
Ручная установка
git clone https://github.com/r-huijts/xcode-mcp-server.git && cd xcode-mcp-server && chmod +x setup.sh && ./setup.shСкрипт проверяет окружение, ставит зависимости, собирает проект, создает .env и, по согласию, вносит запись в конфигурацию Claude Desktop.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент пишет файлы в папке проектов, запускает сборку и произвольные команды xcrun и pod, а еще архивирует и экспортирует приложение для App Store
- Один из инструментов выполняет любые команды pod, а доступ к файлам ограничен только заданными вами каталогами
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Xcode MCP Server открывает агенту работу с проектами Xcode на Mac. Агент создает проект из шаблона для iOS, macOS, watchOS или tvOS, добавляет файлы в нужную цель и группу, читает схемы проектов и рабочих областей. Файловые инструменты читают и записывают текст в разных кодировках, работают с двоичными файлами через base64 и ищут по шаблону или регулярному выражению. Для сборки есть сборка проекта с настройками, запуск тестов с подробным отчетом о падениях, статический анализ, очистка и архивирование. Отдельные группы инструментов покрывают CocoaPods (инициализация, установка, обновление, добавление и удаление зависимостей) и Swift Package Manager (новые пакеты, зависимости, обновление, документация DocC, сборка и тесты). Симулятор iOS управляется командами: список устройств, запуск и остановка, установка и запуск приложений, снимки экрана, запись видео и настройки. Кроме того, сервер выполняет команды `xcrun`, компилирует каталоги ресурсов, делает наборы значков приложения из исходного изображения, экспортирует и проверяет архивы для App Store и переключает версии Xcode. Доступ к файлам ограничен базовой папкой проектов и перечнем разрешенных путей.
Для кого. Для разработчиков под Apple, которые хотят доверить агенту сборку, тесты, зависимости и запуск приложения в симуляторе, не уходя из диалога.
Подходит, если
- Нужно создать новый проект Xcode для iOS по шаблону и сразу добавить в него Swift-пакет вроде Alamofire
- Агент должен собрать схему, запустить тесты и по отчету о падениях найти сломанное место
- Нужно запустить приложение в симуляторе, сделать снимок экрана или записать видео для отчета об ошибке
- В проекте надо поставить или обновить зависимости через CocoaPods или Swift Package Manager
- Перед выпуском в App Store нужно собрать архив, экспортировать и проверить его
Не подходит, если
- У вас Windows или Linux: сервер работает только на macOS с установленным Xcode
- Нужно только писать код на SwiftUI: для этого сервер не нужен, хватит обычных файловых инструментов агента
- Агент не должен запускать произвольные команды: сервер умеет выполнять любые команды pod и xcrun
- Нужно управлять реальным устройством: инструменты рассчитаны на симулятор
Пример запроса к агенту
Создай iOS-проект MyApp на Swift с тестами, добавь Alamofire через Swift Package Manager, собери схему Debug и запусти тесты.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
PROJECTS_BASE_DIRобязательная- Базовая папка проектов, вне ее файловые операции запрещены
ALLOWED_PATHS- Дополнительные разрешенные каталоги через запятую
DEBUG- Подробный журнал, по умолчанию false
PORT- Порт сервера, по умолчанию 3000
Ограничения
Работает только на macOS. Нужны Xcode 14 или новее, Node.js 16 или новее и npm, для Swift Package Manager Swift 5.5 или новее, а для CocoaPods еще Ruby. Сервер не лежит в реестре npm: его собирают из исходников командами `npm install` и `npm run build` или скриптом `setup.sh`, который проверяет окружение и создает файл `.env`.
Обязательная настройка одна, это папка проектов в параметре `PROJECTS_BASE_DIR`. Все файловые операции ограничены ею и путями из `ALLOWED_PATHS`, остальное сервер не откроет. Подробный журнал включается параметром `DEBUG`.
Есть неясность с запуском. В разделе для Claude Desktop сервер запускается командой `node` на файле `dist/index.js`, а в общем описании сказано подключать клиента к адресу вроде `http://localhost:3000`, порт задается параметром `PORT`. Выбирайте способ, который поддерживает ваш клиент. Последний коммит в репозитории сделан в феврале 2026 года.
Как отключить. Удалите запись xcode из claude_desktop_config.json и перезапустите клиент. Если сервер запущен вручную через `npm start`, остановите процесс. Папку клона и файл `.env` можно удалить.
Частые вопросы
Как подключить Xcode к Claude Desktop?
Соберите сервер командами npm install и npm run build, затем добавьте в claude_desktop_config.json запись xcode с командой node и путем к dist/index.js. Скрипт setup.sh делает то же самое с вопросами и может сам внести запись в конфигурацию.
Что нужно для запуска?
Mac с Xcode 14 или новее и инструментами командной строки, Node.js 16 или новее. Для Swift Package Manager нужен Swift 5.5 или новее, для CocoaPods еще Ruby и сам CocoaPods.
Как ограничить папки, к которым сервер имеет доступ?
Задайте PROJECTS_BASE_DIR для основной папки проектов и перечислите дополнительные каталоги в ALLOWED_PATHS через запятую. Все пути проверяются, и вне этих каталогов сервер ничего не читает и не пишет.
Что умеет сервер в симуляторе iOS?
Показывает список устройств, запускает и останавливает их, устанавливает и запускает приложения, делает снимки экрана и записывает видео, управляет настройками симулятора.
Чем Xcode MCP Server отличается от инструментов только для симулятора?
Сервер охватывает весь цикл разработки: создание проекта, файлы, сборку, тесты, пакеты и симулятор. Узкие инструменты для симулятора, например MCP Server for iOS Simulator, управляют только самим устройством.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для iOS Simulator: тапы, свайпы, ввод текста, дерево доступности, скриншоты, видео и управление приложениями
MCP-сервер, который принимает команды на обычном языке и управляет iOS-симулятором через idb: приложения, нажатия, логи
XcodeBuildMCP (теперь MobileBuildMCP)
XcodeBuildMCP
MCP-сервер и CLI от Sentry для сборки, запуска и тестирования iOS и macOS проектов Xcode из AI-агента
MCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
MCP-сервер к официальной документации Apple: поиск по фреймворкам, API, примерам кода и сессиям WWDC прямо из агента
MCP-сервер, который ставится на iPhone с джейлбрейком и дает агенту 46 инструментов: касания, снимки экрана, OCR, приложения, файлы, логи
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Xcode MCP Server (эта карточка) | нет | не нужна | 387 | |
| iOS Simulator Skill | нет | 1 311 | скилл со скриптами для сборки и управления симулятором, без проектов, пакетов и зависимостей | |
| MCP Server for iOS Simulator | нет | не нужна | 343 | управляет только симулятором iOS через idb |
Коротко о README
README делит возможности на семь групп, объясняет два способа установки и разбирает типичные сбои сборки, прав доступа и конфигурации. Раздел о работе описывает слои сервера: регистрацию инструментов, проверку путей, определение типа проекта и безопасный запуск внешних процессов, а примеры на JavaScript показывают создание проекта, запись файла и запуск тестов.