Brandsystem MCP

社区

将现有品牌指南转化为AI可用的便携式品牌运行时。

分类: 开发工具第 95 / 438
Stars: ★ 15 热门
传输方式: stdio（本地进程）
运行环境: Node.js 20.18.1+
凭据: 可选 API Key
许可证: MIT
最近提交: 57 天前
工具数: 33

62FMRS · C

Brandsystem MCP 提供了一套全面的品牌管理工具，使 AI 代理能够遵循品牌指南。它支持从网站、Figma 等提取品牌要素，生成设计令牌和品牌运行时，并提供检查、审核和合规功能。它特别适合需要将品牌系统集成到 AI 工作流中的设计和开发团队。但需注意其提取的准确性依赖于算法，可能需要人工介入，以及可能的配置复杂度。

最强项 · 安装易用性 14/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

12/20

文档质量

14/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: README 声称有 CI 徽章、测试目录（9 个库测试、2 个工具测试、server 冒烟测试）和 eval 框架，但静态审查无法验证这些测试实际覆盖关键路径；manifest 与 npm 包版本一致（0.16.1），stdio 传输、Node >= 20.18.1、5K/50K 截断限制、错误路径（空提取、Figma 依赖外部 MCP）均有记录，属于可信但未经执行验证的声明。按静态规则上限 12 以内，取 10：声称的测试与错误处理充分但未提供可核查的执行证据。
安全与权限 12/20: 无恶意行为迹象：本地优先，网络活动仅限用户指定的抓取、可选 Brandcode 连接器与 brand_feedback；凭据存于 .brand/brandcode-auth.（gitignore）；托管侧为只读/追加式、bearer-key 鉴权、capture 需显式 scope，install 默认 dry-run 需 --write 且会备份合并。扣分点：凭据权限细节未展示，远程托管服务预发布且需批准，数据流边界主要靠 README 自述而非代码证据。
维护活跃度 12/20: MIT 许可、SECURITY.md 私密漏洞报告渠道、CI 徽章、npm 版本推进到 0.16.1、specs/ 与 eval/ 目录显示持续工程化。扣分点：静态材料未见发布节奏、依赖更新策略与 issue 响应证据；14 个 open issues 对 10 星的比例缺乏响应说明；托管部分未公开。
文档质量 14/20: 文档分层充分：平台安装、CLI、工具参考、.brand 目录文件明细、置信度与来源优先级模型、故障排查（空提取、Figma、logo、5K 限制、启动失败）、eval 方法论均有覆盖，并披露限制（静态 CSS 解析局限、托管预发布）。扣分点：成本/配额信息缺失，工具参数细节需看代码，Claude Design 集成等声明无独立证据。
安装易用性 14/20: 安装路径清晰：npx install 支持多客户端（Claude Code/Cursor/Windsurf/Cline/Codex/Claude Desktop）并附 .mcp. 示例，默认 dry-run、deep-merge 备份，doctor/inspect 诊断命令降低故障成本。扣分点：静态规则下未验证安装实际可用；Figma 流程依赖额外 MCP 服务器、headless Chrome 依赖为隐含前提，增加配置复杂度。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络控制浏览器

适合谁

需要在 AI 内容生成中保持一致品牌标识的设计团队。
希望自动化品牌指南提取和令牌编译的开发人员。
使用 Claude Code、Cursor 等工具的团队。
需要管理品牌资产的营销专业人员和内容创建者。

不适合谁

不需要品牌管理的通用 AI 任务。
只想运行托管品牌服务的用户（可能更适合 @brandcode/mcp）。
依赖 Figma 直接集成，而不需要额外 Figma MCP 服务器的用户。
没有 Node.js 20+ 环境或不想安装本地服务器的用户。

所需权限

读取您指定网站的 HTML/CSS/截图（需访问网络）。
读取本地文件系统并写入 .brand 目录（在项目目录内）。
连接托管 Brandcode Studio 时访问认证凭据（存储在 .brand/brandcode-auth.json）。
发送可选反馈到品牌团队。

风险与副作用

需要与远程网站通信，可能触及版权或隐私问题。
提取的数据基于算法推断，可能存在不准确，需要人工审查。
Figma 提取需要额外的 Figma MCP，可能引入配置复杂性。
默认核心配置仅暴露 12 个工具，完整功能需要切换到完整配置文件。

安装接入

准备工作

运行环境：Node.js 20.18.1+

ANTHROPIC_API_KEY 可选密钥仅运行仓库内模型依赖的评估套件（首工具选择测试）时需要，从 Anthropic 控制台获取；日常使用本服务器不需要。

其他可选配置项（2 个）

BRANDSYSTEM_PROFILE 可选可选，设为 full 以注册全部工具，默认 Core 配置只注册 12 个工具；也可通过 --profile=full 参数设置。

BRANDCODE_MCP_SMOKE_URL 可选仅供维护者运行托管部署冒烟测试（npm run smoke:hosted-mcp）时设置的目标 URL；普通用户无需设置。

在项目根目录创建 .mcp.json 文件（Claude Code）或 .cursor/mcp.json（Cursor），或使用命令行工具安装。

{
  "mcpServers": {
    "brandsystem": {
      "command": "npx",
      "args": ["-y", "@brandsystem/mcp"]
    }
  }
}

对于 Codex、Cline 等，使用 npx @brandsystem/mcp install --client <client> --write 自动配置。
确保 Node.js 版本 >= 20.18.1。

claude_desktop_config.json

{
  "mcpServers": {
    "brandsystem": {
      "command": "npx",
      "args": [
        "-y",
        "@brandsystem/mcp"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "brandsystem": {
      "command": "npx",
      "args": [
        "-y",
        "@brandsystem/mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add brandsystem -- npx -y @brandsystem/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置 npx -y @brandsystem/mcp 后，工具列表中应出现 brand_start、brand_runtime 等工具；运行 brand_status，若尚无 .brand/ 目录应返回入门指引，即证明连接成功。

常见排障

如果未找到 .brand 目录，请先运行 brand_start。
如果提取没有颜色或字体，可能是动态网站，尝试 brand_extract_visual 或 brand_extract_site。
如果 Figma 提取失败，确认已连接单独的 Figma MCP 服务器。
如果徽标未检测到，使用 brand_set_logo 手动添加。
如果服务器无法启动，检查 Node.js 版本（>=20.18.1）并运行 `npx @brandsystem/mcp doctor`。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 brand_start 以 client_name="Acme Corp"、website_url="https://acme.com"、mode="auto" 创建一个品牌系统
运行 brand_extract_visual 分析这个 JS 渲染的网站，然后运行 brand_compile 生成设计令牌
为一个“Q3 产品发布”的社交图运行 brand_write，并按我的品牌规范输出
用 brand_check_compliance 检查这篇草稿是否符合品牌规范，并用 brand_report 生成一份可分享的 HTML 品牌报告

工具能力 33

brand_start 写入

开始建立品牌系统，从网站 URL 在 60 秒内创建品牌，支持自动模式。

brand_status 只读

检查进度、获取下一步操作，若无品牌则提供入门指南。

brand_extract_web 写入

从任何网站 URL 提取徽标、颜色和字体。

brand_extract_visual 写入

通过无头浏览器截图并提取计算样式，适用于 JS 重网站。

brand_extract_site 写入

发现代表性页面，跨桌面和移动端渲染并收集证据，支持生成设计摘要。

brand_extract_figma 写入

从 Figma 设计文件中提取品牌数据，分两阶段：计划和摄取。

brand_set_logo 写入

通过 SVG 标记、URL 或数据 URI 手动添加或替换徽标。

brand_compile 写入

编译 DTCG 设计令牌、品牌运行时契约和交互策略。

展开其余 25 个工具

brand_clarify 写入

交互式解决品牌值中的歧义。

brand_audit 只读

验证 .brand 目录的完整性和正确性。

brand_report 写入

生成便携式 HTML 品牌报告，可粘贴到任何 AI 聊天。

brand_init 写入

低层目录脚手架，优先使用 brand_start。

brand_deepen_identity 写入

定义构图规则、模式、插画风格和反模式（6 个访谈部分）。

brand_ingest_assets 写入

扫描并编目品牌资产，生成 MANIFEST.yaml 元数据。

brand_preflight 只读

检查 HTML/CSS 是否符合品牌规则：颜色、字体、反模式违规。

brand_extract_messaging 写入

审计现有网站声音：指纹、词汇、声明、AI 痕迹、差距。

brand_compile_messaging 写入

定义视角、声音代码库（语气、词汇）和品牌故事。

brand_build_personas 写入

通过 7 个问题引导访谈构建买家画像。

brand_build_journey 写入

定义买家旅程阶段，内置 4 个默认阶段。

brand_build_themes 写入

定义编辑内容主题，平衡认知、互动和转化。

brand_build_matrix 写入

为每个画像 x 旅程阶段组合生成消息变体。

brand_audit_content 只读

按品牌规则对内容进行 0-100 评分。

brand_check_compliance 只读

发布前的快速通过/失败合规门禁。

brand_audit_drift 只读

在多个内容中检测系统性品牌漂移。

brand_runtime 只读

读取编译后的品牌运行时契约（单文档品牌上下文）。

brand_context 只读

按任务类型、受众有选择地获取运行时切片，无匹配时明确告知。

brand_write 只读

加载完整品牌上下文（视觉、声音、策略）以生成内容。

brand_export 写入

为聊天、代码、团队共享或电子邮件生成便携式品牌文件。

brand_feedback 破坏性

向团队报告错误、摩擦或功能想法。

brand_brandcode_connect 写入

连接本地 .brand 目录到托管品牌并拉取当前包。

brand_brandcode_sync 写入

从已连接的托管品牌拉取更新，带增量同步。

brand_brandcode_status 只读

检查当前 Brandcode Studio 连接和同步历史。

brand_brandcode_live 写入

切换连接读取工具，在短缓存 TTL 内从托管运行时刷新。

使用场景

从网站快速提取品牌颜色、字体和徽标。

从 Figma 设计库导入品牌令牌。

为内容生成 AI 定义品牌声音和反模式。

在发布前检查内容是否符合品牌规则。

创建便携式品牌报告供团队和 AI 工具共享。

连接 Brandcode Studio 以同步和维护单一事实来源。

支持客户端

Claude Desktop

Claude Code

Cursor

Windsurf

Cline

Codex

依据项目文档列出，未经本站实测。

详细介绍

Brandsystem MCP 服务器旨在将现有的品牌材料（如网站、PDF、Figma 设计文件等）转换为 AI 代理可以理解和使用的便携式 .brand 运行时。它提供完整的工具集，涵盖品牌采用的四个阶段：核心身份、视觉身份、信息传递和内容策略。它生成结构化的品牌数据，包括设计令牌、声音规则、来源证明和合规检查，使 AI 在生成内容时能够遵循一致且准确的品牌指南，避免输出通用化内容。该服务器是本地优先的，默认无需账户，通过 stdio 运行，适用于多种开发工具。