@forgespace/branding-mcp 0.7.0 → 0.8.0

package/src/tools/generate-brand-identity.ts

@@ -1,115 +0,0 @@
-import { z } from 'zod';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import {
-  generateColorPalette,
-  generateTypographySystem,
-  generateSpacingScale,
-  generateShadowSystem,
-  generateBorderSystem,
-  generateMotionSystem,
-  generateGradientSystem,
-  generateSvgLogo,
-  defaultLogoConfig,
-} from '../lib/branding-core/index.js';
-import {
-  brandStyleSchema,
-  colorHarmonySchema,
-  colorThemeSchema,
-  fontCategorySchema,
-  hexColorSchema,
-  typeScaleRatioSchema,
-} from '../lib/branding-core/validators/token-schema.js';
-import type { BrandIdentity, BrandStyle, FontCategory } from '../lib/types.js';
-import { logger } from '../lib/logger.js';
-
-const STYLE_DEFAULTS: Record<BrandStyle, { heading: FontCategory; body: FontCategory }> = {
-  minimal: { heading: 'sans-serif', body: 'sans-serif' },
-  bold: { heading: 'display', body: 'sans-serif' },
-  elegant: { heading: 'serif', body: 'serif' },
-  playful: { heading: 'display', body: 'sans-serif' },
-  corporate: { heading: 'sans-serif', body: 'sans-serif' },
-  tech: { heading: 'sans-serif', body: 'monospace' },
-  organic: { heading: 'serif', body: 'sans-serif' },
-  retro: { heading: 'display', body: 'serif' },
-};
-
-export function registerGenerateBrandIdentity(server: McpServer): void {
-  server.tool(
-    'generate_brand_identity',
-    'Generate a complete brand identity including colors, typography, spacing, and logo. Provide a brand name and style preferences to get a cohesive identity system.',
-    {
-      brandName: z.string().min(1).max(100).describe('Brand name'),
-      industry: z.string().min(1).max(100).describe('Industry or sector (e.g. "tech", "health")'),
-      style: brandStyleSchema.describe('Visual style direction'),
-      tagline: z.string().max(200).optional().describe('Brand tagline'),
-      baseColor: hexColorSchema.optional().describe('Base color preference'),
-      harmony: colorHarmonySchema.optional().describe('Color harmony type'),
-      theme: colorThemeSchema.optional().describe('Light/dark/both'),
-      headingCategory: fontCategorySchema.optional().describe('Heading font category'),
-      bodyCategory: fontCategorySchema.optional().describe('Body font category'),
-      scaleRatio: typeScaleRatioSchema.optional().describe('Typography scale ratio'),
-    },
-    async ({
-      brandName,
-      industry,
-      style,
-      tagline,
-      baseColor,
-      harmony,
-      theme,
-      headingCategory,
-      bodyCategory,
-      scaleRatio,
-    }) => {
-      try {
-        logger.info({ brandName, industry, style }, 'Generating brand identity');
-
-        const defaults = STYLE_DEFAULTS[style];
-        const colors = generateColorPalette(baseColor, harmony ?? 'complementary', theme);
-        const typography = generateTypographySystem(
-          headingCategory ?? defaults.heading,
-          bodyCategory ?? defaults.body,
-          scaleRatio ?? 'major-third'
-        );
-        const spacing = generateSpacingScale();
-        const shadows = generateShadowSystem(colors.primary.hex, theme);
-        const borders = generateBorderSystem(style);
-        const motion = generateMotionSystem(style);
-        const gradients = generateGradientSystem(colors, style);
-        const logoConfig = {
-          ...defaultLogoConfig(brandName, colors.primary.hex),
-          font: typography.headingFont,
-          style,
-        };
-        const logo = generateSvgLogo(logoConfig);
-
-        const identity: BrandIdentity = {
-          id: `brand_${Date.now().toString(36)}`,
-          name: brandName,
-          tagline,
-          industry,
-          style,
-          colors,
-          typography,
-          spacing,
-          shadows,
-          borders,
-          motion,
-          gradients,
-          logo,
-          createdAt: new Date().toISOString(),
-        };
-
-        return {
-          content: [{ type: 'text', text: JSON.stringify(identity, null, 2) }],
-        };
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-          content: [{ type: 'text', text: `Error generating brand: ${message}` }],
-          isError: true,
-        };
-      }
-    }
-  );
-}

