ds-pilot

MCP-сервер, который предоставляет AI-агентам доступ к вашей дизайн-системе (компоненты + токены). Предотвращает создание агентом дубликатов компонентов или использование жестко закодированных значений там, где должны быть токены.

Установка

npx @lyse-labs/ds-pilot init

Это позволит:

• Обнаружить директорию с компонентами и файл токенов

• Настроить MCP-сервер в .mcp.json

• Добавить инструкции по дизайн-системе в ваш CLAUDE.md

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

MCP-сервер (для AI-агентов)

npx @lyse-labs/ds-pilot serve --components ./src/components --tokens ./tokens.json

После настройки ваш AI-агент сможет:

• search_components("button") — найти существующие компоненты

• get_component_props("Button") — посмотреть пропсы, типы, значения по умолчанию

• list_tokens("color") — вывести список всех цветовых токенов

• get_token("color.primary") — получить значение конкретного токена

CLI (для вас)

# List all components
npx @lyse-labs/ds-pilot list components --dir ./src/components

# List tokens filtered by type
npx @lyse-labs/ds-pilot list tokens --file ./tokens.json --type color

# Search components
npx @lyse-labs/ds-pilot search button --dir ./src/components

# Show component props
npx @lyse-labs/ds-pilot props Button --dir ./src/components

Поддерживаемые форматы

Компоненты

• React (.tsx, .ts, .jsx, .js)

• Vue / Nuxt (.vue с <script setup lang="ts">)

• Пропсы с типами, значениями по умолчанию и структурированными вариантами

• Именованные и экспорт по умолчанию (default exports)

Токены

• DTCG JSON (стандарт W3C)

• Обычный вложенный JSON (экспорт из Figma)

• CSS-переменные (Custom Properties)

• Разрешение алиасов и метаданные групп

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

1. Сканер считывает вашу кодовую базу и извлекает имена компонентов, пропсы и значения токенов

2. MCP-сервер предоставляет эти данные в виде инструментов, которые может вызывать AI-агент

3. Инструкции в CLAUDE.md предписывают агенту проверять наличие существующих компонентов перед созданием новых

Агент перестает гадать и начинает использовать повторно.

Лицензия

MIT