Spartan UI

spartan.ng · официальный сервер

Даёт агенту свойства компонентов, примеры кода и инструкцию по установке spartan/ui с сайта библиотеки, когда он собирает сайт или кабинет на Angular

На твоём компьютере·Без ключа·Бесплатно·17 инструментов·проверено 16.10.2026 на версии 1.7.0

Другие способы ↓Что можно сделать ↓

Перед установкой

Действует от твоего имени. Инструменты: spartan_cache_clear, spartan_cache_rebuild. Агент спросит разрешение перед каждым действием. Не нажимай «больше не спрашивать» для этих инструментов.

Читает тексты посторонних: страницы сайта www.spartan.ng, статья на dev.to про тёмную тему. В таком тексте могут прятаться команды для агента.

Осторожно в паре с подключениями, которые видят твои данные.

Персональные данные клиентов могут уйти за границу. Если через подключение пойдут данные твоих клиентов, это передача за границу по 152-ФЗ: нужны согласие людей и уведомление Роскомнадзора.

Работа из России нестабильна (на 16.10.2026). Регистрация, ключ и оплата не нужны. 16 октября 2026 года страница компонента на www.spartan.ng открылась с трёх российских узлов check-host.net, двух московских и одного петербургского, за 0,3-1,3 секунды, архив пакета из реестра npm тоже скачался. Сам сервер из России мы не запускали, поэтому пишем «не проверено до конца». Сверено 16.10.2026.

Что сможет агент

Свойства компонента агент читает со страницы spartan.ng. У окна Dialog пришли 7 базовых частей Brain и 10 оформленных частей Helm с типами и значениями по умолчанию, например showCloseButton и closeLabel у содержимого окна.
Код примеров приходит из документации: по таблице данных сервер прислал 26 фрагментов, в первом таблица платежей с сортировкой, поиском, постраничным выводом и выбором строк на @tanstack/angular-table.
Перед установкой компонента агент узнаёт, что ещё понадобится. Для выбора даты сервер назвал @angular/cdk/overlay и шесть соседних компонентов: button, calendar, field, input, input-group, popover.
Инструкцию по установке библиотеки сервер отдаёт целиком: настройку Tailwind, переменные цветов темы и команду ng g @spartan-ng/cli:ui, которая добавляет компоненты в проект.

Кто сделал: spartan.ng
Версия: 1.7.0
Проверено: 16.10.2026, Claude Code
Лицензия: MIT
Код: github.com/spartan-ng/spartan/tree/main/libs/mcp
Документация: spartan.ng/documentation/mcp

Подключить

Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.

Промпт для агента

Подключи MCP-сервер «Spartan UI» версии 1.7.0. Работай по шагам и после каждого коротко говори, что сделал.

Данные сервера (каталог smyslokod.ru, проверено 16.10.2026):
- имя в конфиге: spartan-ui
- официальный источник: https://github.com/spartan-ng/spartan/tree/main/libs/mcp
- запуск: npx -y @spartan-ng/mcp@1.7.0

Правила:
1. Не ставь Node.js, uv или Docker без моего «да». Не хватает - остановись и скажи, что поставить и откуда.
2. Ставь только пакет или адрес из этого промпта. Никаких установочных скриптов из README без моего подтверждения.
3. Перед правкой конфига сделай его резервную копию.

Шаги:
0. Определи, кто ты (Claude Code, Codex или другой агент) и какая у меня система.
1. Проверь окружение: node --version и npx --version (нужен Node.js 18 или новее). Скажи, что нашёл.
2. Проверь, нет ли уже сервера с таким именем: `claude mcp get spartan-ui` (в Codex: `codex mcp list`).
3. Подключи сервер:
   Claude Code: claude mcp add --scope user --env 'SPARTAN_MCP_CACHE_DIR=${SPARTAN_MCP_CACHE_DIR}' --transport stdio spartan-ui -- npx -y @spartan-ng/mcp@1.7.0
   Codex: добавь в ~/.codex/config.toml
      [mcp_servers.spartan-ui]
      command = "npx"
      args = ["-y", "@spartan-ng/mcp@1.7.0"]
      env_vars = ["SPARTAN_MCP_CACHE_DIR"]
      startup_timeout_sec = 30
   Если ты не Claude Code и не Codex, подключи способом, принятым у тебя, с той же командой запуска.
