Xcode MCP сервер

MCP сервер, обеспечивающий комплексную интеграцию с Xcode для AI-ассистентов, позволяющий взаимодействовать с проектами Xcode, iOS симуляторами и выполнять различные задачи разработки, связанные с Xcode.

Установка

Автоматическая установка

chmod +x setup.sh
./setup.sh

Ручная установка

git clone https://github.com/r-huijts/xcode-mcp-server.git
cd xcode-mcp-server
npm install
npm run build

Конфигурация

Claude Desktop

{
  "mcpServers": {
    "xcode": {
      "command": "node",
      "args": ["/path/to/xcode-mcp-server/dist/index.js"]
    }
  }
}

Доступные инструменты

Инструмент	Описание
`create_xcode_project`	Создание новых проектов Xcode из шаблонов (iOS, macOS, watchOS, tvOS)
`add_swift_package`	Добавление зависимостей Swift Package Manager с различными требованиями к версиям
`read_file`	Чтение файлов с поддержкой различных кодировок, включая бинарные файлы с base64
`write_file`	Запись файлов с поддержкой автоматического создания структуры директорий
`search_in_files`	Поиск текстового контента в файлах с использованием паттернов и regex
`build_project`	Сборка проектов с настраиваемыми опциями
`test_project`	Запуск тестов с подробной отчетностью об ошибках

Возможности

Установка активных проектов и получение подробной информации о проекте
Создание новых проектов Xcode из шаблонов (iOS, macOS, watchOS, tvOS)
Добавление файлов в проекты Xcode с указанием целей и групп
Чтение/запись файлов с поддержкой различных кодировок
Обработка бинарных файлов с кодированием/декодированием base64
Поиск текстового контента в файлах с использованием паттернов и regex
Сборка проектов с настраиваемыми опциями
Запуск тестов с подробной отчетностью об ошибках
Интеграция с CocoaPods для управления подами
Поддержка Swift Package Manager

Переменные окружения

Обязательные

PROJECTS_BASE_DIR - Базовая директория для проектов

Опциональные

DEBUG - Включить отладочное логирование
ALLOWED_PATHS - Дополнительные директории для доступа (через запятую)
PORT - Порт для запуска сервера
LOG_LEVEL - Установить уровень логирования

Примеры использования

Создание нового проекта iOS приложения с конкретными настройками организации

Добавление зависимости Swift Package, такой как Alamofire, в текущий проект

Чтение содержимого Swift файла с правильной кодировкой

Поиск конкретных определений классов в Swift файлах проекта

Сборка проекта с Debug конфигурацией

Ресурсы

GitHub Repository

Примечания

Требует macOS с Xcode 14.0 или выше, Node.js 16+, и опционально CocoaPods для функций, связанных с подами. Сервер реализует комплексную обработку ошибок и поддерживает несколько типов проектов, включая стандартные проекты Xcode, рабочие области и проекты Swift Package Manager.