package/src/tools/generate-color-palette.ts

@@ -1,43 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { generateColorPalette } from '../lib/branding-core/index.js';
-import {
-  colorHarmonySchema,
-  colorThemeSchema,
-  hexColorSchema,
-} from '../lib/branding-core/validators/token-schema.js';
-import { logger } from '../lib/logger.js';
-
-export function registerGenerateColorPalette(server: McpServer): void {
-  server.tool(
-    'generate_color_palette',
-    'Generate a harmonious color palette with WCAG contrast validation. Supports complementary, analogous, triadic, split-complementary, tetradic, and monochromatic harmonies.',
-    {
-      baseColor: hexColorSchema
-        .optional()
-        .describe('Base hex color to build palette from (e.g. #6B4CE6)'),
-      harmony: colorHarmonySchema.optional().describe('Color harmony type'),
-      theme: colorThemeSchema.optional().describe('Light, dark, or both neutral scales'),
-    },
-    async ({ baseColor, harmony, theme }) => {
-      try {
-        logger.info({ baseColor, harmony, theme }, 'Generating color palette');
-        const palette = generateColorPalette(baseColor, harmony, theme);
-
-        return {
-          content: [
-            {
-              type: 'text',
-              text: JSON.stringify(palette, null, 2),
-            },
-          ],
-        };
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-          content: [{ type: 'text', text: `Error generating palette: ${message}` }],
-          isError: true,
-        };
-      }
-    }
-  );
-}

package/src/tools/generate-design-system.ts

