Starwind UI MCP Server
MCP-сервер Starwind UI v3: агент ищет компоненты для Astro и React, читает актуальную документацию и готовит команды установки
- 35 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Сервер обращается к сайту Starwind за манифестом и документацией, и этот ответ нужно считать данными
- Инструмент миграции с параметром yes делает резервную копию и перезаписывает файлы проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/starwind-ui-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер обращается к сайту Starwind за манифестом и документацией, и этот ответ нужно считать данными
- Инструмент миграции с параметром yes делает резервную копию и перезаписывает файлы проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Starwind UI — библиотека компонентов с версией 3 для Astro и React, а Starwind Pro добавляет платные блоки. MCP-сервер дает агенту актуальные сведения о них, чтобы тот не придумывал имена компонентов и не ссылался на устаревшие версии. Инструментов пять. `starwind_search` ищет стилизованные компоненты, примитивы и блоки Pro с метаданными о поддержке фреймворка. `starwind_docs` возвращает документацию по точному компоненту, примитиву, среде Runtime, миграции или фреймворку. `starwind_init` формирует команды инициализации существующего проекта на Astro 5 или React 18 и новее. `starwind_add` проверяет запрос и выдает команды установки компонентов, примитивов или блоков Pro для Astro. `starwind_migrate` изучает проект и готовит безопасные интерактивные шаги перехода с версии 2 на версию 3. Сервер сверяет данные с версионным файлом ai-manifest.json на сайте Starwind, кэширует проверенный результат и при недоступности сайта берет встроенный снимок версии 3. Ни один инструмент сам не выполняет сгенерированные команды.
Для кого. Фронтенд-разработчикам на Astro и React, которые подключают Starwind UI и хотят, чтобы Claude Code, Codex или Cursor ставили компоненты по актуальной документации.
Подходит, если
- Новый проект на Astro нужно инициализировать под Starwind UI v3 с правильным менеджером пакетов
- Нужна кнопка, диалог или таблица, и агент подбирает подходящий компонент с версией для React или Astro
- Проект еще на версии 2, и его надо перевести на третью с резервной копией и подтверждениями
- Нужны бесплатные блоки Pro, и агент должен показать, какие из них ставятся без лицензии
Не подходит, если
- Проект не на Astro и не на React: `starwind_init` рассчитан на эти два фреймворка
- Нужны платные блоки Pro для React: они пока рассчитаны только на Astro, и запрос на добавление для React отклоняется
- Агент должен сам выполнить установку: инструменты выдают команды и не запускают их
Пример запроса к агенту
Инициализируй Starwind UI v3 в этом проекте на Astro, найди компонент диалога и покажи команду его установки.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
STARWIND_LICENSE_KEYсекрет- Лицензионный ключ Starwind Pro, нужен для платных блоков и задается в .env.local проекта
Ограничения
Сгенерированные команды версии 3 требуют Node.js 22.12.0 или новее. Платные блоки Pro нужно авторизовать лицензионным ключом STARWIND_LICENSE_KEY, а флаг pro передают только при необходимости. Бесплатные блоки Pro ставятся после обычной инициализации.
Блоки Pro сейчас рассчитаны на Astro. Миграция по умолчанию интерактивна, а параметр yes включает перезапись с резервной копией, и его задают только осознанно. Данные берутся из манифеста на сайте Starwind, а при недоступности сайта сервер использует встроенный снимок версии 3.
Как отключить. Удалите блок starwind-ui из .mcp.json, .cursor/mcp.json или ~/.codex/config.toml и перезапустите клиента. Уже установленные компоненты остаются в проекте как ваш код.
Частые вопросы
Как подключить Starwind UI MCP к Claude Code или Cursor?
Добавьте в .mcp.json для Claude Code или .cursor/mcp.json для Cursor блок starwind-ui с command npx и args -y @starwind-ui/mcp. Для Codex в ~/.codex/config.toml укажите секцию mcp_servers.starwind_ui с теми же command и args. Потом перезапустите клиента.
Какие три слоя различает Starwind UI v3?
Стилизованные компоненты, которыми вы владеете как копией в проекте, примитивы с адаптерами для Astro и React и Runtime, то есть независимые от фреймворка API поведения. Для каждого слоя сервер задает свой путь: поиск и добавление, поиск с surface primitive, документация.
Нужна ли лицензия Pro?
Бесплатные блоки каталога @starwind-pro ставятся после обычной инициализации. Платные требуют лицензионного ключа в STARWIND_LICENSE_KEY. Выдача поиска для платных блоков содержит путь перехода на Pro со ссылками на покупку и установку.
Что делает `starwind_migrate`?
Изучает проект и выдает безопасные интерактивные шаги перехода с версии 2 на версию 3. Параметр yes включает режим с резервной копией и перезаписью, и его задают только осознанно.
Запускает ли сервер установку сам?
Нет. Инструменты возвращают готовые команды с учетом найденного менеджера пакетов, а выполнять их вы или агент решаете отдельно.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыStarwind UI
starwind-ui
Переносимые компоненты UI для Astro, React и Vue на Tailwind: CLI добавляет нужные в проект исходниками. Версия 3.3.2, есть скиллы агентов
MCP-сервер Arc UI: агент ищет React-компоненты с анимацией, читает документацию и свойства, получает команду shadcn.
MCP-сервер Chakra UI: справочник по компонентам, свойствам и токенам темы плюс разбор кода при переходе с версии 2 на 3
MCP-сервер и плагин 21st.dev: поиск готовых React/Tailwind компонентов, логотипов и генерация интерфейса прямо из агента
MCP-сервер каталога анимированных React-компонентов UI Beats: поиск, свойства, исходный код и команда установки для агента
MCP-сервер библиотеки React-компонентов для интерфейсов агентов: агент находит компонент и добавляет его в проект
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Starwind UI MCP Server (эта карточка) | да | не нужна | 35 | |
| Shadcn UI MCP Server | нет | ключ необязателен | 3 096 | компоненты shadcn/ui для React и других фреймворков |
| Starwind UI | нет | 763 | командная строка Starwind, которой выполняются установка и миграция | |
| daisyUI | нет | 42 823 | плагин для Tailwind с классами компонентов |
Коротко о README
В README разобраны быстрый старт для Codex, Claude Code и Cursor, три слоя Starwind UI v3, таблица инструментов, требования, переход с бесплатных блоков на Pro, команды разработки и лицензия MIT.