onyx MCP
onyx
Сервер от создателей onyx подсказывает агенту точные пропсы Vue-компонентов, иконки и токены CSS установленной версии.
- 126 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Сервер отдает справочные данные о компонентах и скиллы; код проекта меняет сам агент.
Установка
- Работает в
Ручная установка
npm install -g @sit-onyx/modelcontextprotocolПервая команда README ставит CLI `onyx-mcp` глобально.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Сервер отдает справочные данные о компонентах и скиллы; код проекта меняет сам агент.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`onyx-mcp` — MCP-сервер дизайн-системы onyx от Schwarz Digits. Агент получает справочник компонентов Vue: список, описание API, документацию каждого, иконки и дизайн-токены CSS. Благодаря этому вместо догадок о пропсах он берет данные для той версии библиотеки, что стоит в проекте. Вместе с сервером идут четыре скилла: `onyx-components`, `onyx-foundation`, `onyx-setup` и `onyx-install-mcp`. Они описывают подключение стилей и шрифтов, сетку, адаптивные миксины и работу с компонентами. Скиллы можно выгрузить в обычные файлы флагом `--writeSkills`.
Для кого. Командам на Vue и Nuxt, которые строят интерфейс на onyx и хотят, чтобы агент знал API компонентов, а не придумывал свойства.
Подходит, если
- Агент собирает форму из компонентов onyx и должен знать точные пропсы и события.
- В новом проекте подключают стили, шрифты, i18n и маршрутизатор onyx по инструкции скилла `onyx-setup`.
- Верстку с жестко заданными цветами переводят на токены CSS библиотеки.
- Иконку подбирают из набора onyx по названию, а не рисуют заново.
Не подходит, если
- Проект не использует onyx: сервер знает только эту библиотеку.
- Нужна другая UI-библиотека на Vue, для нее ищите отдельный сервер.
- Интерфейс собирается без компонентов Vue, например на чистом HTML.
Пример запроса к агенту
Собери форму входа на компонентах onyx: сначала выясни версию библиотеки в проекте, затем возьми API нужных компонентов и токены цветов.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
Сервер отвечает только про onyx и подходит проектам на Vue. Чтобы данные совпали с проектом, версию библиотеки определяют до запросов: скилл `onyx-components` требует такой шаг. Клиентам без поддержки ресурсов MCP нужен флаг `-r` (`--resourcesAsTools`). За корпоративным прокси может понадобиться переменная `NODE_USE_SYSTEM_CA=1`. Нужна версия Node.js из файла `.node-version` репозитория. Сервер выдает справку, а не генерирует код: итоговую верстку проверяет разработчик.
Как отключить. Удалите запись `onyx-mcp` из конфигурации клиента и выполните `npm uninstall -g @sit-onyx/modelcontextprotocol`. Выгруженные командой `--writeSkills` файлы скиллов удалите отдельно.
Частые вопросы
Зачем флаг `-r`?
Он включает `--resourcesAsTools`: ресурсы сервера становятся инструментами. Флаг нужен клиентам, которые не умеют читать ресурсы MCP.
Как не дублировать скиллы в контексте?
Выгрузите их командой `onyx-mcp --writeSkills "./skills"`, затем запустите сервер с `--exclude "skill"`. Скиллы останутся файлами, а сервер перестанет их отдавать.
Как подключить к Gemini CLI?
Добавьте запись `onyx-mcp` с командой `onyx-mcp` и аргументом `-r` в `~/.gemini/settings.json`. Проверка: `gemini mcp list`.
Это официальный сервер?
Да, README называет его официальным MCP-сервером onyx. Репозиторий принадлежит организации SchwarzIT.
Работает ли сервер по сети?
Да, в пакете есть режим HTTP наряду со stdio. В README подробно описан запуск через stdio, команда `onyx-mcp -h` покажет остальные параметры.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыNuxt MCP Dev
nuxt-mcp-dev / vite-plugin-mcp
Модуль Nuxt и плагин Vite поднимают MCP-сервер на порту dev-сервера: агент видит конфигурацию, страницы, компоненты, автоимпорты и граф модулей
MCP-сервер Vuetify: агент берет из него API компонентов, гайды, заметки к релизам и план перехода с версии 2 на 3
MCP-сервер CodeRocket отдает агенту правила дизайн-системы, компоненты и блоки сохраненной библиотеки только на чтение.
Плагин Vite с MCP-сервером: агент видит компоненты, маршруты и хранилища Pinia запущенного Vue-приложения
Inspo
inspo
Сервер MCP со справочником реальных рабочих сайтов, по которым агент изучает дизайн до написания интерфейса. Брать приемы, не копировать страницы
MCP-сервер от MasterGo: агент получает DSL дизайн-файла по ссылке и восстанавливает макет как HTML или компонент.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| onyx MCP (эта карточка) | да | не нужна | 126 | |
| Nuxt UI | да | 7 066 | описывает компоненты Nuxt UI; onyx MCP знает только библиотеку onyx и ее токены | |
| Design Systems MCP | нет | не нужна | 227 | работает с набором разных дизайн-систем; onyx MCP выпущен командой одной библиотеки |
Коротко о README
Пакет `@sit-onyx/modelcontextprotocol` ставится глобально и запускается командой `onyx-mcp`. В README описаны подключение к Gemini CLI, выгрузка скиллов и запуск инспектора при разработке.