Brand-System/brandsystem-mcp

Brand-System/brandsystem-mcp

от brand-system
MCP-сервер создает портативный .brand рантайм - извлекает бренд-идентичность из сайтов, Figma и PDF, компилирует гайдлайны, токены и правила голоса. AI-инструменты используют этот рантайм для генер...

CI npm version Node brandsystem-mcp MCP server npm downloads MCP Badge

@brandsystem/mcp — Build

The authoring tool for the portable .brand runtime. Extract identity from websites, Figma, and PDFs. Compile governance, tokens, and voice rules into a single .brand/ directory. Deploy that runtime to Claude Design, Claude Code, Cursor, ChatGPT — every surface that can read a governed brand. One artifact, every surface on brand.

What It Solves

AI tools default to category-average output because they have no brand context. Brand guidelines live in PDFs, Figma files, and people's heads — none of which AI tools can read at the moment of creation. The dominant failure mode isn't "broken output"; it's "correct but generic" — output that passes mechanical checks but reads like a competent generalist could have made it.

This MCP server is the authoring half of the "Two MCPs, One Brand" model. It extracts brand identity from live sources, compiles it into a .brand/ directory with structured governance (anti-patterns, proof-point status, voice rules, application rules) plus DTCG tokens, brand-runtime.json, and interaction-policy.json. That directory is the portable brand runtime — the artifact that travels with your brand from surface to surface.

Инструменты были проиндексированы:
brand_brandcode_authвнешний мир

Активирует подключение к Brandcode Studio для сохранения и отправки брендов. Предпочтительный режим: «activate» показывает короткий код (например, BRAND-7K4X), который пользователь вводит на brandcode.studio/activate, без копирования токенов. Также поддерживает: «status» (проверка авторизации), «login» (запасной вариант с magic link), «set_key» (ручной ввод токена), «logout» (очистка учётных данных). Используйте, когда пользователь хочет сохранить свой бренд в Studio или говорит «activate», «connect to Brandcode» или «save my brand online». НЕ требуется для extraction, preview или brand_check, они работают без авторизации.

Аутентификация Brandcode Studio

Параметры
  • emailstring

    Адрес электронной почты для входа. Обязателен, когда mode="login".

  • keystring

    Токен сессии из проверки magic link. Обязателен, когда mode="set_key". Формат: JWT из /api/auth/verify.

  • modeenumобязательный

    Действие для аутентификации: "activate" (рекомендуется) запускает поток device code — показывает короткий код, который пользователь вводит на brandcode.studio/activate, затем опрашивает сервер до завершения. Копировать и вставлять ничего не нужно. "status" проверяет, выполнен ли вход. "login" запускает поток magic link (запасной вариант). "set_key" сохраняет токен вручную. "logout" удаляет учетные данные.

  • studio_urlstring

    Базовый URL Brandcode Studio. По умолчанию используется https://brandcode.studio. Переопределите для собственных инстансов.

brand_brandcode_connectвнешний мир

Подключает локальный .brand/ к Brandcode Studio. Два режима: "pull" (по умолчанию) скачивает существующий размещённый бренд по URL/slug. "save" загружает локальный .brand/ в Studio (требует предварительной авторизации через brand_brandcode_auth). ИМЕННО этот инструмент используется, когда пользователь говорит "сделай наш бренд доступным для всей моей команды", "поделись нашим брендом с командой", "подключись к Brandcode", "скачай из Studio", "сохрани бренд в Studio" или "загрузи мой бренд". Возвращает название бренда, slug, sync token и данные о подключении.

Подключается к Brandcode Studio.

Параметры
  • modeenum

    "pull" подключается к существующему размещённому бренду и скачивает его. "save" загружает локальный .brand/ в Studio (требуется авторизация через brand_brandcode_auth).

  • share_tokenstring

    Поделиться токеном для защищенных брендов (x-brand-share-token)

  • urlstring

    URL или slug бренда Brandcode Studio. Обязательно для mode="pull". Примеры: "https://brandcode.studio/start/brands/pendium", "pendium"

brand_checkтолько чтениеидемпотентный

