aurum-mcp

Взаимодействуйте с дизайн-системой Aurum из вашего LLM-клиента. Компоненты · токены · иконки · ID узлов Figma · журнал изменений — всё доступно для запросов из Claude Code, Cursor, Copilot CLI, Gemini и Claude Desktop.

aurum-mcp — это сервер Model Context Protocol, который предоставляет LLM доступ к каталогу дизайн-системы Aurum. Он считывает объединенный JSON-манифест (автоматически синхронизируемый с changejarapp.github.io/aurum-android) и предоставляет 9 инструментов, которые LLM может вызывать для ответов на вопросы, такие как:

• «Покажи мне, как использовать AurumChip.»

• «Какой токен цвета у нас есть для текста с негативной обратной связью?»

• «Какой узел Figma у AurumTopAppBar?»

• «Дай мне иконку стрелки назад.»

• «Что изменилось в последнем релизе?»

Установка (одна вставка для любого клиента)

Выберите свой клиент ниже, вставьте фрагмент в соответствующий файл конфигурации, перезапустите клиент.

Claude Code (.mcp.json в корне вашего проекта или ~/.claude.json)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Copilot CLI (~/.copilot/mcp.json)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Gemini CLI (~/.gemini/settings.json в разделе mcpServers)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

Та же структура — добавьте фрагмент выше в mcpServers. Перезапустите приложение.

Это всё. Никакого npm-реестра, никакого ~/.npmrc, никаких PAT, никаких переменных окружения. Публичный Git, публичный npx.

Версионирование

Фрагмент по умолчанию использует #latest-stable — управляемый CI Git-тег, который всегда указывает на новейший стабильный релиз. Работает как dist-tag @latest в npm: вы получаете автоматические обновления при каждом промахе кэша npx (~10 минут до нескольких часов, в зависимости от кэша вашего клиента).

Для воспроизводимости — автоматизированные скрипты, аудируемые настройки — фиксируйте версию на конкретном теге:

"args": ["-y", "github:atri-jar/aurum-mcp#v0.1.0"]

Каждая версия aurum-mcp поставляется с манифестом из соответствующей версии библиотеки Aurum (@aurum-mcp:0.1.6 ⇄ aurum:0.1.6). Вызовите get_aurum_version из вашего LLM-клиента, чтобы увидеть, с какой версией вы работаете.

Инструменты

См. docs/tools.md для получения полных схем ввода и примеров ответов.

Почему npx-из-Git, а не npm?

Мы рассмотрели три канала распространения (публичный npm, GitHub Packages, npx-из-Git) и выбрали третий, потому что для внутреннего инструмента команды, оптимизирующего простоту, полное владение и отсутствие новой инфраструктуры:

• Никаких новых учетных записей для управления. Нет организации npm, нет ротации NPM_TOKEN, нет восстановления 2FA, нет беспокойства о 72-часовой постоянной публикации. Репозиторий И ЕСТЬ артефакт, от начала до конца.

• Тестирование на основе веток бесплатно. Хотите попробовать ветку с фичей? Просто измените фрагмент на #feat/branch-name — готово. С npm вам пришлось бы публиковать пре-релизный тег, который останется в реестре навсегда.

• Та же авторизация, что уже есть у пользователей. Этот репозиторий публичный; члены команды имеют доступ к GitHub; ничего нового настраивать не нужно.

• Минимальная задержка установки. Первый запуск — это ~5–10 с клонирования + сборки против ~2–5 с для npm. Кэшированные запуски идентичны.

Компромиссы, на которые мы идем: менее отточенный UX фиксации версий (Git-теги против диапазонов semver) и отсутствие обнаруживаемости в публичном npm. Полное обоснование находится в docs/architecture.md.

Локальная разработка

git clone https://github.com/atri-jar/aurum-mcp.git
cd aurum-mcp
pnpm install
pnpm dev          # run the server via tsx + stdio
pnpm inspect      # spawn the official MCP Inspector UI
pnpm build        # tsc → dist/
pnpm smoke        # end-to-end tools/list + tools/call test

Сервер считывает data/manifest.json (закоммиченный). Чтобы получить последний манифест из живой галереи Aurum и обновить объединенную копию:

make manifest-fetch

CI делает это автоматически (см. .github/workflows/sync-manifest.yml).

Архитектура в одном абзаце

Дизайн-система Aurum находится в Changejarapp/aurum-android (приватный) и предоставляет публичную галерею по адресу changejarapp.github.io/aurum-android. Ее скрипт tooling/gallery/generate.py агрегирует компоненты, токены, иконки, маппинги Code Connect и журнал изменений из единого набора парсеров. Мы добавили флаг --emit-manifest, который создает структурированную JSON-проекцию тех же данных — контракт находится в tooling/manifest/schema.json в aurum-android. Этот MCP-сервер является стороной чтения JSON: он загружает манифест при запуске, индексирует его и обслуживает 9 инструментов, описанных выше. Один источник истины, две цели рендеринга (HTML для людей, JSON для агентов). Когда выйдет aurum-ios, его манифест будет подключен как дочерний источник — код MCP платформо-независим.

Полная диаграмма конвейера: docs/architecture.md.

Вклад в проект

Проблемы и PR приветствуются. См. docs/contributing.md для рабочего процесса (синхронизация манифеста, проверка на отклонения, процесс релиза). Стиль кода: TypeScript strict, настройки Prettier по умолчанию; никакой бизнес-логики в форматтерах markdown.

Лицензия

MIT — см. LICENSE.