albertnahas/icogenie-mcp

albertnahas/icogenie-mcp

от albertnahas
MCP сервер @icogenie/mcp дает AI-агентам генерировать SVG-иконки по тексту. Помогает разработчикам быстро создавать иконки для интерфейсов в Claude. Поддерживает пакетную работу, библиотеку и ежедневные кредиты.

@icogenie/mcp

npm version npm downloads MCP Protocol License: MIT

MCP (Model Context Protocol) server for IcoGenie. Enables AI agents like Claude to generate production-ready SVG icons programmatically.

Installation

npm install -g @icogenie/mcp
# or use directly with npx
npx @icogenie/mcp

Configuration

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "icogenie": {
      "command": "npx",
      "args": ["-y", "@icogenie/mcp"]
    }
  }
}
Claude Code

The server works automatically when installed globally or via npx.

Authentication

On first use, the MCP server will:

  1. Open your browser for authentication
  2. Ask you to approve access
  3. Save the session token to ~/.icogenie/config.json

Subsequent uses are automatic - the token is shared with the IcoGenie CLI.

CI/CD Environments

Set ICOGENIE_SESSION_TOKEN environment variable to skip browser authentication:

export ICOGENIE_SESSION_TOKEN="your-session-token"
Инструменты были проиндексированы:
check_credits

Проверяет текущий баланс кредитов и информацию об аккаунте. Бесплатно.

Проверить кредиты

Параметры

Без параметров.

claim_daily_credits

Получайте 2 бесплатных кредита ежедневно. Один раз в день.

Получить ежедневные кредиты

Параметры

Без параметров.

confirm_regeneration

Завершает регенерацию выбором одного из 4 кандидатов. Бесплатно - кредит был списан во время regenerate_icon.

Подтвердить регенерацию

Параметры
  • regenTokenstringобязательный

    Токен из результата regenerate_icon

  • selectedIndexnumberобязательный

    Какого кандидата финализировать (0-3)

download_from_library

Повторная загрузка из библиотеки. Бесплатно для ранее экспортированных элементов. Укажите outputPath для сохранения в файл.

Скачать из Library

Параметры
  • libraryIdstringобязательный

    Идентификатор элемента библиотеки из list_library.

  • outputPathstring

    Куда сохранить ZIP-файл?

download_icon

Загружает окончательный пакет SVG + PNG для иконки. Стоит 5 кредитов (одиночная) или 4 кредита/иконка (набор). Укажите outputPath для сохранения в файл. Всегда сохраняйте в рабочую директорию пользователя с описательным именем файла.

Скачать иконку

Параметры
  • bundleIdstring

    ID из результата generate_bundle (для бандлов)

  • generationIdstring

    ID из результата generate_icon (для отдельных иконок)

  • outputPathstring

    Куда сохранить ZIP-файл?

  • removeBackgroundboolean

    Удаляет фон с иллюстраций (делает его прозрачным).

generate_bundle

Создаёт набор иконок. Стоит 1 кредит за иконку. Описания сводите к минимуму — мноогсловные запросы делют иконки загромождёнными. Сначал используйте normalize_bundle или передавайте иконки напрямую. Примечание: превью соднржат водяные знаки и иеют никое разрешение — только для просмотра и оценк, н для использвания в прдакшене. Используйте download_icon, чтобы полчить финальные ресры без водяных знаков.

Сгенерировать Bundle

Параметры
  • bundleIdstring

    Bundle ID из normalize_bundle для прослеживаемости

  • descriptionstring

    Пакетная тема. Система нормализует её в список иконок.

  • forceboolean

    Продолжайте действовать, даже когда ИИ обнаруживает стилистические конфликты.

  • iconsobject[]

    Список иконок из normalize_bundle или настраиваемый.

  • referenceImageobject

    Эталонное изображение в кодировке Base64

  • referenceImagePathstring

    Локальный путь к эталонному изображению

  • styleenum

    Стиль иконки: заливка (сплошные фигуры), контур (обводка линиями) или иллюстрация (цветная, детализированная)

  • targetCountnumber

    Целевое количество иконок при использовании описания.

generate_icon

Создаёт превью иконки на основе ИИ. Стоит 1 кредит. Делайте подсказки минимальными — система нормализует их внутренне. Подробные описания создают загромождённые иконки. Возвращает generationId для загрузки. Примечание: превью имеют водяные знаки и низкое разрешение, только для отображения/оценки, не для использования в production. Используйте download_icon для получения финальных ресурсов без водяных знаков.

Создать иконку

Параметры
  • forceboolean

    Продолжайте, даже когда ИИ обнаруживает конфликты стиля с запросом.

  • promptstringобязательный

    Концепция иконки для генерации. Придерживайтесь минимализма: система нормализует и улучшает промпты внутри. Многословные описания создают перегруженные иконки.

  • referenceImageobject

    Эталонное изображение в кодировке Base64

  • referenceImagePathstring

    Локальный путь к файлу эталонного изображения для извлечения стиля.

  • styleenum

    Стиль иконки: заливка (сплошные фигуры), контур (обводка линиями) или иллюстрация (цветная, детализированная)

  • variationsenum

    Количество вариаций (1, 2 или 4)

list_library

Просматривайте сохранённые иконки. Бесплатно. Используйте download_from_library с ID элемента библиотеки.

List Library

Параметры
  • limitnumber

    Максимальное количество возвращаемых элементов

  • offsetnumber

    Смещение пагинации

  • statusenum

    Фильтр по статусу

  • typeenum

    Фильтровать по типу

normalize_bundle

Спланировать набор иконок по описанию. Бесплатно, но с ограничением по частоте запросов. Возвращает bundleId — передайте его в generate_bundle для отслеживания.

