Roast My Design System

Roast My Design System — MCP-сервер сообщества (автор — gregkozakiewicz). Аудит дизайн-системы и правила для агента, чтобы код от ИИ ей соответствовал. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
gregkozakiewicz
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
javascript

Уровень риска: medium

MCP-сервер локальный и только читает файлы репозитория; без сети и телеметрии.

Настройка клиентов

cursor
{
    "code": "{ \"mcpServers\": { \"roast\": { \"command\": \"npx\", \"args\": [\"roast-my-design-system\", \"--mcp\"] } } }",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "verified": "docs"
}

Что умеет

roast-my-design-system — проект сообщества, который находит места, где ИИ-агент начнёт «выдумывать» интерфейс. Агент копирует то, что находит в репозитории, и импровизирует там, где ответа нет. Инструмент сканирует UI-репозиторий, показывает реальную дизайн-систему, беспорядок в ней и пробелы, учит агента через сгенерированные правила и локальный MCP-сервер и проверяет каждую правку. Работает без аккаунта, без сети и без телеметрии.

Отчёт открывается через секунду после запуска в корне репозитория:

  • Пробелы — где агенту придётся угадывать: суть, файлы-доказательства и шаг, который закрывает пробел.
  • Исправления — найденный беспорядок, ранжированный по пользе, с путями файлов и готовым промптом для агента.
  • Оценка от 0 до 100, одинаковая при каждом запуске, в сравнении с нормами дизайн-систем, медианой продуктовых репозиториев и известными системами вроде Primer, Polaris, Carbon и shadcn/ui. Для монорепозиториев — по каждому пакету.
  • Каждая находка с путём: захардкоженные цвета и их почти одинаковые двойники, отступы вне шкалы, дублирующиеся компоненты и ещё 8 видов проблем.

Инструмент понимает CSS-переменные, темы Tailwind, переменные Sass и Less, а также shadcn/ui, MUI, Mantine, Chakra и Ant Design. Все числа считает детерминированный скрипт; пояснения от Claude помечены отдельно.

Инструменты MCP (живые ответы по текущему коду):

  • roast_get_context — что нужно знать перед правкой UI в этой папке.
  • roast_find_component — есть ли уже нужный компонент и какой из них основной, с примером использования.
  • roast_find_token — каким токеном заменить цвет или размер, написанный вручную.
  • roast_validate — не нарушит ли систему то, что агент собирается сохранить.
  • roast_review — проверка изменённых файлов по git diff.

Есть промпт roast-fix, который выдаёт следующий шаг исправления из свежего скана.

Кому подойдёт

  • Фронтенд-командам, которые пишут UI с помощью ИИ-агентов.
  • Владельцам дизайн-систем, которым нужна измеримая оценка и список пробелов.

Похожие серверы — в категории дизайн.

Установка

Ставить ничего не нужно: npx roast-my-design-system@latest в корне репозитория строит отчёт, а флаг --mcp запускает MCP-сервер. Для Claude Code есть плагин с двумя навыками, MCP-сервером и автоматическими проверками правок. Для CI сканер выдаёт SARIF для GitHub code scanning.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add roast -- npx roast-my-design-system@latest --mcp

Для Cursor файл .cursor/mcp.json кладут в проект, чтобы скан видел один репозиторий, а не весь диск, и включают roast в настройках Tools & MCP. Конфиг Windsurf глобальный (~/.codeium/windsurf/mcp_config.json), поэтому в нём указывают папку проекта.

Проверка

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

Примеры задач

Есть ли у нас уже компонент для модального окна? Какой основной?
Проверь мои изменённые файлы на захардкоженные цвета и отступы вне шкалы.

Риски

  • Чтение файлов репозитория — сервер сканирует проект при запуске. Ограничьте область одной папкой проекта.
  • MCP-сервер ничего не меняет и не обращается к сети; CLI пишет отчёт рядом с репозиторием, а с --apply — правила в файлы агентов.

Частые вопросы

Отправляет ли инструмент код куда-то?

Нет: без сети и без телеметрии.

Меняет ли MCP-сервер файлы?

Нет, он только читает.

Какие UI-библиотеки поддерживаются?

Tailwind, shadcn/ui, MUI, Mantine, Chakra UI и Ant Design.

Основы протокола — на странице что такое MCP-сервер.

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

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники