@forgespace/branding-mcp

@forgespace/branding-mcp

AI-powered brand identity generation via MCP — part of the Forge Space open developer workspace.

Generate complete design systems — colors, typography, spacing, shadows, borders, motion tokens, gradients, multi-variant logos, favicons, and OG images with multi-format export. 9 MCP tools, zero API dependencies, algorithmic-first generation.

Features

• Color Palette Generation — HSL-based color harmonies (complementary, analogous, triadic, etc.) with WCAG contrast validation
• Typography System — Modular type scales with curated font pairings
• Spacing Scale — Geometric progression spacing system
• Shadow/Elevation System — 6-level elevation scale with brand-tinted shadows, light/dark theme support
• Border/Shape System — Style-aware radius scales and border widths for all 8 brand styles
• Motion/Animation System — Duration scales, cubic-bezier easings, and transition presets per brand style
• Gradient System — 5 style-aware gradient presets (hero, button, card, text, background)
• Multi-Variant Logo — Wordmark, monogram, abstract, and icon variants with style-aware shapes
• Favicon Generation — 4 sizes (16, 32, 180 apple-touch, 512 PWA) from brand icon
• OG Image Templates — Default, article, and social formats with brand gradients
• Multi-Format Export — W3C Design Tokens, CSS custom properties, Tailwind preset, Figma tokens, React theme, Sass variables
• Brand Validation — WCAG contrast checking, completeness scoring, consistency analysis
• Brand Guidelines — HTML brand book generation

Quick Start

npm install
npm run build

Run from npm (stdio)

npx -y @forgespace/branding-mcp@latest

Install globally

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

IDE / client config

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

Set ANTHROPIC_API_KEY when you want AI-assisted refinement. The server also works in algorithmic-only mode without external APIs.

MCP Tools

Tool	Description
generate_brand_identity	Complete brand from name, industry, and style
generate_color_palette	Color palette with harmony and WCAG data
generate_typography_system	Font pairing + modular type scale
export_design_tokens	Export brand to JSON/CSS/Tailwind/Figma/React/Sass
create_brand_guidelines	Generate HTML brand book
validate_brand_consistency	Check WCAG compliance and completeness
refine_brand_element	Iterate on specific brand elements
generate_brand_assets	Generate favicons and OG images from brand
generate_design_system	Complete design system in one call (identity + export)

MCP Resources

Resource	URI	Description
Brand Templates	brand://templates	Pre-configured industry templates
Brand Knowledge	brand://knowledge	Color theory and typography rules

Development

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

Distribution

• npm — installable as @forgespace/branding-mcp
• MCP Registry metadata — server.json and mcpName are included for registry submission
• Tag release automation — pushing v* runs npm publish with provenance, then publishes the same version to the MCP Registry via GitHub OIDC
• Weekly registry ops — .github/workflows/mcp-registry-status.yml refreshes one issue with npm and MCP Registry drift, visibility, and next actions
• GitHub — Forge-Space/branding-mcp

Architecture

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/                      # 8 MCP tool registrations
└── resources/                  # Templates + knowledge base

Ecosystem Integration

Part of the Forge Space ecosystem:

• mcp-gateway — Register as MCP server (port 8033)
• ui-mcp — Consumes brand tokens via brandId parameter
• uiforge-webapp — Brand management UI at /branding/*
• forge-patterns — Shared configs and conventions

Community

• Documentation
• GitHub Discussions
• Issue tracker

License

MIT