4. Проверка: `claude mcp list` (в Codex: `codex mcp list`), статус должен быть «Connected». Попроси меня перезапустить сессию. У сервера 17 инструментов, перечисли их. Сделай пробный запрос: «Через spartan-ui покажи свойства компонента dialog и один пример его кода». Покажи результат.
5. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove spartan-ui --scope user` (в Codex: `codex mcp remove spartan-ui`).

Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/mcp/spartan-ui#problemy

Выполнят Claude Code, Codex, Hermes и любой агент с доступом к терминалу.

Что нужно на компьютере: Node.js 18 или новее.

Ключ: не нужен.

Команда подключения: claude mcp add --scope user spartan-ui -- npx -y @spartan-ng/mcp@1.7.0, пакет приходит из реестра npm. Ключ и регистрация не нужны. Страницы компонентов, блоков и документации сервер скачивает с сайта www.spartan.ng и складывает на диск. Статью с dev.to для темы analog-dark-mode он не сохраняет. Папку задаёт переменная SPARTAN_MCP_CACHE_DIR, без неё берётся $XDG_CACHE_HOME/spartan-mcp, а если и этой переменной нет, то ~/.cache/spartan-mcp. Сохранённую страницу сервер по умолчанию считает свежей 24 часа, срок меняет переменная SPARTAN_CACHE_TTL_HOURS. Списки компонентов и блоков и строки команд зашиты в сам пакет, работу без интернета мы не проверяли. Минимальную версию Node.js автор не указал, мы запускали сервер на Node.js 22.

Проверь, что работает

Пробный запрос

Через spartan-ui покажи свойства компонента dialog и один пример его кода

Что должно получиться: Агенту здесь нужен spartan_components_get. Когда мы вызывали его напрямую через mcp-probe, пришли 7 частей Brain, 10 частей Helm и 10 примеров кода окна. Ответ самого агента мы не проверяли. Если в ответе нет вызовов spartan-ui, проверь командой /mcp, подключён ли сервер.

Что можно сделать

4 сценария

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

Промпт просит агента сначала забрать свойства и примеры окна. Сервер отдал 17 частей окна и 10 примеров кода, среди свойств HlmDialog есть closeOnOutsidePointerEvents. Само окно по этому промпту агент не собирал.

spartan_components_get с именем dialog и extract api отдаёт части Brain и Helm со свойствами.
С extract code тот же инструмент присылает фрагменты кода примеров.

Промпт

Через spartan-ui посмотри свойства компонента dialog и его примеры. Сделай в моём проекте на Angular окно «Удалить запись?» с кнопками «Отмена» и «Удалить», закрытие по клику мимо окна отключи.

Бесплатно: почта или сразу Телеграм-канал клуба

Совет. Повторный запрос той же страницы сервер может взять с диска: на прогоне первый вызов шёл 264 мс, второй, с пометкой CACHED DATA, 29 мс.

Таблица платежей с сортировкой и поиском

В нашем прогоне сервер прислал 26 фрагментов кода, первый из них уже таблица с типом Payment: сумма, статус и почта. В зависимостях пришли @tanstack/angular-table и шесть компонентов, от button до table. Как агент переделает пример под твои данные, мы не смотрели.

Код примеров отдаёт spartan_components_get, если передать data-table и extract code.
spartan_components_dependencies с includeTransitive показывает и зависимости соседних компонентов: на прогоне у button пришёл spinner, у checkbox field и label.

Промпт

Возьми через spartan-ui пример таблицы data-table и список её зависимостей. Собери в кабинете таблицу платежей: сумма, статус, почта, сортировка по сумме, поиск по почте, по 10 строк на странице.

Бесплатно: почта или сразу Телеграм-канал клуба

Поле для кода из СМС

Сервер вернул части BrnInputOtp и HlmInputOtpSlot со свойствами. У BrnInputOtp обязательная длина length, цифровая клавиатура inputMode numeric, а inputAutocomplete по умолчанию one-time-code. Как поле поведёт себя на телефоне, мы не проверяли.

Нужен один вызов: spartan_components_get, компонент input-otp, extract api.

Промпт

Через spartan-ui разбери свойства компонента input-otp. Добавь на экран входа поле для шестизначного кода из СМС, чтобы телефон сам подставлял код из сообщения.

Бесплатно: почта или сразу Телеграм-канал клуба

Совет. Имя компонента пиши латиницей через дефис, как на сайте, иначе сервер ответит ошибкой.

Поставить spartan/ui в проект Angular

На прогоне пришла страница установки целиком: настройка Tailwind, переменные цветов темы и команда ng g @spartan-ng/cli:ui. Строку проверки npx ng g @spartan-ng/cli:healthcheck --dry-run сервер только собрал и не запускал. Как агент сравнит это с твоим проектом, мы не смотрели.

Инструкцию даёт spartan_docs_get с темой installation; в формате text страница приходит целиком вместе с меню сайта.
spartan_health_instructions и spartan_health_command только отдают текст команды.

Промпт

Через spartan-ui возьми инструкцию по установке spartan/ui и команду проверки проекта. Расскажи по шагам, что поставить и что поменять в стилях моего проекта на Angular, и дай команду проверки с --dry-run. Пока ничего не меняй.

Бесплатно: почта или сразу Телеграм-канал клуба

Пример работы

редакция, прогон при проверке 16.10.2026

Задача: Собрать справку по окну и таблице spartan/ui для кабинета на Angular
Промпт: Через spartan-ui покажи свойства окна dialog, пример таблицы data-table и что нужно для выбора даты
Что сделал агент: spartan_components_list за 1 мс отдал 64 компонента со ссылками на spartan.ng.
Части окна dialog со свойствами, 17 штук, пришли за 264 мс, а повторный вызов взял страницу с диска за 29 мс.
Для data-table нашлось 26 фрагментов кода, первый с таблицей платежей.
Для date-picker сервер назвал @angular/cdk/overlay и шесть соседних компонентов.
Результат: Вызовы шли от 1 до 549 мс, ключ не понадобился, сервер ходил только на www.spartan.ng и, для одной темы, на dev.to. Инструменты вызывал mcp-probe, агент Claude Code этот промпт не выполнял.

Инструменты

17 · описания около 2,6 тыс. токенов

Жёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В Claude Code инструменты грузятся по запросу и почти не занимают память агента; в других клиентах и при своём адресе подключения (ANTHROPIC_BASE_URL) описания грузятся целиком на каждом сообщении.

Когда не нужен

Сервер не пригодится, если сайт собран без Angular или на другой библиотеке компонентов: справка у него только по spartan/ui. Если нужен один компонент, проще открыть его страницу на spartan.ng и дать агенту ссылку.

Частые проблемы

Готовый блок входа или бокового меню пришёл без кода

Сайт показывает блоки во встроенном окне, и в ответе сервера были только заголовки, например «A simple login form», и описания. Поиск зависимостей по блоку регистрации тоже вернул пустые списки. Собери блок из компонентов: попроси агента взять примеры нужных компонентов через spartan_components_get, или открой страницу блока на spartan.ng сам.

Проверка доступности выдала оценку, а разделы пустые

spartan_accessibility_check ищет слова на странице компонента. У Dialog вышло 66% с пустыми разделами про экранный диктор и WCAG, у Select пусты все разделы, а четыре совета одинаковы для любого компонента. Считай этот ответ подсказкой. Доступность проверяй на самой странице сайта, например через Lighthouse.

Попросил справку для старой версии, а пришла текущая

Параметр spartanVersion меняет только имя папки, где лежат скачанные страницы. Адрес на сайте от версии не зависит: по версии 1.0.0 пришла та же страница Button, что и без неё. Сверяй ответы с версией @spartan-ng/brain в package.json проекта. Сервер отвечает по тому, что сейчас опубликовано на сайте. К 16 октября 2026 года в npm лежит выпуск библиотеки 1.7.0.

Ответ Invalid component name на имя компонента

Сервер принимает только латинские имена через дефис, как на сайте. На «кнопка» пришла эта ошибка. Пусть агент сначала возьмёт список через spartan_components_list и выберет там имя, например dialog или data-table.

Агент не видит инструментов сервера

Клиент не перезапущен после подключения: Claude Code читает подключения при старте сессии. Закрой и открой сессию, потом проверь: claude mcp list.

«spawn npx ENOENT» при запуске

Клиент не видит npx: приложения с иконкой не читают PATH из настроек терминала. Пропиши полный путь к npx. Узнать его: which npx на Mac, where npx на Windows.

«Unsupported engine» или падение при старте

Старая версия Node.js. Нужна 18 или новее, проверить: node --version.

Codex: сервер не успевает запуститься

Codex ждёт запуска 10 секунд, а первый запуск npx скачивает пакет дольше. Во вкладке Codex уже стоит startup_timeout_sec = 30, возьми фрагмент оттуда.

Безопасность и данные

Кто сделал: spartan.ng (официальный). Исходный код: github.com/spartan-ng/spartan/tree/main/libs/mcp, лицензия MIT.
Что видит агент: Только то, что агент передаёт в вызов: имя компонента, блока или темы, имя версии и флаги. В адрес запроса на www.spartan.ng попадает имя страницы, сервер сайта стоит в Чехии, а тема analog-dark-mode идёт на dev.to, где страну мы не установили. Версия и флаги остаются на компьютере, по версии сервер только называет папку. В проверку страниц агент может вписать любой текст, и он уйдёт на сайт в адресе. Вместе с запросами сайты видят IP и технические данные соединения. Файлы проекта и разговор сервер не читает.
Куда уходят данные: Данные уходят: сайт www.spartan.ng на хостинге Zerops (Чехия); для темы analog-dark-mode dev.to, страна обработки не установлена, страна обработки не указана сервисом.
Что может изменить: Шесть инструментов пишут на диск: скачанные страницы и список версий ложатся в папку из SPARTAN_MCP_CACHE_DIR, $XDG_CACHE_HOME/spartan-mcp или ~/.cache/spartan-mcp. Ещё два удаляют сохранённые страницы: spartan_cache_clear стирает папку текущей версии или все папки версий, spartan_cache_rebuild стирает текущую и скачивает заново. Имя версии в коде проверяется: точка, две точки и косая черта не проходят, на прогоне ../../tmp сервер отклонил. Программ сервер не запускает.
Наша проверка: Пакет @spartan-ng/mcp выпускают авторы spartan/ui: страница MCP Server в документации на spartan.ng даёт команду подключения этого пакета, код лежит в папке libs/mcp репозитория spartan-ng/spartan, а версию 1.7.0 выложил в npm GitHub Actions из этого репозитория в тот же час, что и саму библиотеку. Лицензия пакета и репозитория MIT. Мы прочитали код 1.7.0: он не запускает программы, установочных скриптов в пакете нет, в сеть сервер ходит только на www.spartan.ng и к одной статье dev.to. Указания агенту в тексте есть. В описании spartan_components_get стоит «Always parse and present the API tables, code examples, and component specifications from the response», а в ответы сервер добавляет блок PROCESSING INSTRUCTIONS, например «Always present component options and APIs when helping users». Всё это просьбы показать данные человеку, просьб что-то скрыть, отправить или прочитать файлы и ключи мы не нашли. Пометок у инструментов автор не ставил, чтение, запись и удаление мы отметили сами, по коду. В одноразовой песочнице Ubuntu 24.04.5 на Node.js 22 было 35 вызовов всех 17 инструментов, ответы пришли за 1-549 мс. Через npx соединения шли к реестру npm, www.spartan.ng и dev.to, установленный пакет без сетевых инструментов не открыл ни одного. По базе OSV записей нет ни у пакета, ни у 94 пакетов его дерева, npm audit показал ноль. Версия в команде закреплена: npx -y @spartan-ng/mcp@1.7.0.
Версия: В командах закреплена версия 1.7.0: ставится ровно то, что мы проверили.
Проверить самому: агент прочитает код подключения как недоверенный

Полезные материалы

Журнал проверок

16.10.2026·1.7.0·Claude Code, Linux·работаетdd437ccc3e639f49

Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.

Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.