branding-mcp

生成完整的设计系统——颜色、字体排版、间距、阴影、边框、动态效果令牌、渐变、多版本 Logo、favicon 和 OG 图片，并支持多种格式导出。提供 58 个 MCP 工具，无 API 依赖，以算法优先生成。

功能

• 颜色调色板生成 — 基于 HSL 的配色和谐方案（互补色、类似色、三角色等），并进行 WCAG 对比度验证
• 字体排版系统 — 模块化字体比例，搭配精选字体组合
• 间距比例 — 几何级数间距系统
• 阴影/层级系统 — 6 级层级比例，带品牌色调阴影，支持浅色/深色主题
• 边框/形状系统 — 为全部 8 种品牌风格提供与风格相适配的圆角比例和边框宽度
• 动态效果/动画系统 — 为每种品牌风格提供时长比例、三次贝塞尔缓动和过渡预设
• 渐变系统 — 5 种与风格相适配的渐变预设（主视觉、按钮、卡片、文本、背景）
• 多版本 Logo — 字标、字母标、抽象图形和图标版本，形状与风格相适配
• Favicon 生成 — 从品牌图标生成 4 种尺寸（16、32、180 Apple Touch、512 PWA）
• OG 图片模板 — 提供默认、文章和社交媒体格式，并带有品牌渐变
• 多格式导出 — W3C Design Tokens、CSS 自定义属性、Tailwind 预设、Figma 令牌、React 主题、Sass 变量
• 品牌验证 — WCAG 对比度检查、完整性评分和一致性分析
• 品牌指南 — 生成 HTML 品牌手册

快速开始

npm install
npm run build

从 npm 运行（stdio）

npx -y @forgespace/branding-mcp@latest

全局安装

npm install -g @forgespace/branding-mcp
forgespace-branding-mcp

IDE / 客户端配置

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

需要 AI 辅助优化时，请设置 ANTHROPIC_API_KEY。该服务也可以在不依赖外部 API 的情况下以纯算法模式运行。

MCP 工具

提供核心工具和垂直领域工具（共 58 个）。下表列出了核心工具以及关键的垂直领域生成工具，包括医疗保健领域。

工具	说明
generate_brand_identity	根据名称、行业和风格生成完整品牌
generate_color_palette	生成调色板，包含配色和谐方案及 WCAG 数据
generate_typography_system	字体组合 + 模块化字体比例
export_design_tokens	将品牌导出为 JSON/CSS/Tailwind/Figma/React/Sass 格式
create_brand_guidelines	生成 HTML 品牌手册
validate_brand_consistency	检查 WCAG 合规性和完整性
refine_brand_element	迭代优化特定品牌元素
generate_brand_assets	从品牌生成 favicon 和 OG 图片
generate_design_system	一次调用生成完整设计系统（品牌形象 + 导出）
generate_brand_fintech	针对金融科技行业的策略，涵盖合规性和安全性
generate_brand_healthcare	针对医疗保健行业的策略，涵盖护理模式和安全信号

MCP 资源

资源	URI	描述
品牌模板	brand://templates	预配置的行业模板
品牌知识	brand://knowledge	色彩理论和排版规则

开发

npm run dev          # Watch mode
npm run validate     # Lint + format + test
npm run test         # Run tests
npm run test:coverage # Coverage report
npm run build        # Build TypeScript

分发

• npm — 可通过 @forgespace/branding-mcp 安装
• MCP Registry 元数据 — 包含用于提交到注册表的 server.json 和 mcpName
• 标签发布自动化 — 推送 v* 后，会通过 npm publish 发布并附带来源证明， 然后通过 GitHub OIDC 将相同版本发布到 MCP Registry
• 每周注册表运维 — .github/workflows/mcp-registry-status.yml 会更新一个议题，汇总 npm 和 MCP Registry 的差异、可见性及后续操作
• GitHub — Forge-Space/branding-mcp

架构

src/
├── index.ts                    # MCP server entry
├── lib/
│   ├── branding-core/          # Core library (reusable)
│   │   ├── generators/         # Color, typography, spacing, logo, gradients, favicons, OG
│   │   ├── exporters/          # Multi-format token export
│   │   ├── validators/         # WCAG, consistency checks
│   │   └── documents/          # Brand book generation
│   ├── config.ts               # Environment config
│   ├── logger.ts               # Pino logging
│   └── types.ts                # TypeScript interfaces
├── tools/                      # 58 MCP tool registrations
└── resources/                  # Templates + knowledge base

生态集成

属于 Forge Space 生态：

• mcp-gateway — 注册为 MCP 服务（端口 8033）
• ui-mcp — 通过 brandId 参数使用品牌令牌
• uiforge-webapp — 位于 /branding/* 的品牌管理界面
• forge-patterns — 共享配置和约定

社区

• 文档
• GitHub 讨论区
• 问题跟踪器

许可证

MIT