io.github.Forge-Space/branding-mcp

Generate complete design systems — colors, typography, spacing, shadows, borders, motion tokens, gradients, multi-variant logos, favicons, and OG images with multi-format export. 58 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

Core and vertical tools are available (58 total). The table below highlights the core set plus key vertical generators, including healthcare.

MCP Resources

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/                      # 58 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