@forgespace/branding-mcp 0.4.0

package/dist/tools/refine-brand-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refine-brand-element.js","sourceRoot":"","sources":["../../src/tools/refine-brand-element.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAG/E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,+JAA+J,EAC/J;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACrD,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAClF,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,CACP,wHAAwH,CACzH;QACH,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;aAC/B,QAAQ,EAAE;aACV,QAAQ,CACP,sFAAsF,CACvF;KACJ,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC/C,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,wBAAwB,CAAC,CAAC;YACvE,MAAM,SAAS,GAAkB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;YAE5B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CACpC,QAAQ,EACR,OAAO,EACP,SAAS,EACR,QAAgC,IAAI,MAAM,EAC3C,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAC5C,CAAC;YAEF,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAE/C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,QAAQ,IAAI,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,EAC5E,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,OAAO,EAAE,EAAE,CAAC;gBACvE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/validate-brand-consistency.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerValidateBrandConsistency(server: McpServer): void;
+//# sourceMappingURL=validate-brand-consistency.d.ts.map

package/dist/tools/validate-brand-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-brand-consistency.d.ts","sourceRoot":"","sources":["../../src/tools/validate-brand-consistency.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyBxE"}

package/dist/tools/validate-brand-consistency.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { validateBrandConsistency } from '../lib/branding-core/index.js';
+import { logger } from '../lib/logger.js';
+export function registerValidateBrandConsistency(server) {
+    server.tool('validate_brand_consistency', 'Validate a brand identity for completeness, WCAG contrast compliance, and typography best practices. Returns a score (0-100) and actionable issues.', {
+        brand: z.string().describe('Full BrandIdentity JSON to validate'),
+    }, async ({ brand }) => {
+        try {
+            logger.info('Validating brand consistency');
+            const brandData = JSON.parse(brand);
+            const result = validateBrandConsistency(brandData);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: `Error validating brand: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=validate-brand-consistency.js.map

package/dist/tools/validate-brand-consistency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-brand-consistency.js","sourceRoot":"","sources":["../../src/tools/validate-brand-consistency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,UAAU,gCAAgC,CAAC,MAAiB;IAChE,MAAM,CAAC,IAAI,CACT,4BAA4B,EAC5B,qJAAqJ,EACrJ;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KAClE,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC5C,MAAM,SAAS,GAAkB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;YAEnD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,OAAO,EAAE,EAAE,CAAC;gBACvE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/docs/API.md

@@ -0,0 +1,110 @@
+# MCP Tool API Reference
+
+## generate_brand_identity
+
+Generate a complete brand identity from minimal input.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| brandName | string | yes | Brand name (1-100 chars) |
+| industry | string | yes | Industry sector |
+| style | BrandStyle | yes | Visual direction |
+| tagline | string | no | Brand tagline |
+| baseColor | hex string | no | Base color preference |
+| harmony | ColorHarmony | no | Color harmony type |
+| theme | ColorTheme | no | Light/dark/both |
+| headingCategory | FontCategory | no | Heading font category |
+| bodyCategory | FontCategory | no | Body font category |
+| scaleRatio | TypeScaleRatio | no | Typography scale ratio |
+
+**Returns:** Complete `BrandIdentity` JSON with colors, typography, spacing, and logo.
+
+## generate_color_palette
+
+Generate a color palette from a base color and harmony.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| baseColor | hex string | no | Base hex color (#RRGGBB) |
+| harmony | ColorHarmony | no | Harmony type |
+| theme | ColorTheme | no | Neutral scale direction |
+
+**Returns:** `ColorPalette` with primary, secondary, accent, neutrals, semantic colors, and WCAG contrast data.
+
+## generate_typography_system
+
+Generate a typography system with font pairing.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| headingCategory | FontCategory | no | Heading font type |
+| bodyCategory | FontCategory | no | Body font type |
+| scaleRatio | TypeScaleRatio | no | Modular scale ratio |
+| baseSize | number (12-24) | no | Base font size in px |
+
+**Returns:** `TypographySystem` with fonts, scale ratio, and type steps.
+
+## export_design_tokens
+
+Export a brand identity to various design token formats.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| brand | string (JSON) | yes | Full BrandIdentity JSON |
+| format | ExportFormat | yes | json, css, tailwind, figma, react, sass |
+
+**Returns:** Formatted design tokens string.
+
+## create_brand_guidelines
+
+Generate a brand guidelines document.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| brand | string (JSON) | yes | Full BrandIdentity JSON |
+| format | BrandDocFormat | no | html (default) or pdf |
+
+**Returns:** HTML brand book document.
+
+## validate_brand_consistency
+
+Check a brand identity for completeness and accessibility compliance.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| brand | string (JSON) | yes | Full BrandIdentity JSON |
+
+**Returns:** `BrandValidationResult` with score (0-100), validity flag, and issues list.
+
+## refine_brand_element
+
+Iterate on a specific element of an existing brand.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| brand | string (JSON) | yes | Full BrandIdentity JSON |
+| element | string | yes | colors, typography, or spacing |
+| feedback | string | yes | Natural language refinement instruction |
+
+**Returns:** Updated `BrandIdentity` JSON.
+
+## Enums
+
+**BrandStyle:** minimal, bold, elegant, playful, corporate, tech, organic, retro
+
+**ColorHarmony:** complementary, analogous, triadic, split-complementary, tetradic, monochromatic
+
+**ColorTheme:** light, dark, both
+
+**FontCategory:** serif, sans-serif, monospace, display, handwriting
+
+**TypeScaleRatio:** minor-second, major-second, minor-third, major-third, perfect-fourth, augmented-fourth, perfect-fifth, golden-ratio
+
+**ExportFormat:** json, css, tailwind, figma, react, sass

package/docs/DATA_SOURCES.md

@@ -0,0 +1,69 @@
+# AI Training Data Sources
+
+Curated data sources for enhancing the branding MCP's knowledge base and the broader Forge Space ecosystem.
+
+## Color Theory & Design
+
+| Source                           | License    | Use Case                               |
+| -------------------------------- | ---------- | -------------------------------------- |
+| culori (color science library)   | MIT        | Color space conversions, OKLCH support |
+| Open Color (13 hues x 10 shades) | MIT        | Curated color palettes reference       |
+| Tailwind CSS default palette     | MIT        | Industry-standard web color scales     |
+| Carbon Design System tokens      | Apache 2.0 | Enterprise design token patterns       |
+
+## Typography
+
+| Source                      | License    | Use Case                                |
+| --------------------------- | ---------- | --------------------------------------- |
+| Google Fonts API            | Apache 2.0 | Font metadata, pairing data, popularity |
+| Fontpair.co                 | Free       | Curated font pairing combinations       |
+| Type Scale (type-scale.com) | Free       | Modular scale visualization reference   |
+| Typewolf                    | Free/Paid  | Font usage in the wild, trend data      |
+
+## Accessibility
+
+| Source                  | License | Use Case                            |
+| ----------------------- | ------- | ----------------------------------- |
+| WCAG 2.1 as JSON (W3C)  | W3C     | Structured accessibility guidelines |
+| WCAG as JSON (Tenon.io) | MIT     | Machine-readable WCAG criteria      |
+| A11Y Project Patterns   | MIT     | Accessible component patterns       |
+| ARIA Practices Guide    | W3C     | ARIA pattern implementations        |
+
+## Design Tokens
+
+| Source                 | License      | Use Case                       |
+| ---------------------- | ------------ | ------------------------------ |
+| W3C Design Tokens Spec | W3C          | Token format standard          |
+| Style Dictionary       | Apache 2.0   | Token transformation pipelines |
+| Tokens Studio          | MIT (plugin) | Figma-to-code token workflows  |
+
+## Brand Identity
+
+| Source         | License  | Use Case                       |
+| -------------- | -------- | ------------------------------ |
+| Brandfetch API | Freemium | Brand asset data for reference |
+| Logo.dev       | Freemium | Logo generation patterns       |
+| Coolors.co     | Free     | Color palette inspiration      |
+
+## Component Libraries (for integration)
+
+| Source              | License | Use Case                        |
+| ------------------- | ------- | ------------------------------- |
+| shadcn/ui           | MIT     | Component styling patterns      |
+| Radix UI Primitives | MIT     | Accessible primitive components |
+| Headless UI         | MIT     | Unstyled component patterns     |
+
+## SEO & Web Standards
+
+| Source                | License      | Use Case                             |
+| --------------------- | ------------ | ------------------------------------ |
+| Schema.org vocabulary | CC BY-SA 3.0 | Structured data for brand pages      |
+| Google Lighthouse     | Apache 2.0   | Performance scoring for brand assets |
+| web.dev               | Apache 2.0   | Web best practices reference         |
+
+## Security
+
+| Source                   | License      | Use Case                                    |
+| ------------------------ | ------------ | ------------------------------------------- |
+| OWASP Cheat Sheet Series | CC BY-SA 4.0 | Security guidelines for brand asset serving |
+| CSP Reference (MDN)      | CC BY-SA 2.5 | Content Security Policy for brand assets    |

package/docs/INTEGRATION.md

@@ -0,0 +1,58 @@
+# Ecosystem Integration Guide
+
+## mcp-gateway Registration
+
+Register branding-mcp as an upstream server in mcp-gateway:
+
+```json
+{
+  "name": "branding",
+  "command": "node",
+  "args": ["/path/to/branding-mcp/dist/index.js"],
+  "port": 8033,
+  "tools": [
+    "generate_brand_identity",
+    "generate_color_palette",
+    "generate_typography_system",
+    "export_design_tokens",
+    "create_brand_guidelines",
+    "validate_brand_consistency",
+    "refine_brand_element"
+  ]
+}
+```
+
+## uiforge-mcp Integration
+
+The UI generator can consume brand tokens to ensure generated components match the brand:
+
+```typescript
+// In uiforge-mcp, pass brandId to component generation
+const component = await generateComponent({
+  type: 'button',
+  brandId: 'brand_abc123',
+  // Brand tokens auto-applied to colors, fonts, spacing
+});
+```
+
+## uiforge-webapp Routes
+
+New frontend routes for brand management:
+
+- `/branding` — Brand dashboard
+- `/branding/new` — Create new brand identity
+- `/branding/:id` — View/edit brand
+- `/branding/:id/export` — Export design tokens
+- `/branding/:id/guidelines` — View brand guidelines
+
+## Design Token Flow
+
+```
+branding-mcp (generate) → export_design_tokens → format selection
+  ├── json    → W3C Design Tokens → Style Dictionary pipeline
+  ├── css     → CSS custom properties → direct import
+  ├── tailwind → Tailwind preset → tailwind.config.ts
+  ├── figma   → Figma token format → Tokens Studio sync
+  ├── react   → Theme object → ThemeProvider
+  └── sass    → SCSS variables → @import
+```

package/eslint.config.js

@@ -0,0 +1,52 @@
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsparser from '@typescript-eslint/parser';
+
+export default [
+  {
+    ignores: ['dist/', 'node_modules/', 'coverage/', '*.js', '!eslint.config.js'],
+  },
+  {
+    files: ['src/**/*.ts'],
+    ignores: ['src/__tests__/**'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+        project: './tsconfig.json',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+    },
+    rules: {
+      'no-console': 'warn',
+      eqeqeq: ['error', 'always'],
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/explicit-function-return-type': ['warn', { allowExpressions: true }],
+    },
+  },
+  {
+    files: ['src/__tests__/**/*.ts'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+    },
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-floating-promises': 'off',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/no-unused-vars': 'off',
+      'no-console': 'off',
+    },
+  },
+];

package/jest.config.js

@@ -0,0 +1,40 @@
+/** @type {import('jest').Config} */
+export default {
+  preset: 'ts-jest/presets/default-esm',
+  testEnvironment: 'node',
+  testMatch: ['<rootDir>/src/__tests__/**/*.test.ts'],
+  testTimeout: 15_000,
+  extensionsToTreatAsEsm: ['.ts'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
+  transform: {
+    '^.+\\.ts$': [
+      'ts-jest',
+      {
+        useESM: true,
+        tsconfig: 'tsconfig.json',
+      },
+    ],
+  },
+  coverageDirectory: 'coverage',
+  collectCoverageFrom: [
+    'src/lib/**/*.ts',
+    '!src/lib/config.ts',
+    '!src/lib/logger.ts',
+    '!src/lib/branding-core/documents/**',
+    '!src/lib/branding-core/validators/token-schema.ts',
+    '!src/lib/branding-core/ai/claude-interpreter.ts',
+    '!src/lib/branding-core/ai/prompts.ts',
+    '!src/**/*.d.ts',
+    '!src/__tests__/**',
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 80,
+      functions: 80,
+      lines: 80,
+      statements: 80,
+    },
+  },
+};

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@forgespace/branding-mcp",
+  "version": "0.4.0",
+  "description": "MCP server for AI-powered brand identity generation — color palettes, typography systems, design tokens, and brand guidelines with multi-format export",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "forgespace-branding-mcp": "dist/index.js"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "validate": "npm run lint:check && npm run format:check && npm run test",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
+    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
+    "typecheck": "tsc --noEmit",
+    "pre-commit": "npm run lint && npm run format && npm run test",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "mcp",
+    "branding",
+    "design-tokens",
+    "color-palette",
+    "typography",
+    "brand-identity",
+    "ai",
+    "forge-space"
+  ],
+  "author": "Forge Space",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Forge-Space/branding-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Forge-Space/branding-mcp/issues"
+  },
+  "homepage": "https://github.com/Forge-Space/branding-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "culori": "^4.0.1",
+    "pdfkit": "^0.16.0",
+    "pino": "^10.3.1",
+    "satori": "^0.12.1",
+    "sharp": "^0.34.5",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "@types/pdfkit": "^0.13.8",
+    "@typescript-eslint/eslint-plugin": "^8.32.0",
+    "@typescript-eslint/parser": "^8.32.0",
+    "eslint": "^9.0.0",
+    "husky": "^9.0.0",
+    "jest": "^29.7.0",
+    "lint-staged": "^15.0.0",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.1.6"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  }
+}

package/src/__tests__/integration/brand-generation.test.ts

@@ -0,0 +1,84 @@
+import {
+  generateColorPalette,
+  generateTypographySystem,
+  generateSpacingScale,
+  generateSvgLogo,
+  defaultLogoConfig,
+  exportDesignTokens,
+  exportCssVariables,
+  exportTailwindPreset,
+  validateBrandConsistency,
+} from '../../lib/branding-core/index.js';
+import type { BrandIdentity } from '../../lib/types.js';
+
+describe('brand generation integration', () => {
+  let brand: BrandIdentity;
+
+  beforeAll(() => {
+    const colors = generateColorPalette('#6B4CE6', 'complementary');
+    const typography = generateTypographySystem('sans-serif', 'serif', 'major-third');
+    const spacing = generateSpacingScale();
+    const logoConfig = defaultLogoConfig('TestBrand', colors.primary.hex);
+    const logo = generateSvgLogo(logoConfig);
+
+    brand = {
+      id: 'brand_test',
+      name: 'TestBrand',
+      tagline: 'Test tagline',
+      industry: 'tech',
+      style: 'tech',
+      colors,
+      typography,
+      spacing,
+      logo,
+      createdAt: new Date().toISOString(),
+    };
+  });
+
+  it('generates a complete brand identity', () => {
+    expect(brand.colors.primary.hex).toMatch(/^#[0-9a-f]{6}$/);
+    expect(brand.typography.headingFont).toBeTruthy();
+    expect(brand.spacing.unit).toBe(4);
+    expect(brand.logo?.svg).toContain('<svg');
+  });
+
+  it('exports valid design tokens JSON', () => {
+    const tokens = exportDesignTokens(brand);
+    expect(tokens.color.primary).toBeDefined();
+    expect(tokens.typography['font-heading']).toBeDefined();
+    expect(Object.keys(tokens.spacing).length).toBeGreaterThan(0);
+  });
+
+  it('exports valid CSS variables', () => {
+    const css = exportCssVariables(brand);
+    expect(css).toContain(':root');
+    expect(css).toContain('--color-primary');
+  });
+
+  it('exports valid Tailwind preset', () => {
+    const preset = exportTailwindPreset(brand);
+    expect(preset).toContain('export default');
+    expect(preset).toContain('primary');
+  });
+
+  it('validates brand consistency', () => {
+    const result = validateBrandConsistency(brand);
+    expect(result.score).toBeGreaterThan(0);
+    expect(typeof result.valid).toBe('boolean');
+  });
+
+  it('logo SVG contains brand initial', () => {
+    expect(brand.logo?.svg).toContain('>T</text>');
+  });
+
+  it('logo SVG contains brand name', () => {
+    expect(brand.logo?.svg).toContain('>TestBrand</text>');
+  });
+
+  it('generates logo with background color', () => {
+    const config = { ...defaultLogoConfig('BG', '#000'), backgroundColor: '#ffffff' };
+    const logo = generateSvgLogo(config);
+    expect(logo.svg).toContain('rect');
+    expect(logo.svg).toContain('#ffffff');
+  });
+});

package/src/__tests__/integration/mcp-server.test.ts

@@ -0,0 +1,18 @@
+describe('MCP server', () => {
+  it('module can be imported without errors', async () => {
+    const mod = await import('../../lib/branding-core/index.js');
+    expect(mod.generateColorPalette).toBeDefined();
+    expect(mod.generateTypographySystem).toBeDefined();
+    expect(mod.generateSpacingScale).toBeDefined();
+    expect(mod.exportDesignTokens).toBeDefined();
+    expect(mod.exportCssVariables).toBeDefined();
+    expect(mod.exportTailwindPreset).toBeDefined();
+    expect(mod.exportFigmaTokens).toBeDefined();
+    expect(mod.exportReactTheme).toBeDefined();
+    expect(mod.exportSassVariables).toBeDefined();
+    expect(mod.validateBrandConsistency).toBeDefined();
+    expect(mod.validateContrast).toBeDefined();
+    expect(mod.generateSvgLogo).toBeDefined();
+    expect(mod.defaultLogoConfig).toBeDefined();
+  });
+});