@@ -1,163 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { z } from 'zod';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import {
-  generateColorPalette,
-  generateTypographySystem,
-  generateSpacingScale,
-  generateShadowSystem,
-  generateBorderSystem,
-  generateMotionSystem,
-  generateGradientSystem,
-  generateSvgLogo,
-  defaultLogoConfig,
-  exportDesignTokens,
-  exportCssVariables,
-  exportTailwindPreset,
-  exportFigmaTokens,
-  exportReactTheme,
-  exportSassVariables,
-} from '../lib/branding-core/index.js';
-import {
-  brandStyleSchema,
-  colorHarmonySchema,
-  colorThemeSchema,
-  exportFormatSchema,
-  fontCategorySchema,
-  hexColorSchema,
-  typeScaleRatioSchema,
-} from '../lib/branding-core/validators/token-schema.js';
-import type { BrandIdentity, BrandStyle, ExportFormat, FontCategory } from '../lib/types.js';
-import { logger } from '../lib/logger.js';
-
-const STYLE_DEFAULTS: Record<BrandStyle, { heading: FontCategory; body: FontCategory }> = {
-  minimal: { heading: 'sans-serif', body: 'sans-serif' },
-  bold: { heading: 'display', body: 'sans-serif' },
-  elegant: { heading: 'serif', body: 'serif' },
-  playful: { heading: 'display', body: 'sans-serif' },
-  corporate: { heading: 'sans-serif', body: 'sans-serif' },
-  tech: { heading: 'sans-serif', body: 'monospace' },
-  organic: { heading: 'serif', body: 'sans-serif' },
-  retro: { heading: 'display', body: 'serif' },
-};
-
-const EXPORTERS: Record<ExportFormat, (brand: BrandIdentity) => string | object> = {
-  json: exportDesignTokens,
-  css: exportCssVariables,
-  tailwind: exportTailwindPreset,
-  figma: exportFigmaTokens,
-  react: exportReactTheme,
-  sass: exportSassVariables,
-};
-
-function buildIdentity(params: {
-  brandName: string;
-  industry: string;
-  style: BrandStyle;
-  tagline?: string;
-  baseColor?: string;
-  harmony?: string;
-  theme?: string;
-  headingCategory?: FontCategory;
-  bodyCategory?: FontCategory;
-  scaleRatio?: string;
-}): BrandIdentity {
-  const defaults = STYLE_DEFAULTS[params.style];
-  const harmony = (params.harmony ?? 'complementary') as Parameters<typeof generateColorPalette>[1];
-  const theme = params.theme as Parameters<typeof generateColorPalette>[2];
-  const scaleRatio = (params.scaleRatio ?? 'major-third') as Parameters<
-    typeof generateTypographySystem
-  >[2];
-
-  const colors = generateColorPalette(params.baseColor, harmony, theme);
-  const typography = generateTypographySystem(
-    params.headingCategory ?? defaults.heading,
-    params.bodyCategory ?? defaults.body,
-    scaleRatio
-  );
-  const spacing = generateSpacingScale();
-  const shadows = generateShadowSystem(colors.primary.hex, theme);
-  const borders = generateBorderSystem(params.style);
-  const motion = generateMotionSystem(params.style);
-  const gradients = generateGradientSystem(colors, params.style);
-  const logoConfig = {
-    ...defaultLogoConfig(params.brandName, colors.primary.hex),
-    font: typography.headingFont,
-    style: params.style,
-  };
-  const logo = generateSvgLogo(logoConfig);
-
-  return {
-    id: `brand_${randomUUID().slice(0, 8)}`,
-    name: params.brandName,
-    tagline: params.tagline,
-    industry: params.industry,
-    style: params.style,
-    colors,
-    typography,
-    spacing,
-    shadows,
-    borders,
-    motion,
-    gradients,
-    logo,
-    createdAt: new Date().toISOString(),
-  };
-}
-
-export function registerGenerateDesignSystem(server: McpServer): void {
-  server.tool(
-    'generate_design_system',
-    'Generate a complete design system with brand identity and exported tokens in one call. ' +
-      'Combines generate_brand_identity + export_design_tokens for a streamlined workflow.',
-    {
-      brandName: z.string().min(1).max(100).describe('Brand name'),
-      industry: z.string().min(1).max(100).describe('Industry or sector'),
-      style: brandStyleSchema.describe('Visual style direction'),
-      tagline: z.string().max(200).optional().describe('Brand tagline'),
-      baseColor: hexColorSchema.optional().describe('Base color preference'),
-      harmony: colorHarmonySchema.optional().describe('Color harmony type'),
-      theme: colorThemeSchema.optional().describe('Light/dark/both'),
-      headingCategory: fontCategorySchema.optional().describe('Heading font category'),
-      bodyCategory: fontCategorySchema.optional().describe('Body font category'),
-      scaleRatio: typeScaleRatioSchema.optional().describe('Typography scale ratio'),
-      exportFormats: z
-        .array(exportFormatSchema)
-        .min(1)
-        .max(6)
-        .describe('Token export formats to include'),
-    },
-    async (params) => {
-      try {
-        logger.info(
-          { brandName: params.brandName, formats: params.exportFormats },
-          'Generating design system'
-        );
-
-        const identity = buildIdentity(params);
-        const exports: Record<string, string> = {};
-
-        for (const format of params.exportFormats) {
-          const exporter = EXPORTERS[format];
-          const result = exporter(identity);
-          exports[format] = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
-        }
-
-        const output = {
-          identity,
-          exports,
-        };
-
-        return {
-          content: [{ type: 'text' as const, text: JSON.stringify(output, null, 2) }],
-        };
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-          content: [{ type: 'text' as const, text: `Error generating design system: ${message}` }],
-          isError: true,
-        };
-      }
-    }
-  );
-}

package/src/tools/generate-typography-system.ts

@@ -1,42 +0,0 @@
-import { z } from 'zod';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { generateTypographySystem } from '../lib/branding-core/index.js';
-import {
-  fontCategorySchema,
-  typeScaleRatioSchema,
-} from '../lib/branding-core/validators/token-schema.js';
-import { logger } from '../lib/logger.js';
-
-export function registerGenerateTypographySystem(server: McpServer): void {
-  server.tool(
-    'generate_typography_system',
-    'Generate a typography system with font pairing, modular type scale, and line heights. Uses curated font pairings for visual harmony.',
-    {
-      headingCategory: fontCategorySchema.optional().describe('Font category for headings'),
-      bodyCategory: fontCategorySchema.optional().describe('Font category for body text'),
-      scaleRatio: typeScaleRatioSchema.optional().describe('Modular scale ratio'),
-      baseSize: z.number().min(12).max(24).optional().describe('Base font size in pixels'),
-    },
-    async ({ headingCategory, bodyCategory, scaleRatio, baseSize }) => {
-      try {
-        logger.info({ headingCategory, bodyCategory, scaleRatio }, 'Generating typography system');
-        const system = generateTypographySystem(
-          headingCategory,
-          bodyCategory,
-          scaleRatio,
-          baseSize
-        );
-
-        return {
-          content: [{ type: 'text', text: JSON.stringify(system, null, 2) }],
-        };
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-          content: [{ type: 'text', text: `Error generating typography: ${message}` }],
-          isError: true,
-        };
-      }
-    }
-  );
-}

package/src/tools/refine-brand-element.ts

@@ -1,65 +0,0 @@
-import { z } from 'zod';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { interpretFeedback, applyIntent } from '../lib/branding-core/index.js';
-import type { BrandIdentity } from '../lib/types.js';
-import type { InterpreterStrategy } from '../lib/branding-core/index.js';
-import { loadConfig } from '../lib/config.js';
-import { logger } from '../lib/logger.js';
-
-export function registerRefineBrandElement(server: McpServer): void {
-  server.tool(
-    'refine_brand_element',
-    'Refine a specific element of an existing brand identity using natural language feedback. Uses AI interpretation when available, keyword matching as fallback.',
-    {
-      brand: z.string().describe('Full BrandIdentity JSON'),
-      element: z.enum(['colors', 'typography', 'spacing']).describe('Element to refine'),
-      feedback: z
-        .string()
-        .describe(
-          'Natural language feedback (e.g. "make it feel more premium and understated", "use serif headings with dramatic scale")'
-        ),
-      strategy: z
-        .enum(['keyword', 'ai', 'auto'])
-        .optional()
-        .describe(
-          'Interpretation strategy: keyword (fast), ai (Claude API), auto (ai if key available)'
-        ),
-    },
-    async ({ brand, element, feedback, strategy }) => {
-      try {
-        logger.info({ element, feedback, strategy }, 'Refining brand element');
-        const brandData: BrandIdentity = JSON.parse(brand);
-        const config = loadConfig();
-
-        const intent = await interpretFeedback(
-          feedback,
-          element,
-          brandData,
-          (strategy as InterpreterStrategy) ?? 'auto',
-          { anthropicApiKey: config.anthropicApiKey }
-        );
-
-        const refined = applyIntent(brandData, intent);
-
-        return {
-          content: [
-            {
-              type: 'text',
-              text: JSON.stringify(
-                { ...refined, _interpretation: { strategy: strategy ?? 'auto', ...intent } },
-                null,
-                2
-              ),
-            },
-          ],
-        };
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-          content: [{ type: 'text', text: `Error refining element: ${message}` }],
-          isError: true,
-        };
-      }
-    }
-  );
-}

package/src/tools/validate-brand-consistency.ts

@@ -1,32 +0,0 @@
-import { z } from 'zod';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { validateBrandConsistency } from '../lib/branding-core/index.js';
-import type { BrandIdentity } from '../lib/types.js';
-import { logger } from '../lib/logger.js';
-
-export function registerValidateBrandConsistency(server: McpServer): void {
-  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: BrandIdentity = 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,
-        };
-      }
-    }
-  );
-}

package/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2022"],
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "strict": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "skipLibCheck": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts"]
-}