适合谁
- 需要在 AI 内容生成中保持一致品牌标识的设计团队。
- 希望自动化品牌指南提取和令牌编译的开发人员。
- 使用 Claude Code、Cursor 等工具的团队。
- 需要管理品牌资产的营销专业人员和内容创建者。
B
62FMRS · C
Brandsystem MCP 提供了一套全面的品牌管理工具，使 AI 代理能够遵循品牌指南。它支持从网站、Figma 等提取品牌要素，生成设计令牌和品牌运行时，并提供检查、审核和合规功能。它特别适合需要将品牌系统集成到 AI 工作流中的设计和开发团队。但需注意其提取的准确性依赖于算法，可能需要人工介入，以及可能的配置复杂度。
Brandsystem MCP 服务器旨在将现有的品牌材料（如网站、PDF、Figma 设计文件等）转换为 AI 代理可以理解和使用的便携式 .brand 运行时。它提供完整的工具集，涵盖品牌采用的四个阶段：核心身份、视觉身份、信息传递和内容策略。它生成结构化的品牌数据，包括设计令牌、声音规则、来源证明和合规检查，使 AI 在生成内容时能够遵循一致且准确的品牌指南，避免输出通用化内容。该服务器是本地优先的，默认无需账户，通过 stdio 运行，适用于多种开发工具。
工具能力
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 设计令牌、品牌运行时契约和交互策略。
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 内从托管运行时刷新。
安装接入
- 在项目根目录创建 .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"
]
}
}
}
选型与风险
不适合谁
- 不需要品牌管理的通用 AI 任务。
- 只想运行托管品牌服务的用户（可能更适合 @brandcode/mcp）。
- 依赖 Figma 直接集成，而不需要额外 Figma MCP 服务器的用户。
- 没有 Node.js 20+ 环境或不想安装本地服务器的用户。
所需权限
- 读取您指定网站的 HTML/CSS/截图（需访问网络）。
- 读取本地文件系统并写入 .brand 目录（在项目目录内）。
- 连接托管 Brandcode Studio 时访问认证凭据（存储在 .brand/brandcode-auth.json）。
- 发送可选反馈到品牌团队。
风险与副作用
- 需要与远程网站通信，可能触及版权或隐私问题。
- 提取的数据基于算法推断，可能存在不准确，需要人工审查。
- Figma 提取需要额外的 Figma MCP，可能引入配置复杂性。
- 默认核心配置仅暴露 12 个工具，完整功能需要切换到完整配置文件。
常见排障
- 如果未找到 .brand 目录，请先运行 brand_start。
- 如果提取没有颜色或字体，可能是动态网站，尝试 brand_extract_visual 或 brand_extract_site。
- 如果 Figma 提取失败，确认已连接单独的 Figma MCP 服务器。
- 如果徽标未检测到，使用 brand_set_logo 手动添加。
- 如果服务器无法启动，检查 Node.js 版本（>=20.18.1）并运行 `npx @brandsystem/mcp doctor`。
使用场景
从网站快速提取品牌颜色、字体和徽标。
从 Figma 设计库导入品牌令牌。
为内容生成 AI 定义品牌声音和反模式。
在发布前检查内容是否符合品牌规则。
创建便携式品牌报告供团队和 AI 工具共享。
连接 Brandcode Studio 以同步和维护单一事实来源。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
Windsurf完整支持
Cline完整支持
Codex完整支持