MCP-сервер Phosphor Icons

Сервер протокола Model Context Protocol (MCP), предоставляющий доступ к Phosphor Icons — гибкому семейству иконок, включающему 6 различных начертаний и более 1000 иконок.

Важно: Это общественный проект, созданный с помощью ИИ, он не является официальным репозиторием и не связан с проектом Phosphor Icons. Этот проект был создан при поддержке ИИ и поддерживается сообществом. Оригинальный проект Phosphor Icons можно найти по адресу https://github.com/phosphor-icons.

Возможности

• 🎨 6 начертаний иконок: thin (тонкие), light (светлые), regular (обычные), bold (жирные), fill (залитые) и duotone (двухцветные)

• 🌈 Настройка цвета: Применение любого цвета (hex, RGB, именованные цвета или currentColor)

• 📏 Контроль размера: Указание пользовательских размеров в пикселях

• 🔍 Поиск иконок: Поиск иконок по названию, категории или тегам

• 📦 Пакетные операции: Получение нескольких иконок за раз

• 📚 Доступ к каталогу: Просмотр всех доступных иконок с метаданными

• 🛠️ Руководства по реализации: Получение помощи по интеграции для конкретных фреймворков

Related MCP server: Iconify MCP Server

Установка

npm install

CLI

Пакет поставляется с CLI-инструментом phosphor-icons для экспорта ресурсов SVG/PNG без вызова MCP.

Для локальной разработки сначала выполните сборку и запустите скомпилированный CLI:

npm run build
node dist/cli.js icon heart --weight bold --color "#ef4444" --size 32 --out heart.svg
node dist/cli.js icon house user gear --format png --size 24 --dir ./icons
node dist/cli.js search arrow --limit 5
node dist/cli.js categories

После установки пакета используйте команду bin:

phosphor-icons icon heart --size 16 --out heart.svg
phosphor-icons icon heart --format png --size 16 --out heart.png
phosphor-icons search arrow --limit 5
phosphor-icons categories

Команды CLI:

• icon <name...>: Получить одну или несколько иконок в формате SVG или PNG.

• search <query>: Поиск по названиям иконок и встроенным метаданным.

• categories: Список встроенных категорий и примеров.

• skill path: Вывести путь к встроенному каталогу навыков Codex.

Флаги для icon:

• --weight, -w: thin, light, regular, bold, fill или duotone.

• --color, -c: Любое значение цвета SVG, включая currentColor.

• --size, -s: Размер в пикселях для ширины и высоты.

• --format, -f: svg или png.

• --out, -o: Выходной файл для одной иконки.

• --dir, -d: Выходная директория для пакетного экспорта.

CLI сначала считывает иконки из установленного пакета @phosphor-icons/core. Это обеспечивает быстрый, детерминированный и автономный экспорт иконок после npm install. Если локальные ресурсы недоступны, он обращается к исходному URL-адресу Phosphor Core на GitHub.

Дымовое тестирование CLI

npm install
npm run build
node dist/cli.js icon heart --size 16 --out live-heart.svg
node dist/cli.js icon heart --format png --size 16 --out live-heart.png
node dist/cli.js search arrow --limit 5

Ожидается:

• live-heart.svg содержит width="16" height="16".

• live-heart.png создается с ненулевым размером файла.

• Поиск возвращает названия иконок, связанных со стрелками.

Расширение навыков

Этот пакет включает навык Codex/Agents по адресу skills/phosphor-icons/SKILL.md. После установки пакета найдите его с помощью:

phosphor-icons skill path

Навык предоставляет агентам краткие правила для поиска, получения, экспорта и реализации иконок в фреймворках. Используйте этот путь при регистрации навыка в среде выполнения агента или при копировании навыка в директорию навыков агента.

Совместимость с Vercel Skills CLI

Репозиторий совместим с форматом CLI skills от Vercel Labs: навыки находятся в skills/<name>/SKILL.md, а файл начинается с YAML-заголовка name и description.

Список навыков из этого репозитория:

npm run skills:list
# or
npx skills add . --list

Установка встроенного навыка из локальной копии:

npx skills add . --skill phosphor-icons --agent codex --copy -y

Установка из GitHub после публикации:

npx skills add lasaths/phosphor-icons-mcp --skill phosphor-icons --agent codex -y

Установка из копии пакета npm путем разрешения пути к навыку:

phosphor-icons skill path
npx skills add ./skills/phosphor-icons --agent codex --copy -y

Разработка

Запустите сервер разработки:

npm run dev

Это запустит сервер на порту 8081 и откроет песочницу Smithery для тестирования.

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

Сервер поддерживает необязательный параметр конфигурации:

• defaultWeight: Установка начертания иконки по умолчанию (thin, light, regular, bold, fill, duotone). По умолчанию: regular

Инструменты

get-icon

Получение одной или нескольких иконок SVG из библиотеки Phosphor Icons. Укажите либо одно имя иконки, либо массив имен для пакетного получения.

Параметры:

• name (строка, необязательно): Имя одной иконки в формате kebab-case (например, 'arrow-left', 'user'). Используйте для одной иконки.

