coolicons MCP
MCP-сервер ищет иконку coolicons по смыслу и отдает SVG с готовым импортом: агент не выдумывает имена, сборка не падает
- 491 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер запускается из пакета npm командой `npx -y` с правами вашего пользователя и подтягивает актуальную версию
- Агент вставляет полученный SVG и импорты в файлы проекта, поэтому результат стоит просмотреть в диффе
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/cooliconsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер запускается из пакета npm командой `npx -y` с правами вашего пользователя и подтягивает актуальную версию
- Агент вставляет полученный SVG и импорты в файлы проекта, поэтому результат стоит просмотреть в диффе
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер `@coolicons/mcp` ищет иконки coolicons по названию и смыслу и отдает агенту SVG-код с готовой строкой импорта. Весь набор из 1324 иконок, пяти стилей и трех радиусов углов лежит внутри пакета, поэтому ключ API и сеть не нужны. Инструментов пять: `describe_set` показывает состав набора и правила имен, `search_icons` ищет по имени или смыслу, `list_icons` листает одну категорию, `get_icon` отдает SVG нужного стиля, `get_usage` выдает команду установки и импорт для React, Vue, SVG или реестра shadcn/ui. Несколько поисков уходят одним вызовом, если разделить запросы запятыми. Когда имени нет, сервер возвращает ближайшие названия, и опечатка исправляется за один ход. Совпадения по части слов помечаются как слабые вместе со словами, которых им не хватает. Имена, занятые в JavaScript или браузере (`map`, `file`), приходят с суффиксом `Icon`, например `MapIcon`. В том же репозитории лежат CLI `@coolicons/cli` и скилл с правилами для агента. Скилл требует брать имя только из настоящего списка: сначала через MCP, затем из установленного пакета, справочника `references/icons.md` или онлайн-индекса.
Для кого. Фронтенд-разработчикам на React, Vue или shadcn/ui, которые просят агента вставить иконки coolicons и не хотят чинить сборку из-за выдуманных имен.
Подходит, если
- Агент добавляет в интерфейс иконки, угадывает названия, а сборка падает на несуществующем импорте
- Проект уже работает на `@coolicons/react` или `@coolicons/vue`, и новые иконки должны совпасть по стилю и радиусу с прежними
- Нужна иконка по смыслу, например «календарь с событием» или «загрузка», а точное имя неизвестно
- Другую библиотеку иконок заменяют на coolicons, и каждую иконку сопоставляют по смыслу с проверкой имени
- В проекте на shadcn/ui отдельные иконки нужны кодом внутри репозитория: `get_usage` выдает команду для реестра
Не подходит, если
- Нужны иконки из других наборов или тысячи брендовых логотипов: сервер знает только coolicons, для остальных наборов в каталоге есть Better Icons
- Иконки выбирает дизайнер глазами: для просмотра есть сайт coolicons.cool и файл в Figma
- Нужен нестандартный рисунок: сервер выдает готовые иконки и новых не рисует
- Проект на Svelte, Solid или Angular: готовых пакетов компонентов для них нет, подойдут SVG-файлы из `@coolicons/svg`
Пример запроса к агенту
Замени иконки в компоненте Navbar на coolicons в стиле fill со скругленными углами и перечисли, для каких не нашлось парыMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Сервер знает только набор coolicons и ничего не ищет в сети, имена из других наборов он не подскажет.
- Готовые компоненты есть для React и Vue 3, остальным средам достаются SVG-файлы из `@coolicons/svg` и реестр shadcn/ui.
- Результат с пометкой слабого совпадения подходит лишь по части слов запроса: сверьте иконку по смыслу или откройте категорию через `list_icons`.
- Переименованная иконка сохраняет старое имя только до следующей мажорной версии, поэтому после обновления пакета перепроверьте импорты.
Как отключить. Уберите сервер командой `claude mcp remove coolicons`, в других клиентах удалите запись `coolicons` из конфигурации MCP. Скилл удаляется вместе с папкой навыков, а пакеты `@coolicons/react`, `@coolicons/vue` и `@coolicons/svg` снимает `npm uninstall`.
Частые вопросы
Как подключить coolicons к Claude Code?
Выполните `claude mcp add coolicons -- npx -y @coolicons/mcp`. Ключ и сеть не нужны, набор лежит внутри пакета. В другом клиенте с MCP по stdio добавьте сервер `coolicons` с командой `npx` и аргументами `-y`, `@coolicons/mcp`.
Зачем агенту MCP-сервер, если есть пакет с иконками?
Названий coolicons в обучающих данных моделей нет, и неверное имя ломает сборку. Сервер ищет по настоящему списку и при опечатке отвечает ближайшими именами, поэтому ошибка исправляется за один ход.
Чем отличаются стили и радиусы углов?
Стилей пять: `line` (контур), `duocolor`, `duotone`, `fill` и `bulk`. Радиусов три: `sharp`, `regular` и `round`. Корень пакета дает `line` с `regular`, остальные сочетания импортируются отдельно, например `@coolicons/react/fill` или `@coolicons/react/bulk/round`.
Почему сервер возвращает MapIcon для иконки map?
Имя `Map` занято в JavaScript, `File` в браузере. Импорт одноименной иконки скрыл бы встроенный объект, и проверка `value instanceof File` молча перестала бы работать. Для таких имен у каждой иконки есть вариант с суффиксом `Icon`, и сервер отдает его сам.
Работает ли coolicons без интернета?
Да. Весь набор входит в пакет `@coolicons/mcp`, поэтому поиск и выдача SVG идут без сети и без ключа. Сеть нужна лишь при первой загрузке пакета через `npx`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер набора Keyline Icons: агент ищет иконку по имени, берет SVG и готовый импорт React без угадывания названий
Поиск и вставка иконок из более чем 150 коллекций Iconify как MCP-сервер, CLI и скилл, с записью SVG прямо в файл проекта
MCP-сервер и скилл для набора из тысяч брендовых SVG-иконок: агент ищет и вставляет иконки без ключа
MCP-сервер и плагин ищут значки Microsoft Fluent UI по смыслу и отдают точные имена React-компонентов вместе с кодом.
MCP-сервер и CDN с иконками сервисов: подбирает логотипы к docker-compose.yml и отдает SVG, PNG и WEBP
MCP-сервер и плагин 21st.dev: поиск готовых React/Tailwind компонентов, логотипов и генерация интерфейса прямо из агента
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| coolicons (эта карточка) | нет | не нужна | 491 | |
| Better Icons | нет | не нужна | 1 463 | ищет иконки в более чем 150 коллекциях Iconify и пишет SVG прямо в файл проекта |
| theSVG | да | не нужна | 2 966 | набор тысяч брендовых SVG-логотипов, интерфейсных иконок в нем нет |
| Dashboard Icons | да | не нужна | 9 032 | логотипы сервисов для панелей и docker-compose, отдает SVG, PNG и WEBP |
Коротко о README
Главная страница репозитория начинается с цифр набора и трех причин его выбрать: стили под интерфейс, четкие линии на сетке 24 на 24 пикселя с обводкой 2 px и пакеты под разные среды. Дальше идут примеры для React, Vue и SVG, таблицы стилей и свойств, правила имен и раздел об агентах с тремя инструментами.