Normalize Bundle

Параметры
  • descriptionstringобязательный

    Собирает тему. Система генерирует на основе этого оптимизированный список иконок.

  • styleenum

    Предпочтительный стиль иконок

  • targetCountnumber

    Целевое количество иконок (2-20)

regenerate_icon

Создаёт новый вариант иконки. Стоит 1 кредит. Возвращает 4 превью кандидатов и regenToken. Чтобы завершить, вызови confirm_regeneration с regenToken и selectedIndex (0-3).

Перегенерировать иконку

Параметры
  • bundleIdstring

    Для значков бандла

  • indexnumberобязательный

    Какой вариант/иконку перегенерировать (с нуля)?

  • promptstring

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

  • sessionIdstring

    Для вариаций одной иконки.

save_to_library

Сохраните сгенерированную иконку в свою библиотеку для бесплатного повторного скачивания. Бесплатно. Используйте generationId из generate_icon или bundleId из generate_bundle.

Сохранить в библиотеку

Параметры
  • generationIdstringобязательный

    идентификатор генерации из generate_icon или bundleId из generate_bundle

  • namestring

    Необязательное имя для записи библиотеки.

  • promptstringобязательный

    Промпт, использованный для генерации иконки.

  • styleenum

    Стиль иконок

  • typeenum

    Тип иконки

  • variationsnumber

    Количество вариаций

0.4.2основная
0.4.0
0.3.7
0.3.6
0.3.5
0.3.4
0.3.3
0.3.2
0.3.1
0.3.0
0.2.0
0.1.1

Выберите клиент, чтобы установить albertnahas/icogenie-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "albertnahas-icogenie-mcp-hai2v1tfgj": {
      "command": "npx",
      "args": [
        "-y",
        "@icogenie/mcp"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "albertnahas-icogenie-mcp-hai2v1tfgj": {
      "command": "npx",
      "args": [
        "-y",
        "@icogenie/mcp"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "albertnahas-icogenie-mcp-hai2v1tfgj": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@icogenie/mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"albertnahas-icogenie-mcp-hai2v1tfgj\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@icogenie/mcp\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "albertnahas-icogenie-mcp-hai2v1tfgj": {
      "command": "npx",
      "args": [
        "-y",
        "@icogenie/mcp"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add albertnahas-icogenie-mcp-hai2v1tfgj -- npx -y @icogenie/mcp

Либо через JSON-конфиг:

claude mcp add-json albertnahas-icogenie-mcp-hai2v1tfgj "{\"command\":\"npx\",\"args\":[\"-y\",\"@icogenie/mcp\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add albertnahas-icogenie-mcp-hai2v1tfgj -- npx -y @icogenie/mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.albertnahas-icogenie-mcp-hai2v1tfgj]
command = "npx"
args = ["-y", "@icogenie/mcp"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите albertnahas/icogenie-mcp, а в поле команды запуска — строку ниже:
npx -y @icogenie/mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "albertnahas-icogenie-mcp-hai2v1tfgj": {
      "command": "npx",
      "args": [
        "-y",
        "@icogenie/mcp"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "albertnahas-icogenie-mcp-hai2v1tfgj": {
      "command": "npx",
      "args": [
        "-y",
        "@icogenie/mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например albertnahas-icogenie-mcp-hai2v1tfgj.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: albertnahas-icogenie-mcp-hai2v1tfgj
    command: npx
    args:
      - "-y"
      - "@icogenie/mcp"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "albertnahas-icogenie-mcp-hai2v1tfgj": {
      "command": "npx",
      "args": [
        "-y",
        "@icogenie/mcp"
      ]
    }
  }
}

Похожие MCP-сервера

themesberg/flowbite-mcp

themesberg/flowbite-mcp

от themesberg

MCP сервер для работы с компонентами Flowbite на Tailwind CSS. Даёт доступ к 60+ UI-элементам, умеет генерировать тему по hex-цвету и превращать Figma-макет в код. Помогает разработчикам быстрее создавать интерфейсы.

JavaScript⭐ 42
pzfreo/build123d-mcp

pzfreo/build123d-mcp

от pzfreo

MCP сервер для 3D CAD на build123d, позволяющий AI-агентам создавать, инспектировать и итерировать геометрию. Закрывает цикл обратной связи: AI видит результат, а не пишет вслепую. Полезен инженера...

Python⭐ 121
ethbak/icon-composer-mcp

ethbak/icon-composer-mcp

от ethbak

MCP-сервер для быстрой генерации иконок, логотипов и изображений с эффектами Liquid Glass (iOS 26+). Управляет .icon-бандлами, задаёт стеклянные блики, тени, размытие и тёмную тему. Полезен дизайне...

TypeScript⭐ 61
vkhanhqui/figma-mcp-go

vkhanhqui/figma-mcp-go

от vkhanhqui

Открытый Figma MCP-сервер с полным доступом на чтение и запись через плагин. Не требует API и не имеет лимитов — подходит дизайнерам и разработчикам. Работает с AI-инструментами. Управляйте стилями...

Go⭐ 1178
musepy/genable

musepy/genable

от musepy

Genable — MCP сервер, превращающий текстовый запрос в редактируемые слои Figma: авто-макет, переменные цветов и шрифтов, светлая и темная темы. Полезен дизайнерам и разработчикам для агентных инструментов (Claude Code, Cursor). Совместим с Gemini, Claude, OpenAI.

Astro⭐ 3
GLips/Figma-Context-MCP

GLips/Figma-Context-MCP

от glips

Извлекает из макетов Figma стили, шрифты и отступы. Генерирует код под выбранный фреймворк для Cursor, VS Code и других редакторов.

TypeScript⭐ 16017
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин