Icon Composer MCP
MCP-сервер и CLI собирают значки .icon с Liquid Glass для iOS 26: слои, темный режим, превью, экспорт для App Store
- 73 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает исходные PNG и SVG и пишет пакеты .icon и превью по путям, которые передает ассистент
- Ставится из `npm` и вызывает Apple ictool на macOS
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/icon-composer-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает исходные PNG и SVG и пишет пакеты .icon и превью по путям, которые передает ассистент
- Ставится из `npm` и вызывает Apple ictool на macOS
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Icon Composer MCP создает пакеты .icon, которые читает Apple Icon Composer и Xcode. Сервер дает ассистенту двенадцать инструментов: создать пакет из PNG или SVG и цвета фона, добавить или удалить слой, прочитать манифест, настроить блик, размытие, тени и прозрачность, задать фон и положение слоя, переопределения для темной и тонированной тем, выключить все эффекты сразу. Три готовых сценария ведут по задачам: создать значок приложения, добавить темный режим, выгрузить значок для App Store. Есть три способа получить картинку. Плоское превью собирается на любой платформе. render_liquid_glass считает настоящее стекло через утилиту ictool из Apple Icon Composer, для чего нужен macOS и `cask icon-composer` из Homebrew. export_marketing отдает плоский PNG 1024 на 1024 без альфа-канала для App Store Connect. То же самое доступно командой `icon-composer (create`, `add-layer`, glass, `appearance`, `fill`, `position`, `preview`, `render`, `export-marketing`, `doctor`). Команда `icon-composer doctor` проверяет окружение.
Для кого. Разработчикам iOS и дизайнерам, которые собирают значки приложений под Liquid Glass и хотят вести эту работу через ассистента или скрипты.
Подходит, если
- У приложения есть логотип в SVG, и нужен значок .icon с брендовым фоном и бликом
- К готовому значку добавляют темный режим с другим цветом фона и просматривают до и после
- Для App Store Connect нужен плоский PNG 1024 на 1024 без прозрачности
- Значок собирают из нескольких слоев и настраивают стекло для каждой группы отдельно
- Значки генерируют скриптом в CI командой `icon-composer` без участия MCP
Не подходит, если
- Нужен готовый значок с нуля: сервер оформляет вашу картинку, а рисовать глиф не умеет
- Нужен значок для Android или веба: формат .icon относится к iOS 26 и Xcode
- Рендер Liquid Glass нужен без Mac: настоящее стекло считает только ictool из Icon Composer
- Нужны прозрачные варианты ClearLight и ClearDark: через CLI они рисуются на сером фоне
Пример запроса к агенту
Собери значок из logo.svg с синим фоном #0A66C2, добавь темную тему с фоном #0B1220, покажи превью и выгрузи PNG для App StoreMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Рендер Liquid Glass работает только на macOS с установленным Apple Icon Composer (brew install --cask icon-composer). Плоское превью, создание и правка пакетов и экспорт для магазина работают везде.
- Варианты ClearLight и ClearDark рисуются на сером фоне: прозрачности стекла нужен графический процессор Metal, а из командной строки он недоступен.
- Нужен Node.js 18 или новее.
- Проект не связан с Apple, об этом автор пишет в README.
- Лицензия MIT.
Как отключить. В Claude Code сервер убирает команда `claude mcp remove icon-composer`, в остальных клиентах запись `icon-composer` удаляется из MCP-конфига. Глобальный CLI снимает `npm uninstall -g icon-composer-mcp`. Созданные пакеты .icon остаются на диске.
Частые вопросы
Как подключить Icon Composer MCP к Claude Code?
Выполните `claude mcp add icon-composer` -- npx -y icon-composer-mcp. Для Cursor, VS Code и Windsurf в README есть готовые фрагменты конфигурации с тем же npx.
Нужен ли Mac, чтобы пользоваться сервером?
Для настоящего Liquid Glass нужен: рендер идет через ictool из Apple Icon Composer. Создавать и править пакеты .icon, делать плоские превью и экспортировать PNG для App Store можно на любой платформе.
Как получить значок для App Store Connect?
Инструмент export_marketing или команда `icon-composer export-marketing` выгружает плоский PNG 1024 на 1024 без альфа-канала. Сам пакет .icon кладется в каталог ресурсов проекта Xcode.
Какие эффекты стекла можно настроить?
Блик, материал размытия, тень (нейтральная, по цвету слоя или без нее) и прозрачность. Инструмент toggle_fx включает и выключает все эффекты одним вызовом.
Можно ли обойтись без MCP?
Да, пакет ставит CLI `icon-composer`: `npm install -g icon-composer-mcp`. В нем команды от `create` до `export-marketing` и `doctor` для проверки окружения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСкилл создает, проверяет и отрисовывает значки Apple Icon Composer в формате .icon, не открывая графическое приложение.
MCP-сервер для Xcode на macOS: агент создает проекты, собирает и тестирует приложения, ставит зависимости и управляет симулятором iOS
Открытый CLI и редактор скриншотов для App Store и Google Play: 101 шаблон, подбор агентом, проверка размеров и связка с агентом
MCP-сервер, который принимает команды на обычном языке и управляет iOS-симулятором через idb: приложения, нажатия, логи
MCP-сервер для iOS Simulator: тапы, свайпы, ввод текста, дерево доступности, скриншоты, видео и управление приложениями
MCP-сервер XC-MCP дает агенту 81 инструмент Xcode и симулятора iOS и сжимает вывод сборки в короткие сводки с деталями по запросу.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Icon Composer MCP (эта карточка) | нет | не нужна | 73 | |
| Apple Liquid Glass | нет | 288 | справочник по API Liquid Glass для SwiftUI, значки .icon не собирает | |
| XcodeBuildMCP (теперь MobileBuildMCP) | да | не нужна | 6 565 | сборка и запуск проектов Xcode, значков и ресурсов не создает |
Коротко о README
README начинается с демонстрации и списка возможностей, затем даны шаблоны подключения для Claude Code, Claude Desktop, Cursor, VS Code и Windsurf, а также установка только CLI. Дальше описаны этапы работы с глифом и Apple ictool, требования к окружению, таблицы команд CLI и инструментов MCP с параметрами, примеры сценариев и список ограничений.