Встроенный линтер бренда - вызывайте его ВО ВРЕМЯ написания контента или кода, так же как вызываете проверку типов. Проходит/не проходит за <50 мс для любой комбинации текста (голос/никогда-не-говорить/AI-измы), цвета (соответствие палитре с расстоянием ΔE), шрифта (соответствие типографике) или CSS (нарушения антипаттернов). Разработан для плотных циклов: напишите предложение, проверьте его с помощью brand_check, исправьте, продолжайте. Возвращает конкретные исправления для каждого не прошедшего проверку входного значения. Требует, чтобы сначала был запущен brand_compile. НЕ является шлюзом перед публикацией - используйте brand_check_compliance для получения единого вердикта ПРОШЁЛ/НЕ ПРОШЁЛ перед отправкой. НЕ для оценки от 0 до 100 - используйте brand_audit_content. НЕ для нарушений правил HTML/CSS - используйте brand_preflight.

Быстрая проверка бренда

Параметры
  • colorstring

    Шестнадцатеричный цвет для сверки с фирменной палитрой. Возвращает ближайший фирменный цвет с перцепционным расстоянием (ΔE). Пример: "#3b82f6"

  • cssstring

    CSS-фрагмент для проверки нарушений визуальных антипаттернов (тени, градиенты и т.д.). Пример: "box-shadow: 0 2px 4px rgba(0,0,0,0.1)"

  • fontstring

    Имя семейства шрифтов для проверки на соответствие фирменной типографике. Пример: "Helvetica"

  • textstring

    Here's how "We leverage cutting-edge AI solutions" breaks down, plus a framework for catching these violations in general. --- Example analysis: | Phrase | Violation type | Why | Better alternative | |--------|---------------|-----|-------------------| | "leverage" | Never-say word / corporate jargon | Overused to the point of meaninglessness; reads like boilerplate business-speak | "use," "employ," "apply" | | "cutting-edge" | AI-ism / cliché | A stock phrase that AI and marketing copy lean on heavily; adds no specific information | "advanced," "latest," "recent," or name the actual technology | | "solutions" | Anchor term misuse / vague filler | Often used as a catch-all noun; if you mean a specific product or tool, say so | "tools," "products," "systems," or the concrete name | The full sentence could become: "We use advanced AI tools" — or even better, "We use [specific tool/model/approach]" with a concrete detail. --- Framework for checking voice violations: 1. Never-say words (ban list) Words that are vague, overused, or sound like corporate filler. Examples: - leverage, utilize, synergize, optimize (when overused) - cutting-edge, state-of-the-art, world-class, best-in-class - robust, seamless, scalable (when not technically precise) - granular, holistic, actionable, impactful 2. Anchor term misuse Using a term that has a precise meaning (technical, legal, domain-specific) in a loose or incorrect way. Examples: - Calling a simple script a "framework" - Using "quantum" or "AI" as buzzwords when the tech doesn't qualify - Misusing brand names or version numbers (e.g., "Google" when you mean "search engine") - Using "solutions" when you mean a specific feature 3. AI-isms Phrases that AI-generated text leans on because they're statistically common in training data. Examples: - "It's important to note that…" - "In today's fast-paced world…" - "Delve into," "unlock," "drive," "foster" - "Not only… but also…" - "Plays a crucial role in…" - "A myriad of," "plethora of" Quick test: If a phrase sounds like it could appear in a press release, a LinkedIn motivational post, or a generic corporate website — cut it and say what you actually mean in plain words. --- If you have a longer text you'd like me to check, paste it and I'll flag every violation with a suggested fix.

brand_clarify

Разрешает неоднозначное значение бренда в интерактивном режиме. После brand_compile некоторые значения требуют подтверждения человеком: неверный основной цвет, неизвестный шрифт, неназначенные цветовые роли. Передайте ID элемента уточнения и ответ пользователя (шестнадцатеричный цвет, имя роли, название шрифта или 'да'/'нет'). Поддерживает естественный язык: 'фиолетовый - акцентный' или '#5544f2 - вторичный'. Возвращает обновлённую идентичность и оставшееся количество уточнений.

Проясняет ценности бренда.

