Поиск и извлечение 200 000+ иконок из 150+ коллекций иконок. Работает как MCP-сервер для AI-агентов или инструмент CLI.

Быстрый старт

Добавить навыки

Включите функции CLI better-icons в среде агента (соответствует всем примерам ниже):

Прямая установка CLI

Альтернативно, установите CLI глобально для прямого использования вне агента:

---

Сервер MCP (AI-агенты)

Настройте MCP-сервер так, чтобы он включил инструменты иконок в ваших AI-агентах кода.

Это интерактивно настраивает сервер MCP для:

• Курсор
• Код Клода
• OpenCode
• Виндсерфинг
• VS код (Copilot)
• Погуглите антигравитацию

Или настроить его вручную.

CLI (прямое использование)

Используйте CLI, чтобы искать и получать иконки прямо из терминала.

Почему?

Иконки — распространённая проблема в программировании с помощью ИИ. Модели часто испытывают трудности с пониманием, какие иконки доступны, генерируют правильный SVG-код, поддерживают единообразные стили и правильно организуют иконки. Встроенные SVG также потребляют ненужные токены.

Особенности

• 200 000+ икон — Поиск по 150+ коллекциям иконок (Lucide, Heroicons, Material Design и др.)
• Авто-обучение — Запоминает, какие коллекции иконок вы используете, и расставляет их в приоритете при будущих поисках

Better Icons

Search and retrieve 200,000+ icons from 150+ icon collections. Works as an MCP server for AI agents or CLI tool.

Quick Start

Add Skills

Enable the better-icons CLI features in your agent environment (matches all examples below):

npx skills add better-auth/better-icons

Direct CLI Installation

Alternatively, install the CLI globally for direct non-agent use:

# Using npm
npm install -g better-icons

# Using Bun (faster)
bun add -g better-icons

---

MCP Server (AI Agents)

Configure the MCP server to enable icon tools in your AI coding agents.

npx better-icons setup

This interactively configures the MCP server for:

• Cursor
• Claude Code
• OpenCode
• Windsurf
• VS Code (Copilot)
• Google Antigravity

Or configure manually.

CLI (Direct Usage)

Use the CLI to search and retrieve icons directly from your terminal.

# 1. Search for icons (finds icons across 150+ collections)
npx better-icons search arrow --limit 10
npx better-icons search home --prefix lucide

# 2. Get icon SVG (outputs raw code or saves to file)
npx better-icons get lucide:home > icon.svg
npx better-icons get mdi:account --color '#333' --size 24

# 3. JSON output for scripting
npx better-icons search settings --json | jq '.icons[:5]'
npx better-icons get heroicons:check --json

Why?

Icons are a common pain point in AI-assisted coding. Models often struggle to know which icons are available, generate correct SVG code, maintain consistent styles, and organize icons properly. Inline SVGs also consume unnecessary tokens.

Features

• 200,000+ Icons - Search across 150+ icon collections (Lucide, Heroicons, Material Design, etc.)
• Auto-Learning - Remembers which icon collections you use and prioritizes them in future searches
• Project Sync - Icons are written directly to your icons file (.tsx, .ts, .js) instead of pasting SVG into chat (saves tokens!)
• Batch Retrieval - Get multiple icons at once
• Similar Icons - Find the same icon across different collections and styles
• Recent Icons - Quick access to icons you’ve used before
• Multi-Framework - React, Vue, Svelte, Solid, and raw SVG exports

Manual Installation

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "better-icons": {
      "command": "npx",
      "args": ["-y", "better-icons"]
    }
  }
}

Claude Code (CLI)

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "better-icons": {
      "command": "npx",
      "args": ["-y", "better-icons"]
    }
  }
}

Google Antigravity

Add to ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "better-icons": {
      "command": "npx",
      "args": ["-y", "better-icons"]
    }
  }
}

MCP Tools

The following tools are available when using the MCP server with AI agents.

search_icons