# noun-mcp

Ищет и скачивает иконки из The Noun Project по обычному описанию. Пригодится, когда SVG или PNG нужно получить прямо из диалога с агентом.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Автор: alisaitteke
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/alisaitteke/noun-mcp
- Обновлён: 2026-09-16
- HTML: https://affpapa.org/nevibecode/mcp/noun-mcp

## Что делает

noun-mcp подключает The Noun Project к ИИ-ассистенту. Сервер ищет иконки по описанию, фильтрует их по стилю, толщине линий и лицензии public domain, а затем скачивает SVG или PNG в выбранный путь. Можно задать цвет и размер, просматривать коллекции и получать подсказки для поисковых запросов.

Внутри семь MCP-инструментов: поиск, загрузка, работа с коллекциями, автодополнение и проверка расхода квоты. Сначала выполняется недорогой поиск, а загрузка файла расходует отдельный вызов и возвращает результат в проект. Без Node.js 18+ и ключей `NOUN_CONSUMER_KEY` и `NOUN_CONSUMER_SECRET` сервер не запустится; также нужен `NOUN_API_TIER` со значением `FREE` или `PAID`.

Для бесплатного тарифа указаны лимиты 2,000 сервисных и 150 иконных вызовов в месяц. Проверить расход можно через запрос к инструменту `check_usage`, а при ошибке квоты изменить поиск или дождаться нового окна.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `NOUN_CONSUMER_KEY`, `NOUN_CONSUMER_SECRET`, `NOUN_API_TIER` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add noun-mcp -e NOUN_CONSUMER_KEY=<NOUN_CONSUMER_KEY> -e NOUN_CONSUMER_SECRET=<NOUN_CONSUMER_SECRET> -e NOUN_API_TIER=<NOUN_API_TIER> -- npx -y @alisaitteke/noun-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add noun-mcp --env NOUN_CONSUMER_KEY=<NOUN_CONSUMER_KEY> --env NOUN_CONSUMER_SECRET=<NOUN_CONSUMER_SECRET> --env NOUN_API_TIER=<NOUN_API_TIER> -- npx -y @alisaitteke/noun-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "noun-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@alisaitteke/noun-mcp"
            ],
            "env": {
                "NOUN_CONSUMER_KEY": "<NOUN_CONSUMER_KEY>",
                "NOUN_CONSUMER_SECRET": "<NOUN_CONSUMER_SECRET>",
                "NOUN_API_TIER": "<NOUN_API_TIER>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "noun-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@alisaitteke/noun-mcp"
            ],
            "env": {
                "NOUN_CONSUMER_KEY": "<NOUN_CONSUMER_KEY>",
                "NOUN_CONSUMER_SECRET": "<NOUN_CONSUMER_SECRET>",
                "NOUN_API_TIER": "<NOUN_API_TIER>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e NOUN_CONSUMER_KEY=<NOUN_CONSUMER_KEY> -e NOUN_CONSUMER_SECRET=<NOUN_CONSUMER_SECRET> -e NOUN_API_TIER=<NOUN_API_TIER> noun-mcp npx -y @alisaitteke/noun-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- найти иконку по текстовому описанию
- отфильтровать результаты по лицензии public domain
- скачать SVG или PNG в папку проекта
- подобрать поисковые термины для короткого запроса
- проверить расход API-вызовов за месяц

## Примеры запросов агенту
- Найди сплошные иконки чашки кофе с лицензией public domain и скачай одну как красный SVG в `./icons`.
- Подскажи поисковые термины для «spo», затем найди иконки в коллекциях о погоде.
- Покажи, сколько вызовов API The Noun Project я использовал в этом месяце.

## Похожие
- [llm-icon-finder](https://affpapa.org/nevibecode/skills/llm-icon-finder.md) — скилл · 952 установки
- [excalidraw](https://affpapa.org/nevibecode/skills/agents365-ai-excalidraw.md) — скилл · 4600 установок
- [beautiful-mermaid](https://affpapa.org/nevibecode/skills/beautiful-mermaid.md) — скилл · 1800 установок
- [excalidraw-skill](https://affpapa.org/nevibecode/skills/yctimlin-excalidraw-skill.md) — скилл · 510 установок
- [better-icons](https://affpapa.org/nevibecode/skills/better-icons.md) — скилл · 5900 установок
- [icon-retrieval](https://affpapa.org/nevibecode/skills/icon-retrieval.md) — скилл · 1600 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md