Параметры
  • answerstringобязательный

    Ответ пользователя: hex-цвет (#ff0000), имя роли (primary, secondary, accent, neutral, surface, text, action, tint, overlay, border, gradient, highlight), имя шрифта, «да»/«нет» или естественный язык («фиолетовый — акцентный, розовые прозрачные — оттенок»)

  • idstringобязательный

    ID пункта уточнения из needs-clarification.yaml (например, 'clarify-1')

brand_compileидемпотентный

Генерирует дизайн-токены DTCG, design-synthesis.json, DESIGN.md, бренд-рантайм и политику взаимодействия из извлечённых данных бренда. Преобразует core-identity.yaml в tokens.json, brand-runtime.json (бренд-контракт в одном документе для ИИ-агентов) и interaction-policy.json (правила, обязательные к исполнению). Когда есть данные Session 2+, также генерирует visual-identity-manifest.md и system-integration.md. Используйте после brand_extract_web, brand_extract_site, brand_extract_visual или brand_extract_figma. Возвращает количество токенов, уточняющие вопросы и список файлов.

Компилирует бренд-токены.

Параметры

Без параметров.

brand_contextтолько чтениеидемпотентный

Выбирает контекст бренда для конкретной задачи из скомпилированного рантайма. ИМЕННО этот инструмент вызывают первым, когда пользователь говорит: «напиши это нашим голосом», «напиши этот пост в LinkedIn в голосе нашего бренда», «сделай социальную графику в стиле бренда» или «собери лендинг»: он возвращает только регламентированные правила, относящиеся к этой задаче, вместо всего рантайма. Детерминированный: task_type сопоставляется с разделами через фиксированную таблицу, аудитория точно сопоставляется с регламентированными персонами или возвращает no-match - без умозаключений. Возвращает context (выбранные срезы бренда), output_contract (требуемый формат результата), matched_selectors (что было выбрано и почему) и no_governed_match. НЕ для чтения всего рантайма (используйте brand_runtime) или проверки готового контента (используйте brand_check).

Получает контекст бренда, ограниченный текущей задачей.

Параметры
  • audiencestring

    Необязательная метка аудитории (например, «лидеры безопасности»). Сопоставляется с управляемыми персонами по нормализованной подстроке — при отсутствии совпадения возвращается явный отказ, а не предположение.

  • budgetenum

    'standard' возвращает выбранные разделы полностью. 'compact' возвращает только фирменные цвета, типографику и жесткие правила (анти-паттерны + never_say) - для ограниченных контекстов под-агентов.

  • channelstring

    Необязательная метка канала (например, 'LinkedIn'). Записывается в matched_selectors для агента; не изменяет управляемые правила.

  • task_typeenumобязательный

    Что создаётся. Детерминированно выбирает разделы выполнения: визуальные задачи (code-ui, image-graphic) получают identity+visual; текстовые задачи (blog-article, email, video-script) получают voice+strategy; смешанные задачи получают и то, и другое.

brand_exportидемпотентный

Собирает скомпилированную бренд-систему в переносимый артефакт для конкретного места назначения. Используйте, когда просят «share my brand», «export for ChatGPT/Cursor/team», «generate brand guidelines», «make a one-pager» или «create a brand PDF». Цель 'chat': самодостаточный Markdown для загрузки в любой AI-диалог (Claude, ChatGPT, Gemini). Цель 'code': конфиг MCP-сервера + сниппет CLAUDE.md/.cursorrules. Цель 'team': понятные людям рекомендации по бренду для дизайнеров, авторов и маркетологов. Цель 'email': резюме примерно на 500 слов для Slack или письма. Цель 'claude-skill': SKILL.md со встроенным логотипом и правилами для постоянных артефактов Claude. Цель 'pdf': фирменный PDF с образцами цветов, типографикой, антипаттернами и голосом. Установите include_logo=false, чтобы убрать встроенный SVG/data URI, если важен размер. Записывает результат в .brand/exports/<file> и возвращает полное содержимое (для целей markdown) или сводку о создании (для pdf). Требует, чтобы сначала был запущен brand_compile. НЕ для предпросмотра отдельного раздела, используйте brand_preview.

Экспортирует брендбук.

Параметры
  • include_logoboolean

    Встраивайте логотип SVG/data URI в экспорт. Установите false, чтобы уменьшить размер файла. По умолчанию: true.

  • targetenumобязательный

    Где будет использоваться этот экспорт. 'chat': загрузить в диалог с ИИ (Claude/ChatGPT/Gemini). 'code': вставить в CLAUDE.md или .cursorrules. 'team': поделиться с дизайнерами/писателями. 'email': отправить через Slack или email. 'claude-skill': постоянный файл навыка Claude с встроенным логотипом и правилами бренда. 'pdf': PDF-руководство по бренду с образцами цветов, типографикой, визуальными правилами и сводкой по голосу - браузер не нужен.

brand_preflightтолько чтениеидемпотентный

Проверяет HTML/CSS на соответствие брендовым правилам: выявляет цвета, не соответствующие бренду, неправильные шрифты, отсутствие логотипа и нарушения антипаттернов (тени, градиенты и т.д.). Передайте HTML-строку или путь к файлу. Режим 'check' (по умолчанию) выполняет все проверки соответствия и возвращает pass/warn/fail по каждому правилу. Режим 'rules' перечисляет все активные правила preflight без проверки содержимого. Используйте после генерации любого визуального контента для проверки соответствия бренду. Возвращает общий статус и детали по каждой проверке. НЕ для оценки текстового контента. Используйте brand_audit_content. НЕ для проверки каталога брендов. Используйте brand_audit.

Предварительная проверка бренда

Параметры
  • htmlstringобязательный

    HTML для проверки: либо полная строка HTML (с блоками <style>), либо путь к файлу, заканчивающийся на .html (например, 'output.html')

  • modeenum

    «check» (по умолчанию): проверяет HTML на соответствие всем правилам бренда. «rules»: перечисляет все активные правила без запуска проверок.

brand_reportидемпотентный

Генерирует портативный HTML-отчёт о фирменном стиле со встроенными логотипами, образцами цветов, типографикой и токенами. HTML-файл автономен и работает офлайн: загрузите его в любой AI-чат (Claude, ChatGPT, Gemini) как готовые бренд-гайдлайны. Записывается в .brand/brand-report.html. Используется после brand_compile. Возвращает путь к файлу, сводку отчёта (количество цветов/шрифтов/логотипов) и готовый к копированию текстовый блок Brand Instructions.

Генерирует отчёт о бренде.

Параметры

Без параметров.

brand_runtimeтолько чтениеидемпотентный

Читает скомпилированный контракт бренд-рантайма (brand-runtime.json). Возвращает бренд-систему, которую AI-агенты загружают как контекст для вывода в фирменном стиле. Поддерживает срезы: 'full' (~1200 токенов, всё), 'visual' (~200 токенов, цвета + шрифты + анти-паттерны), 'voice' (~400 токенов, тон + лексика + перспектива), 'minimal' (~100 токенов, основной цвет + шрифт заголовков). Используйте срезы при передаче бренд-контекста субагентам: меньший контекст снижает расход токенов и сатисфицинг агентов. Учитывает Live Mode: при включении через brand_brandcode_live рантайм обновляется из размещённого Brandcode-рантайма при каждом вызове (с учётом TTL кэша). При ошибке сети незаметно переключается на локальное зеркало. Только для чтения. Запустите brand_compile для обновления.

Читает рантайм бренда.

Параметры
  • sliceenum

    Какой срез рантайма вернуть. 'full': всё (~1200 токенов). 'visual': цвета, типографика, логотип, антипаттерны, композиция (~200 токенов). 'voice': тон, словарный запас, чего избегать, перспектива (~400 токенов). 'minimal': основной цвет, шрифт заголовков, только ссылка на логотип (~100 токенов). Используй срезы, чтобы уменьшить размер промпта при передаче субагентам, которым нужна только часть бренда.

brand_startидемпотентныйвнешний мир

Переносит бренд в портативный рантайм .brand/ из любого уже имеющегося источника: брендбуков (PDF), URL веб-сайта, библиотеки Figma или бренда, размещённого в Brandcode Studio. Это ГЛАВНАЯ точка входа, когда пользователь говорит: 'use my existing brand guidelines with AI', 'I have a PDF brand guide', 'use our Figma library', 'create a brand system', 'extract brand from website' или 'set up brand guidelines'. Передайте website_url, guideline_pdf, figma_file_key или brandcode_url, либо не передавайте ни одного источника, и инструмент сам найдёт локальных кандидатов и покажет меню с пояснением о приватности. Установите mode='auto' вместе с website_url, чтобы запустить весь конвейер (извлечение, компиляция DTCG-токенов + design-synthesis.json + DESIGN.md + brand runtime + interaction policy, генерация HTML-отчёта) одним вызовом. Если .brand/ уже существует, возвращает текущий статус и дальнейшие шаги. НЕ для чтения уже скомпилированного бренда (используйте brand_runtime или brand_context) и не для того, чтобы поделиться существующим брендом с командой (используйте brand_brandcode_connect).

Запускает бренд-систему.

Параметры
  • brandcode_urlstring

    Brandcode Studio — URL для подключения существующего размещённого бренда (например, 'https://brandcode.studio/start/brands/acme'). Подключение выполняется через brand_brandcode_connect.

  • client_namestringобязательный

    Название компании или бренда (например, «Acme Corp»)

  • figma_file_keystring

    Ключ файла Figma для извлечения дизайн-файлов. Направляет внедрение через brand_extract_figma.

  • guideline_pdfstring

    Путь к PDF-файлу с брендбуком в рабочей директории или под ней (например, './brand-guidelines.pdf'). Передаёт обработку через brand_extract_pdf.

  • industrystring

    Отраслевая вертикаль для более умного извлечения (например, 'финтех', 'здравоохранение', 'контент-маркетинг')

  • modeenum

    «auto» (рекомендуется): запускает полный конвейер одним вызовом, когда указан website_url. «interactive»: оценивает доступные источники (включая файлы, обнаруженные в рабочей директории) и показывает меню источников.

  • website_urlstring

    URL веб-сайта компании для извлечения идентичности бренда (например, 'https://acme.com')

brand_statusтолько чтениеидемпотентный

Проверяет состояние бренд-системы и возвращает следующие шаги. Показывает, что извлечено (цвета, шрифты, логотип), уровни уверенности, статус завершения сессии и что делать дальше. Используется при возобновлении предыдущей сессии, проверке готовности или когда пользователь спрашивает: «В каком состоянии мой бренд?» Если .brand/ не существует, возвращает полное руководство по началу работы со всеми доступными инструментами. Возвращает структурированные данные о состоянии.

Статус бренда

Параметры

Без параметров.

Похожие MCP-сервера

vkhanhqui/figma-mcp-go

vkhanhqui/figma-mcp-go

Открытый Figma MCP-сервер с полным доступом на чтение и запись через плагин. Не требует API и не имеет лимитов — подходит дизайнерам и разработчикам. Работает с AI-инструментами. Управляйте стилями...

Go1178
velyan/pdf-card-mcp

velyan/pdf-card-mcp

PDF Card MCP — локальный MCP сервер и инструмент, который превращает плотные PDF в портативные HTML-читалки с привязкой к страницам. Сохраняет текст, обрезает таблицы, фигуры и формулы, извлекает стили из PDF. Идеален для чтения, цитирования и заметок — всё работает офлайн без облачных сервисов.

Python2
mhmzdev/Figma-Flutter-MCP

mhmzdev/Figma-Flutter-MCP

Figma to Flutter MCP Server извлекает дизайн-данные из Figma (компоненты, стили, макеты) и передает их в AI-агент для генерации Flutter-кода. Ускоряет реализацию интерфейсов, работает в Cursor и др...

TypeScript244
Custodia-Admin/pagebolt-mcp

Custodia-Admin/pagebolt-mcp

PageBolt MCP сервер открывает AI-ассистентам браузерную веб-автоматизацию: скриншоты, PDF и запись демо-видео. Также инспектирует страницы и создаёт OG-картинки. Просто опишите задачу — сервер выполнит.

JavaScript4
LeonTing1010/tap

LeonTing1010/tap

Taprun — MCP сервер для локальной автоматизации браузера: AI компилирует детерминированный .plan.json, а сервер воспроизводит его вечно с нулевыми затратами токенов. Куки и сессии остаются в вашем ...

JavaScript17
Browserbase MCP

Browserbase MCP

официальный

MCP сервер облачной автоматизации браузера Browserbase. Позволяет AI-агентам навигировать по сайтам, извлекать данные и выполнять действия. Полезен для RPA и веб-скрапинга. Доступен self-hosted и hosted.

TypeScript3404
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин