Refero MCP

Ищите на styles.refero.design на обычном английском языке и добавляйте DESIGN.md в любой проект.

Быстрая навигация

Что это такое

Refero Styles — это бета-каталог из около 200 отобранных сайтов, где кто-то проделал кропотливую работу по извлечению цветов, типографики, отступов и рекомендаций «делай/не делай» для каждого стиля. Каждая запись поставляется с блоком designSystem, который по сути является готовым DESIGN.md.

Этот MCP оборачивает данный каталог, чтобы Claude Code мог искать в нем на естественном языке и добавлять сгенерированный DESIGN.md прямо в любой проект, который вы создаете. Никакого копирования JSON из вкладок браузера, никаких таблиц токенов вручную.

Он предназначен для всех, кто использует Claude Code для запуска нового приложения, презентации или клиентского проекта и хочет зафиксировать дизайн-код до отрисовки первого компонента.

Быстрая установка

Одна строка:

claude mcp add refero -- npx -y fidgetcoding-refero-mcp

Перезапустите Claude Code и начните описывать желаемый внешний вид.

Если вы хотите поиск по «вайбу» (семантическое ранжирование по поэтичному описанию northStar каждого стиля), передайте ключ OpenAI:

claude mcp add refero --env OPENAI_API_KEY=sk-... -- npx -y fidgetcoding-refero-mcp

Без него поиск переключается на оценку по ключевым словам. Работает нормально, просто менее «магически».

Для пользователей claude_desktop_config.json:

{
  "mcpServers": {
    "refero": {
      "command": "npx",
      "args": ["-y", "fidgetcoding-refero-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "REFERO_MCP_VAULT_DIR": "/absolute/path/to/your/vault"
      }
    }
  }
}

Использование

Несколько промптов, которые хорошо работают:

"Find me a dark editorial style with a serif and a warm accent."

"Pull the full breakdown for Linear."

"What's similar to Vercel in the Refero catalog?"

"Render Cursor's DESIGN.md — don't save it yet, just show me."

"Save Cursor's DESIGN.md into my PARZVL project."

"Show me only dark-mode brutalist styles, top five."

"Refresh the Refero catalog before we start the design pass."

Больше готовых рецептов в docs/USAGE.md.

Инструменты

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

Все опционально. Значения по умолчанию подобраны так, чтобы MCP просто работал.

Пример .env.example поставляется в корне репозитория.

Для REFERO_MCP_VAULT_DIR нет значения по умолчанию. В предыдущем черновике был жестко прописан путь моего ноутбука, что отлично работало ровно на одной машине на Земле. Рецензент это заметил. Теперь, если вы его не зададите, инструмент просто откажется записывать — грубо, но лучше, чем создавать файлы в папке, которой нет на вашем компьютере.

Как это работает

На момент написания публичной документации API Refero нет — структура была сопоставлена эмпирически на основе живого сайта. Полный разбор находится в docs/api-surface.md, чтобы я в будущем не переоткрывал его заново.

• Локальное зеркало каталога. Refero использует пагинацию ?page=N, но молча игнорирует ?search=, ?q= и ?colorScheme=. Поэтому этот MCP один раз проходит по страницам, зеркалирует их локально в REFERO_CACHE_DIR и выполняет всю фильтрацию и ранжирование на стороне клиента.

• Поиск по «вайбу» через northStar. Каждый стиль Refero поставляется с однострочным поэтичным резюме под названием northStar. Если задан OPENAI_API_KEY, MCP создает эмбеддинги этих резюме с помощью text-embedding-3-small и ранжирует их по косинусному сходству с вашим запросом. Без ключа он переключается на оценку по ключевым словам в northStar + теги + название сайта.

• DESIGN.md генерируется локально. Refero не предоставляет эндпоинт /design.md. MCP синтезирует его из style.fullResult.designSystem (dos, donts, теги, тема, цвета с ролевыми тегами). Вывод совместим с навыками /stitch-design-taste и /design-taste-frontend.

Устранение неполадок

«Стили не найдены» / каталог кажется пустым. При первом запуске кэш пуст. Попросите Claude «обновить каталог Refero» один раз — он пройдет по ~10 страницам с вежливой задержкой в 250 мс и запишет их в REFERO_CACHE_DIR. После этого поиск будет мгновенным.

Результаты поиска кажутся основанными на ключевых словах, а не семантическими. Вероятно, у вас не задан OPENAI_API_KEY. Добавьте его в конфигурацию MCP и перезапустите, или используйте более специфичную лексику каталога (отрасли плюс теги, такие как editorial, brutalist, glass).

refero_design_md возвращает markdown, но не записывает на диск. REFERO_MCP_VAULT_DIR не задан. Установите его на корень вашего хранилища (абсолютный путь), и инструмент будет записывать в <vault>/05-Projects/<NAME>/DESIGN.md. Без этого вы получите markdown в диалоге и сможете вставить его куда угодно.

Лицензия

MIT — подробности см. в LICENSE.

Автор

Создано Nate Davidovich / Lorecraft LLC.

• GitHub: lorecraft-io

• npm: lorecraft

• Родственные проекты: morgen-mcp, motion-mcp

⤴ наверх

Безопасность: сканирование gitleaks

Этот репозиторий поставляется с конфигурацией .gitleaks.toml и вспомогательным скриптом scripts/security-scan.sh, который сканирует рабочее дерево на наличие секретов (токены GitHub, ключи API, JWT, закрытые ключи, ключи Anthropic и т. д.).

bash scripts/security-scan.sh

Хук .husky/pre-commit также запускает gitleaks protect --staged при каждом коммите и выдает предупреждение, если gitleaks не установлен локально.

Если у вас его еще нет:

• macOS: brew install gitleaks

• Linux: https://github.com/gitleaks/gitleaks/releases