• names (массив, необязательно): Массив имен иконок для пакетного получения. Используйте для нескольких иконок.

• weight (необязательно): Начертание/стиль иконки

• color (необязательно): Цвет иконки - принимает hex (#FF0000), RGB (rgb(255,0,0)), именованные цвета (red) или 'currentColor'

• size (необязательно): Размер иконки в пикселях (устанавливает ширину и высоту)

• format (необязательно): Формат вывода (svg или png). По умолчанию: svg

• saveToFile (необязательно): Путь для сохранения файла PNG (только для одной иконки)

• saveDir (необязательно): Директория для сохранения файлов PNG (только для нескольких иконок)

Примеры:

get-icon name="heart" weight="bold" color="#FF0000"
get-icon names=["star", "heart"] weight="fill" color="gold" size=48
get-icon name="user" color="currentColor"

search-icons

Поиск иконок по названию, категории или тегам.

Параметры:

• query (строка): Поисковый запрос

• limit (необязательно): Максимальное количество результатов (по умолчанию: 10)

Пример:

search-icons query="arrow" limit=5

list-categories

Получение списка всех доступных категорий иконок.

Ресурсы

phosphor://catalog

Полный каталог популярных иконок Phosphor Icons с метаданными, включая категории, теги и доступные начертания.

phosphor://weights

Подробная информация о 6 доступных начертаниях/стилях иконок и вариантах их наилучшего использования.

Промпты

implement-icon

Получение рекомендаций по реализации иконки Phosphor в вашем проекте.

Параметры:

• iconName (строка): Название иконки

• framework (строка): Фронтенд-фреймворк (html, react, vue, svelte, angular)

Публикация в Smithery

1. Отправьте код на GitHub

2. Посетите smithery.ai/new

3. Подключите свой репозиторий GitHub

4. Настройте автоматическое развертывание

Начертания иконок

• Thin: Изящные, минималистичные штрихи - лучше всего подходят для больших размеров

• Light: Тонкий, изысканный вид - современный дизайн

• Regular: Сбалансированный, универсальный - общее использование (по умолчанию)

• Bold: Сильный, выразительный - для акцентов и малых размеров

• Fill: Сплошные, залитые фигуры - сильный акцент

• Duotone: Двухцветный дизайн - визуальный интерес

Примеры

Получить красную иконку сердца в жирном начертании:

// Returns SVG content for a bold red heart icon
get-icon({ name: "heart", weight: "bold", color: "#FF0000" })

Получить синюю иконку звезды пользовательского размера:

// Returns a 48px blue filled star icon
get-icon({ name: "star", weight: "fill", color: "#3B82F6", size: 48 })

Поиск иконок навигации:

// Returns list of icons related to navigation
search-icons({ query: "navigation", limit: 10 })

Получить несколько цветных иконок для интерфейса:

// Get home, user, and settings icons all in blue
get-icon({ 
  names: ["home", "user", "gear"],
  weight: "regular",
  color: "#3B82F6",
  size: 24
})

Отказ от ответственности

ОТСУТСТВИЕ ГАРАНТИЙ И ОТВЕТСТВЕННОСТИ

ДАННОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, ПОМИМО ПРОЧЕГО, ГАРАНТИИ ТОВАРНОЙ ПРИГОДНОСТИ, ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ И НЕНАРУШЕНИЯ ПРАВ. НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ АВТОРЫ ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ЗА ЛЮБЫЕ ПРЕТЕНЗИИ, УЩЕРБ ИЛИ ИНУЮ ОТВЕТСТВЕННОСТЬ, БУДЬ ТО В РЕЗУЛЬТАТЕ ДОГОВОРА, ДЕЛИКТА ИЛИ ИНОГО, ВОЗНИКАЮЩУЮ ИЗ, В СВЯЗИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ ИЛИ ИСПОЛЬЗОВАНИЕМ ИЛИ ИНЫМИ ДЕЙСТВИЯМИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ.

ИСПОЛЬЗУЙТЕ НА СВОЙ СТРАХ И РИСК

• Это неофициальный общественный проект, созданный с помощью ИИ

• Программное обеспечение предоставляется без каких-либо гарантий или поддержки

• Пользователи несут ответственность за тестирование и проверку программного обеспечения для своих целей

• Сопровождающие не несут ответственности за любой ущерб, потерю данных или проблемы, возникшие в результате использования этого программного обеспечения

• Этот проект не одобрен и не связан с официальным проектом Phosphor Icons

Лицензия

Этот MCP-сервер распространяется под лицензией MIT. Иконки Phosphor Icons также распространяются под лицензией MIT.

Ссылки

• 🌐 Веб-сайт Phosphor Icons

• 💻 Оригинальный репозиторий Phosphor Icons (Официальный)

• 📦 Phosphor Icons Core

• 📖 Документация Smithery

• 🔧 Протокол MCP

Авторы

• Иконки: Предоставлены Phosphor Icons - созданы Тобиасом Фридом

• MCP-сервер: Общественный проект, созданный с помощью ИИ

• Сопровождающие: Участники сообщества (не связаны с Phosphor Icons)