SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI营销工具brandsystem-mcp

brandsystem-mcp

brandsystem-mcp 是一个本地优先的 MCP 服务器，用于把品牌资料接入 AI 工作流。它可从网站、PDF、Figma 库、本地文件或 Brandcode Studio 品牌中提取品牌标识（颜色、字体、Logo、品牌声音、视觉规则），编译为可移植的 .brand/ 运行时，包含 DTCG 设计令牌、brand-runtime.json、interaction-policy.json 以及治理内容（反模式、证据点状态、语音规则、应用规则）。它支持内容合规评分与检查，让 AI 生成内容时具备品牌上下文，避免输出“正确但通用”。默认 Core 配置暴露 12 个工具，覆盖采用→使用→检查闭环；无需账号，本地运行，可通过 CLI 安装到 Claude Code、Cursor、Windsurf、Cline、Codex 等客户端。

访问官网

工具介绍

用途

AI 工具在没有品牌上下文时，默认输出“类别平均”内容。品牌指南通常散落在 PDF、Figma 文件和人员头脑中，AI 在创作时无法读取。brandsystem-mcp 解决的核心问题不是“输出损坏”，而是“正确但通用”——机械检查能通过，却像任何胜任的通用写手都能做出来。

该 MCP 服务器是“Two MCPs, One Brand”模型中的创作端（authoring half）。它从实时来源提取品牌标识，编译成带结构化治理的 .brand/ 目录，包含 DTCG 令牌、brand-runtime.json、interaction-policy.json 以及反模式、证据点状态、语音规则、应用规则等治理内容。.brand/ 目录是可移植的品牌运行时，随品牌在各接触面之间迁移。

主要能力

根据资料，服务器提供两套工具配置：

  • 默认 Core 配置：注册 12 个工具，覆盖完整闭环：adopt → runtime/context → create → check → export，外加 Studio 连接器入口和 clarify/promote 路径。Core 工具包括 brand_start、brand_status、brand_runtime、brand_context、brand_check、brand_preflight、brand_report、brand_export、brand_clarify、brand_compile、brand_brandcode_auth、brand_brandcode_connect。
  • full 配置：注册完整创作系统（所有工具）。可通过环境变量或参数选择，例如设置 BRANDSYSTEM_PROFILE=full。

按会话划分的能力：

  • Session 1 Core Identity：从网站或 Figma 文件提取颜色、字体和 Logo，编译为 DTCG 令牌、结构化设计合成层、可移植 DESIGN.md 和 HTML 报告。
  • Session 2 Visual Identity：通过引导式访谈定义构图规则、图案语言、插画风格和反模式。反模式成为可执行的合规规则。
  • Session 3 Messaging：审计现有网站语音，然后通过引导式访谈定义视角、语音法典（语气、词汇、AI 腔检测）和品牌故事。
  • Session 4 Content Strategy：构建买家画像、旅程阶段、编辑主题，以及画像 × 阶段的消息矩阵。

每个会话都建立在前一个之上，可以在任何阶段停止，Session 1 本身就有价值。

其他能力包括：

  • 内容评分与检查：brand_check、brand_preflight 等工具，brand_preflight 在任何内容生成后运行。
  • 运行时与实用工具：brand_runtime、brand_context、brand_export 等。
  • Brandcode Studio 连接器：brand_brandcode_connect 可将品牌保存到 Brandcode Studio，团队成员可将同一品牌拉入各自工具。

工具自动链式调用：每个工具的响应会告诉 LLM 下一步运行什么。brand_status 可在任何时间调用。

使用方式

资料提供了多种安装与使用路径：

  1. 添加到 MCP 配置。可复制到 .mcp.json（Claude Code）、.cursor/mcp.json（Cursor）或 Windsurf MCP 设置。Codex 用户可运行 npx @brandsystem/mcp install --client codex --write。
  2. 创建品牌系统。告诉 AI 工具运行 brand_start，例如 client_name="Acme Corp"、website_url="https://acme.com"、mode="auto"。该命令从网站提取颜色、字体和 Logo，当初步提取质量弱时会升级到渲染或多页深度提取，编译 DTCG 令牌，生成 design-synthesis.json + DESIGN.md，并生成可移植 HTML 品牌报告，全程在 60 秒内。
  3. 将 brand-runtime.json 加载到任何子代理的上下文中，首次输出即符合品牌，无需每次提示的样板内容。运行 brand_write 可为“Q3 产品发布”生成社交图形。
  4. 每个会话都会丰富 brand-runtime.json，可在任何点停止。
  5. 通过 brand_brandcode_connect 保存到 Brandcode Studio，品牌持久化，团队成员从各自工具拉取同一品牌。

CLI 入口点用于设置、诊断和托管品牌连接器。安装不会覆盖其他服务器的条目：它会深度合并、先备份现有文件，并拒绝无效 JSON。对于受保护的托管品牌，可添加 --share-token=TOKEN。

各客户端安装方式（资料列出）：

  • Codex：使用包安装器，委托给 Codex 官方 MCP 配置命令；安装后启动新的 Codex 任务。Codex CLI、Codex 应用和 IDE 扩展共享同一 MCP 配置。
  • Cline：使用包安装器，委托给 Cline 官方非交互式 MCP 命令；启动新的 Cline 任务后询问“How do I use my brand guidelines with AI?”。Cline CLI 和 IDE 扩展共享 ~/.cline/data/settings/cline_mcp_settings.json 的全局配置。
  • Claude Code：在项目根目录创建 .mcp.json。
  • Cursor：在项目根目录创建 .cursor/mcp.json。
  • Windsurf：创建 ~/.codeium/windsurf/mcp_config.json。
  • Claude Desktop：打开 Settings > Developer > Edit Config（claude_desktop_config.json）。

Claude Chat（无 MCP）路径：先在代码环境运行管道生成 brand-report.html，将 HTML 文件上传到 Claude Chat 对话，然后说“Use this as my brand guidelines for everything we create”。报告 HTML 是自包含的，可作为独立的品牌参考。

适用场景

  • 希望让 AI 生成内容符合品牌规范的设计、营销和内容团队。
  • 需要从网站、PDF、Figma 库或本地文件构建可移植品牌运行时的场景。
  • 希望将品牌指南作为上下文注入 Claude Code、Claude Desktop、Cursor、Windsurf、Cline、Codex 等工具的团队。
  • 需要内容合规评分和检查的场景。
  • 团队协作，通过 Brandcode Studio 共享单一品牌来源。

Claude Design 集成：.brand/ 目录被设计为 Claude Design 的一等输入。将 Claude Design 指向包含 .brand/ 的仓库（治理 YAML、叙事库、证据点文件、品味笔记、DTCG 令牌），它便基于受治理的品牌而非上传的资产即兴发挥。这是 Deploy 路径：用 @brandsystem/mcp 创作一次，然后每个 Anthropic 接触面（Claude Design、Claude Code、通过编译包的 Chat）消费同一运行时。

限制

  • Figma 提取不直接连接 Figma。它分两阶段：Plan 返回获取哪些数据（变量、样式、Logo）的说明；Ingest 处理从 Figma MCP 工具传回的数据。需要单独连接一个 Figma MCP 服务器（如 @anthropics/figma-mcp），并将获取的数据以 ingest 模式传给 brand_extract_figma。
  • brand_extract_web 只解析 <style> 块和最多 5 个链接样式表中的静态 CSS。如果网站通过 JavaScript 动态加载 CSS，可能提取为空。
  • 网站提取查找 <img>、<svg> 和 <link rel="icon"> 元素。如果 Logo 通过 JavaScript 渲染或作为 CSS 背景嵌入，需用 brand_set_logo 手动添加（SVG 标记、URL 或 data URI）。
  • 每个提取值都带置信度级别；同一品牌元素在多个来源出现时，优先级更高的来源胜出。Figma 来源的主色会替换网络提取的。手动确认的值覆盖两者。同一来源内，置信度更高者胜出。
  • 除 brand_start、brand_init 和 brand_feedback 外，每个工具都需要 .brand/ 目录。
  • 某些工具（brand_write、brand_deepen_identity）会返回超过 5K 字符的丰富对话指南，这是软警告；硬限制为 50K，会触发截断。
  • Brandcode MCP 为预发布状态，仅向获批准客户提供，尚未公开发布或列入注册表。托管服务上的品牌数据归客户所有；反馈为仅追加；代理历史受限并脱敏。删除和导出请求通过 Brandcode Studio 联系人处理。公开发布前，本地构建/同步使用 @brandsystem/mcp，连接读取使用 Live Mode（brand_brandcode_live），会在短缓存 TTL 内从托管运行时刷新。
  • 各客户端具体安装命令、代码片段、品牌报告 HTML 结构、.brand/ 目录完整文件清单等细节，资料中未逐一完整给出，暂未提供。

同类工具

查看分类