@creatica/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anup Aglawe (Creatica)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# @creatica/mcp
+
+MCP server for Creatica backgrounds. `npx -y @creatica/mcp` runs it over stdio, fully local. See `docs/MCP.md`.

package/dist/index.js

@@ -0,0 +1,350 @@
+// src/server.ts
+import {
+  ENGINE_VERSION,
+  renderPng,
+  renderSvg
+} from "@creatica/engine";
+import {
+  catalog,
+  describe,
+  jsonSchemaFor,
+  listPalettes,
+  normalizeRequest,
+  styleCard,
+  suggest
+} from "@creatica/schema";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { mkdir, writeFile } from "fs/promises";
+import { dirname, resolve } from "path";
+import { z } from "zod";
+var hexColor = z.string().regex(
+  /^#?([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/,
+  "hex colour like #1e90ff"
+);
+var paletteShape = z.object({
+  colors: z.array(hexColor).min(1).max(12).optional().describe(
+    "Explicit hex colours to draw from (best for brand matching). Overrides palette/scheme."
+  ),
+  palette: z.string().optional().describe(
+    'Id of a built-in palette from list_palettes, e.g. "underTheSea".'
+  ),
+  primaryColor: hexColor.optional(),
+  secondaryColor: hexColor.optional(),
+  backgroundColor: hexColor.optional(),
+  gradientColor: z.boolean().optional().describe("Gradient fills instead of flat colour."),
+  useMultiColor: z.boolean().optional().describe("false = everything in primaryColor."),
+  colorSchemeType: z.enum(["Mono", "Tetrade", "Analogic"]).optional().describe("Derive a palette from primaryColor."),
+  opaqueColors: z.boolean().optional()
+}).strict();
+var shapeShape = z.record(z.string(), z.union([z.number(), z.boolean(), z.string()])).describe(
+  "Structure-specific options; call describe_background for the exact keys, ranges and what they do."
+);
+function createMcpServer(options = {}) {
+  const { hosted } = options;
+  const maxInline = options.maxInlineBytes ?? 6e5;
+  const server = new McpServer(
+    { name: "creatica-backgrounds", version: ENGINE_VERSION },
+    {
+      instructions: [
+        "Creatica generates abstract, procedural SVG/PNG backgrounds (waves, blobs, bauhaus grids, topo lines, aurora glows\u2026) for websites, slides, social cards and apps.",
+        "Workflow: suggest_backgrounds (or list_backgrounds) with the brief \u2192 describe_background for the chosen one \u2192 generate_background with a seed. Every render is deterministic: same structure + params + seed = identical image, so keep the seed to reproduce or make on-brand variants.",
+        "For brand colours pass palette.colors as hex. For a curated look pass palette.palette from list_palettes. Prefer PNG when you need a preview; SVG for the final asset."
+      ].join("\n")
+    }
+  );
+  server.registerTool(
+    "list_backgrounds",
+    {
+      title: "List backgrounds",
+      description: "Browse the catalog of background structures. Optionally filter by a free-text query, tag or mood word. Returns name, one-line summary, mood, use cases and a preview URL for each.",
+      inputSchema: {
+        query: z.string().optional().describe('Free text, e.g. "calm waves" or "geometric poster".'),
+        mood: z.string().optional().describe("A mood word, e.g. dark, playful, minimal, retro."),
+        tag: z.string().optional(),
+        limit: z.number().int().min(1).max(100).optional()
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ query, mood, tag, limit }) => {
+      let items = catalog();
+      if (mood)
+        items = items.filter(
+          (c) => c.mood.some((m) => m.toLowerCase().includes(mood.toLowerCase()))
+        );
+      if (tag)
+        items = items.filter(
+          (c) => c.tags.some((t) => t.toLowerCase().includes(tag.toLowerCase()))
+        );
+      if (query) {
+        const ranked = suggest(query, { limit: 100 }).map((s) => s.name);
+        items = items.filter((c) => ranked.includes(c.name)).sort((a, b) => ranked.indexOf(a.name) - ranked.indexOf(b.name));
+      }
+      items = items.slice(0, limit ?? 100);
+      return json({ count: items.length, backgrounds: items });
+    }
+  );
+  server.registerTool(
+    "suggest_backgrounds",
+    {
+      title: "Suggest backgrounds for a brief",
+      description: 'Rank structures for a natural-language brief ("dark aurora glow for an AI landing page"). Returns why each matched, matching built-in palettes, and a ready-to-run example request for generate_background.',
+      inputSchema: {
+        brief: z.string().min(2),
+        limit: z.number().int().min(1).max(20).optional()
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ brief, limit }) => json({ suggestions: suggest(brief, { limit: limit ?? 5 }) })
+  );
+  server.registerTool(
+    "describe_background",
+    {
+      title: "Describe a background",
+      description: "Full style card for one structure: what it looks like, mood, where text can go, tips, and every parameter it honours with ranges, defaults and the visual effect of low/high values. Also returns the JSON Schema for a generate request.",
+      inputSchema: {
+        name: z.string().describe('Structure name from list_backgrounds, e.g. "wave".'),
+        format: z.enum(["markdown", "json"]).optional().describe(
+          "markdown (default) is best for reading; json includes the JSON Schema."
+        )
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ name, format }) => {
+      try {
+        if (format === "json")
+          return json({ ...describe(name), jsonSchema: jsonSchemaFor(name) });
+        return text(styleCard(name));
+      } catch (e) {
+        return error(e.message);
+      }
+    }
+  );
+  server.registerTool(
+    "list_palettes",
+    {
+      title: "List palettes",
+      description: "Built-in curated colour palettes with their hex colours and derived mood tags (dark, pastel, vivid, warm, cool\u2026). Pass the id as palette.palette to generate_background.",
+      inputSchema: {
+        mood: z.string().optional().describe('Filter by a mood tag, e.g. "dark" or "pastel".')
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ mood }) => {
+      let items = listPalettes();
+      if (mood)
+        items = items.filter((p) => p.mood.includes(mood.toLowerCase()));
+      return json({ count: items.length, palettes: items });
+    }
+  );
+  if (hosted?.listBrandKits) {
+    server.registerTool(
+      "list_brand_kits",
+      {
+        title: "List brand kits",
+        description: "Saved brand palettes on this account. Pass a kit's slug as `brand` to generate_background to render on-brand without repeating hex colours.",
+        inputSchema: {},
+        annotations: {
+          readOnlyHint: true,
+          idempotentHint: true,
+          openWorldHint: false
+        }
+      },
+      async () => json({ brandKits: await hosted.listBrandKits() })
+    );
+  }
+  server.registerTool(
+    "generate_background",
+    {
+      title: "Generate a background",
+      description: [
+        "Render a background as SVG or PNG. Deterministic: the same structure, options and seed always give the same image, so store the returned seed.",
+        hosted ? "Returns a permanent, cacheable image URL you can use directly in <img>/CSS, plus an inline PNG preview." : "Returns the image inline (PNG previews are visible to you); pass saveTo to also write the file to disk.",
+        "Call describe_background first to learn which shape options the structure honours."
+      ].join(" "),
+      inputSchema: {
+        structure: z.string().describe('Structure name, e.g. "wave".'),
+        seed: z.string().optional().describe(
+          "Any string. Omit for a fresh random seed (returned in the result)."
+        ),
+        width: z.number().int().min(1).max(8192).optional(),
+        height: z.number().int().min(1).max(8192).optional(),
+        palette: paletteShape.optional(),
+        shape: shapeShape.optional(),
+        format: z.enum(["svg", "png"]).optional().describe(
+          "png (default) returns a viewable image; svg returns the vector source."
+        ),
+        pngWidth: z.number().int().min(16).max(8192).optional().describe(
+          "Raster width for PNG output/preview. Defaults to the render width, capped for inline previews."
+        ),
+        ...hosted?.listBrandKits ? {
+          brand: z.string().optional().describe(
+            "Slug of a saved brand kit (see list_brand_kits); its colours become the palette baseline."
+          )
+        } : {},
+        ...hosted ? {} : {
+          saveTo: z.string().optional().describe(
+            "Local file path to write the result to (extension decides svg/png if format is omitted)."
+          )
+        }
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async (args) => {
+      const input = { ...args };
+      const brandSlug = typeof input.brand === "string" ? input.brand : void 0;
+      delete input.brand;
+      if (brandSlug) {
+        const kit = (await hosted?.listBrandKits?.())?.find(
+          (k) => k.slug === brandSlug
+        );
+        if (!kit)
+          return error(
+            `Unknown brand kit "${brandSlug}". Call list_brand_kits to see the available ones.`
+          );
+        const basePalette = { colors: kit.colors };
+        if (kit.backgroundColor)
+          basePalette.backgroundColor = kit.backgroundColor;
+        input.palette = {
+          ...basePalette,
+          ...input.palette ?? {}
+        };
+        if (!input.structure && kit.defaultStructure)
+          input.structure = kit.defaultStructure;
+      }
+      let normalized;
+      try {
+        normalized = normalizeRequest(input);
+      } catch (e) {
+        return error(e.message);
+      }
+      const { request, warnings } = normalized;
+      const saveTo = hosted ? void 0 : args.saveTo;
+      const format = args.format ?? (saveTo?.toLowerCase().endsWith(".svg") ? "svg" : "png");
+      try {
+        await hosted?.beforeRender?.(request);
+      } catch (e) {
+        return error(e.message);
+      }
+      const result = await renderSvg(request);
+      await hosted?.onRender?.(result, format);
+      const content = [];
+      const meta = {
+        structure: result.structure,
+        seed: result.seed,
+        width: result.width,
+        height: result.height,
+        format,
+        svgBytes: result.svg.length,
+        renderMs: result.durationMs,
+        // Echo the resolved options so the caller can reproduce or tweak.
+        request: { ...request, seed: result.seed },
+        ...warnings.length ? { warnings } : {}
+      };
+      if (hosted) {
+        meta.url = renderUrl(
+          hosted.publicBaseUrl,
+          { ...request, seed: result.seed },
+          format
+        );
+        meta.svgUrl = renderUrl(
+          hosted.publicBaseUrl,
+          { ...request, seed: result.seed },
+          "svg"
+        );
+      }
+      if (saveTo) {
+        const path = resolve(saveTo);
+        await mkdir(dirname(path), { recursive: true });
+        const bytes = format === "png" ? await renderPng(result.svg, { width: args.pngWidth ?? result.width }) : Buffer.from(result.svg, "utf8");
+        await writeFile(path, bytes);
+        meta.savedTo = path;
+        meta.bytes = bytes.length;
+      }
+      if (format === "svg") {
+        if (result.svg.length <= maxInline && !saveTo) {
+          content.push({
+            type: "resource",
+            resource: {
+              uri: `creatica://render/${result.structure}/${result.seed}.svg`,
+              mimeType: "image/svg+xml",
+              text: result.svg
+            }
+          });
+        } else if (!saveTo && !hosted) {
+          meta.note = `SVG is ${result.svg.length} bytes; pass saveTo to write it to disk instead of returning it inline.`;
+        }
+      }
+      const previewWidth = Math.min(args.pngWidth ?? 800, 1200);
+      const png = await renderPng(result.svg, { width: previewWidth });
+      if (png.length <= maxInline) {
+        content.push({
+          type: "image",
+          data: png.toString("base64"),
+          mimeType: "image/png"
+        });
+      } else {
+        const small = await renderPng(result.svg, { width: 480 });
+        content.push({
+          type: "image",
+          data: small.toString("base64"),
+          mimeType: "image/png"
+        });
+        meta.note = `Preview downscaled to 480px (full PNG would be ${png.length} bytes).`;
+      }
+      content.unshift({ type: "text", text: JSON.stringify(meta, null, 2) });
+      return { content };
+    }
+  );
+  return server;
+}
+function renderUrl(baseUrl, req, format) {
+  const u = new URL(
+    `/v1/render/${encodeURIComponent(req.structure)}.${format}`,
+    baseUrl
+  );
+  if (req.seed !== void 0) u.searchParams.set("seed", String(req.seed));
+  if (req.width) u.searchParams.set("width", String(req.width));
+  if (req.height) u.searchParams.set("height", String(req.height));
+  for (const [k, v] of Object.entries(req.palette ?? {})) {
+    if (v === void 0) continue;
+    u.searchParams.set(k, Array.isArray(v) ? v.join(",") : String(v));
+  }
+  for (const [k, v] of Object.entries(req.shape ?? {})) {
+    if (v !== void 0) u.searchParams.set(k, String(v));
+  }
+  return u.toString();
+}
+function json(value) {
+  return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };
+}
+function text(value) {
+  return { content: [{ type: "text", text: value }] };
+}
+function error(message) {
+  return { isError: true, content: [{ type: "text", text: message }] };
+}
+export {
+  createMcpServer,
+  renderUrl
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import {\n  ENGINE_VERSION,\n  renderPng,\n  renderSvg,\n  type RenderRequest,\n  type RenderResult,\n} from '@creatica/engine';\nimport {\n  catalog,\n  describe,\n  jsonSchemaFor,\n  listPalettes,\n  normalizeRequest,\n  styleCard,\n  suggest,\n} from '@creatica/schema';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, resolve } from 'node:path';\nimport { z } from 'zod';\n\nexport interface BrandKitSummary {\n  slug: string;\n  name: string;\n  colors: string[];\n  backgroundColor?: string;\n  defaultStructure?: string;\n}\n\nexport interface HostedOptions {\n  /** Public origin of the API, e.g. https://api.creatica.app */\n  publicBaseUrl: string;\n  /** Brand kits of the calling account; enables `brand` on generate and list_brand_kits. */\n  listBrandKits?: () => Promise<BrandKitSummary[]>;\n  /**\n   * Called before rendering. Throw to refuse (e.g. quota exhausted); the\n   * message is returned to the model as a tool error, so discovery tools keep\n   * working and the model can explain what to do next.\n   */\n  beforeRender?: (request: RenderRequest) => void | Promise<void>;\n  /** Called after a successful render so the host can meter usage. */\n  onRender?: (\n    result: RenderResult,\n    format: 'svg' | 'png',\n  ) => void | Promise<void>;\n}\n\nexport interface McpServerOptions {\n  /**\n   * Local mode (default) renders in-process and can write files to disk.\n   * Hosted mode additionally returns permanent, cacheable image URLs and\n   * never touches the filesystem.\n   */\n  hosted?: HostedOptions;\n  /** Inline PNG previews above this many bytes are downscaled. */\n  maxInlineBytes?: number;\n}\n\nconst hexColor = z\n  .string()\n  .regex(\n    /^#?([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/,\n    'hex colour like #1e90ff',\n  );\n\nconst paletteShape = z\n  .object({\n    colors: z\n      .array(hexColor)\n      .min(1)\n      .max(12)\n      .optional()\n      .describe(\n        'Explicit hex colours to draw from (best for brand matching). Overrides palette/scheme.',\n      ),\n    palette: z\n      .string()\n      .optional()\n      .describe(\n        'Id of a built-in palette from list_palettes, e.g. \"underTheSea\".',\n      ),\n    primaryColor: hexColor.optional(),\n    secondaryColor: hexColor.optional(),\n    backgroundColor: hexColor.optional(),\n    gradientColor: z\n      .boolean()\n      .optional()\n      .describe('Gradient fills instead of flat colour.'),\n    useMultiColor: z\n      .boolean()\n      .optional()\n      .describe('false = everything in primaryColor.'),\n    colorSchemeType: z\n      .enum(['Mono', 'Tetrade', 'Analogic'])\n      .optional()\n      .describe('Derive a palette from primaryColor.'),\n    opaqueColors: z.boolean().optional(),\n  })\n  .strict();\n\n// Shape options are a loose record: which keys apply depends on the structure\n// (see describe_background). normalizeRequest() validates against that.\nconst shapeShape = z\n  .record(z.string(), z.union([z.number(), z.boolean(), z.string()]))\n  .describe(\n    'Structure-specific options; call describe_background for the exact keys, ranges and what they do.',\n  );\n\nexport function createMcpServer(options: McpServerOptions = {}): McpServer {\n  const { hosted } = options;\n  const maxInline = options.maxInlineBytes ?? 600_000;\n\n  const server = new McpServer(\n    { name: 'creatica-backgrounds', version: ENGINE_VERSION },\n    {\n      instructions: [\n        'Creatica generates abstract, procedural SVG/PNG backgrounds (waves, blobs, bauhaus grids, topo lines, aurora glows…) for websites, slides, social cards and apps.',\n        'Workflow: suggest_backgrounds (or list_backgrounds) with the brief → describe_background for the chosen one → generate_background with a seed. Every render is deterministic: same structure + params + seed = identical image, so keep the seed to reproduce or make on-brand variants.',\n        'For brand colours pass palette.colors as hex. For a curated look pass palette.palette from list_palettes. Prefer PNG when you need a preview; SVG for the final asset.',\n      ].join('\\n'),\n    },\n  );\n\n  server.registerTool(\n    'list_backgrounds',\n    {\n      title: 'List backgrounds',\n      description:\n        'Browse the catalog of background structures. Optionally filter by a free-text query, tag or mood word. Returns name, one-line summary, mood, use cases and a preview URL for each.',\n      inputSchema: {\n        query: z\n          .string()\n          .optional()\n          .describe('Free text, e.g. \"calm waves\" or \"geometric poster\".'),\n        mood: z\n          .string()\n          .optional()\n          .describe('A mood word, e.g. dark, playful, minimal, retro.'),\n        tag: z.string().optional(),\n        limit: z.number().int().min(1).max(100).optional(),\n      },\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n      },\n    },\n    async ({ query, mood, tag, limit }) => {\n      let items = catalog();\n      if (mood)\n        items = items.filter((c) =>\n          c.mood.some((m) => m.toLowerCase().includes(mood.toLowerCase())),\n        );\n      if (tag)\n        items = items.filter((c) =>\n          c.tags.some((t) => t.toLowerCase().includes(tag.toLowerCase())),\n        );\n      if (query) {\n        const ranked = suggest(query, { limit: 100 }).map((s) => s.name);\n        items = items\n          .filter((c) => ranked.includes(c.name))\n          .sort((a, b) => ranked.indexOf(a.name) - ranked.indexOf(b.name));\n      }\n      items = items.slice(0, limit ?? 100);\n      return json({ count: items.length, backgrounds: items });\n    },\n  );\n\n  server.registerTool(\n    'suggest_backgrounds',\n    {\n      title: 'Suggest backgrounds for a brief',\n      description:\n        'Rank structures for a natural-language brief (\"dark aurora glow for an AI landing page\"). Returns why each matched, matching built-in palettes, and a ready-to-run example request for generate_background.',\n      inputSchema: {\n        brief: z.string().min(2),\n        limit: z.number().int().min(1).max(20).optional(),\n      },\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n      },\n    },\n    async ({ brief, limit }) =>\n      json({ suggestions: suggest(brief, { limit: limit ?? 5 }) }),\n  );\n\n  server.registerTool(\n    'describe_background',\n    {\n      title: 'Describe a background',\n      description:\n        'Full style card for one structure: what it looks like, mood, where text can go, tips, and every parameter it honours with ranges, defaults and the visual effect of low/high values. Also returns the JSON Schema for a generate request.',\n      inputSchema: {\n        name: z\n          .string()\n          .describe('Structure name from list_backgrounds, e.g. \"wave\".'),\n        format: z\n          .enum(['markdown', 'json'])\n          .optional()\n          .describe(\n            'markdown (default) is best for reading; json includes the JSON Schema.',\n          ),\n      },\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n      },\n    },\n    async ({ name, format }) => {\n      try {\n        if (format === 'json')\n          return json({ ...describe(name), jsonSchema: jsonSchemaFor(name) });\n        return text(styleCard(name));\n      } catch (e) {\n        return error((e as Error).message);\n      }\n    },\n  );\n\n  server.registerTool(\n    'list_palettes',\n    {\n      title: 'List palettes',\n      description:\n        'Built-in curated colour palettes with their hex colours and derived mood tags (dark, pastel, vivid, warm, cool…). Pass the id as palette.palette to generate_background.',\n      inputSchema: {\n        mood: z\n          .string()\n          .optional()\n          .describe('Filter by a mood tag, e.g. \"dark\" or \"pastel\".'),\n      },\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n      },\n    },\n    async ({ mood }) => {\n      let items = listPalettes();\n      if (mood)\n        items = items.filter((p) => p.mood.includes(mood.toLowerCase()));\n      return json({ count: items.length, palettes: items });\n    },\n  );\n\n  if (hosted?.listBrandKits) {\n    server.registerTool(\n      'list_brand_kits',\n      {\n        title: 'List brand kits',\n        description:\n          \"Saved brand palettes on this account. Pass a kit's slug as `brand` to generate_background to render on-brand without repeating hex colours.\",\n        inputSchema: {},\n        annotations: {\n          readOnlyHint: true,\n          idempotentHint: true,\n          openWorldHint: false,\n        },\n      },\n      async () => json({ brandKits: await hosted.listBrandKits!() }),\n    );\n  }\n\n  server.registerTool(\n    'generate_background',\n    {\n      title: 'Generate a background',\n      description: [\n        'Render a background as SVG or PNG. Deterministic: the same structure, options and seed always give the same image, so store the returned seed.',\n        hosted\n          ? 'Returns a permanent, cacheable image URL you can use directly in <img>/CSS, plus an inline PNG preview.'\n          : 'Returns the image inline (PNG previews are visible to you); pass saveTo to also write the file to disk.',\n        'Call describe_background first to learn which shape options the structure honours.',\n      ].join(' '),\n      inputSchema: {\n        structure: z.string().describe('Structure name, e.g. \"wave\".'),\n        seed: z\n          .string()\n          .optional()\n          .describe(\n            'Any string. Omit for a fresh random seed (returned in the result).',\n          ),\n        width: z.number().int().min(1).max(8192).optional(),\n        height: z.number().int().min(1).max(8192).optional(),\n        palette: paletteShape.optional(),\n        shape: shapeShape.optional(),\n        format: z\n          .enum(['svg', 'png'])\n          .optional()\n          .describe(\n            'png (default) returns a viewable image; svg returns the vector source.',\n          ),\n        pngWidth: z\n          .number()\n          .int()\n          .min(16)\n          .max(8192)\n          .optional()\n          .describe(\n            'Raster width for PNG output/preview. Defaults to the render width, capped for inline previews.',\n          ),\n        ...(hosted?.listBrandKits\n          ? {\n              brand: z\n                .string()\n                .optional()\n                .describe(\n                  'Slug of a saved brand kit (see list_brand_kits); its colours become the palette baseline.',\n                ),\n            }\n          : {}),\n        ...(hosted\n          ? {}\n          : {\n              saveTo: z\n                .string()\n                .optional()\n                .describe(\n                  'Local file path to write the result to (extension decides svg/png if format is omitted).',\n                ),\n            }),\n      },\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n      },\n    },\n    async (args) => {\n      const input = { ...(args as Record<string, unknown>) };\n      const brandSlug =\n        typeof input.brand === 'string' ? input.brand : undefined;\n      delete input.brand;\n      if (brandSlug) {\n        const kit = (await hosted?.listBrandKits?.())?.find(\n          (k) => k.slug === brandSlug,\n        );\n        if (!kit)\n          return error(\n            `Unknown brand kit \"${brandSlug}\". Call list_brand_kits to see the available ones.`,\n          );\n        const basePalette: Record<string, unknown> = { colors: kit.colors };\n        if (kit.backgroundColor)\n          basePalette.backgroundColor = kit.backgroundColor;\n        input.palette = {\n          ...basePalette,\n          ...((input.palette as Record<string, unknown>) ?? {}),\n        };\n        if (!input.structure && kit.defaultStructure)\n          input.structure = kit.defaultStructure;\n      }\n      let normalized;\n      try {\n        normalized = normalizeRequest(input);\n      } catch (e) {\n        return error((e as Error).message);\n      }\n      const { request, warnings } = normalized;\n      const saveTo = hosted ? undefined : (args as { saveTo?: string }).saveTo;\n      const format: 'svg' | 'png' =\n        (args.format as 'svg' | 'png' | undefined) ??\n        (saveTo?.toLowerCase().endsWith('.svg') ? 'svg' : 'png');\n\n      try {\n        await hosted?.beforeRender?.(request);\n      } catch (e) {\n        return error((e as Error).message);\n      }\n      const result = await renderSvg(request);\n      await hosted?.onRender?.(result, format);\n\n      const content: CallToolResult['content'] = [];\n      const meta: Record<string, unknown> = {\n        structure: result.structure,\n        seed: result.seed,\n        width: result.width,\n        height: result.height,\n        format,\n        svgBytes: result.svg.length,\n        renderMs: result.durationMs,\n        // Echo the resolved options so the caller can reproduce or tweak.\n        request: { ...request, seed: result.seed },\n        ...(warnings.length ? { warnings } : {}),\n      };\n\n      if (hosted) {\n        meta.url = renderUrl(\n          hosted.publicBaseUrl,\n          { ...request, seed: result.seed },\n          format,\n        );\n        meta.svgUrl = renderUrl(\n          hosted.publicBaseUrl,\n          { ...request, seed: result.seed },\n          'svg',\n        );\n      }\n\n      if (saveTo) {\n        const path = resolve(saveTo);\n        await mkdir(dirname(path), { recursive: true });\n        const bytes =\n          format === 'png'\n            ? await renderPng(result.svg, { width: args.pngWidth ?? result.width })\n            : Buffer.from(result.svg, 'utf8');\n        await writeFile(path, bytes);\n        meta.savedTo = path;\n        meta.bytes = bytes.length;\n      }\n\n      if (format === 'svg') {\n        if (result.svg.length <= maxInline && !saveTo) {\n          content.push({\n            type: 'resource',\n            resource: {\n              uri: `creatica://render/${result.structure}/${result.seed}.svg`,\n              mimeType: 'image/svg+xml',\n              text: result.svg,\n            },\n          });\n        } else if (!saveTo && !hosted) {\n          meta.note = `SVG is ${result.svg.length} bytes; pass saveTo to write it to disk instead of returning it inline.`;\n        }\n      }\n\n      // Always attach a PNG preview so the model can see what it made. Keep\n      // it modest: previews are for judging composition, not final delivery.\n      const previewWidth = Math.min(args.pngWidth ?? 800, 1200);\n      const png = await renderPng(result.svg, { width: previewWidth });\n      if (png.length <= maxInline) {\n        content.push({\n          type: 'image',\n          data: png.toString('base64'),\n          mimeType: 'image/png',\n        });\n      } else {\n        const small = await renderPng(result.svg, { width: 480 });\n        content.push({\n          type: 'image',\n          data: small.toString('base64'),\n          mimeType: 'image/png',\n        });\n        meta.note = `Preview downscaled to 480px (full PNG would be ${png.length} bytes).`;\n      }\n\n      content.unshift({ type: 'text', text: JSON.stringify(meta, null, 2) });\n      return { content };\n    },\n  );\n\n  return server;\n}\n\nexport function renderUrl(\n  baseUrl: string,\n  req: RenderRequest,\n  format: 'svg' | 'png',\n): string {\n  const u = new URL(\n    `/v1/render/${encodeURIComponent(req.structure)}.${format}`,\n    baseUrl,\n  );\n  if (req.seed !== undefined) u.searchParams.set('seed', String(req.seed));\n  if (req.width) u.searchParams.set('width', String(req.width));\n  if (req.height) u.searchParams.set('height', String(req.height));\n  for (const [k, v] of Object.entries(req.palette ?? {})) {\n    if (v === undefined) continue;\n    u.searchParams.set(k, Array.isArray(v) ? v.join(',') : String(v));\n  }\n  for (const [k, v] of Object.entries(req.shape ?? {})) {\n    if (v !== undefined) u.searchParams.set(k, String(v));\n  }\n  return u.toString();\n}\n\nfunction json(value: unknown): CallToolResult {\n  return { content: [{ type: 'text', text: JSON.stringify(value, null, 2) }] };\n}\nfunction text(value: string): CallToolResult {\n  return { content: [{ type: 'text', text: value }] };\n}\nfunction error(message: string): CallToolResult {\n  return { isError: true, content: [{ type: 'text', text: message }] };\n}\n"],"mappings":"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","names":[]}

package/dist/stdio.js

@@ -0,0 +1,370 @@
+#!/usr/bin/env node
+
+// src/stdio.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/server.ts
+import {
+  ENGINE_VERSION,
+  renderPng,
+  renderSvg
+} from "@creatica/engine";
+import {
+  catalog,
+  describe,
+  jsonSchemaFor,
+  listPalettes,
+  normalizeRequest,
+  styleCard,
+  suggest
+} from "@creatica/schema";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { mkdir, writeFile } from "fs/promises";
+import { dirname, resolve } from "path";
+import { z } from "zod";
+var hexColor = z.string().regex(
+  /^#?([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/,
+  "hex colour like #1e90ff"
+);
+var paletteShape = z.object({
+  colors: z.array(hexColor).min(1).max(12).optional().describe(
+    "Explicit hex colours to draw from (best for brand matching). Overrides palette/scheme."
+  ),
+  palette: z.string().optional().describe(
+    'Id of a built-in palette from list_palettes, e.g. "underTheSea".'
+  ),
+  primaryColor: hexColor.optional(),
+  secondaryColor: hexColor.optional(),
+  backgroundColor: hexColor.optional(),
+  gradientColor: z.boolean().optional().describe("Gradient fills instead of flat colour."),
+  useMultiColor: z.boolean().optional().describe("false = everything in primaryColor."),
+  colorSchemeType: z.enum(["Mono", "Tetrade", "Analogic"]).optional().describe("Derive a palette from primaryColor."),
+  opaqueColors: z.boolean().optional()
+}).strict();
+var shapeShape = z.record(z.string(), z.union([z.number(), z.boolean(), z.string()])).describe(
+  "Structure-specific options; call describe_background for the exact keys, ranges and what they do."
+);
+function createMcpServer(options = {}) {
+  const { hosted } = options;
+  const maxInline = options.maxInlineBytes ?? 6e5;
+  const server2 = new McpServer(
+    { name: "creatica-backgrounds", version: ENGINE_VERSION },
+    {
+      instructions: [
+        "Creatica generates abstract, procedural SVG/PNG backgrounds (waves, blobs, bauhaus grids, topo lines, aurora glows\u2026) for websites, slides, social cards and apps.",
+        "Workflow: suggest_backgrounds (or list_backgrounds) with the brief \u2192 describe_background for the chosen one \u2192 generate_background with a seed. Every render is deterministic: same structure + params + seed = identical image, so keep the seed to reproduce or make on-brand variants.",
+        "For brand colours pass palette.colors as hex. For a curated look pass palette.palette from list_palettes. Prefer PNG when you need a preview; SVG for the final asset."
+      ].join("\n")
+    }
+  );
+  server2.registerTool(
+    "list_backgrounds",
+    {
+      title: "List backgrounds",
+      description: "Browse the catalog of background structures. Optionally filter by a free-text query, tag or mood word. Returns name, one-line summary, mood, use cases and a preview URL for each.",
+      inputSchema: {
+        query: z.string().optional().describe('Free text, e.g. "calm waves" or "geometric poster".'),
+        mood: z.string().optional().describe("A mood word, e.g. dark, playful, minimal, retro."),
+        tag: z.string().optional(),
+        limit: z.number().int().min(1).max(100).optional()
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ query, mood, tag, limit }) => {
+      let items = catalog();
+      if (mood)
+        items = items.filter(
+          (c) => c.mood.some((m) => m.toLowerCase().includes(mood.toLowerCase()))
+        );
+      if (tag)
+        items = items.filter(
+          (c) => c.tags.some((t) => t.toLowerCase().includes(tag.toLowerCase()))
+        );
+      if (query) {
+        const ranked = suggest(query, { limit: 100 }).map((s) => s.name);
+        items = items.filter((c) => ranked.includes(c.name)).sort((a, b) => ranked.indexOf(a.name) - ranked.indexOf(b.name));
+      }
+      items = items.slice(0, limit ?? 100);
+      return json({ count: items.length, backgrounds: items });
+    }
+  );
+  server2.registerTool(
+    "suggest_backgrounds",
+    {
+      title: "Suggest backgrounds for a brief",
+      description: 'Rank structures for a natural-language brief ("dark aurora glow for an AI landing page"). Returns why each matched, matching built-in palettes, and a ready-to-run example request for generate_background.',
+      inputSchema: {
+        brief: z.string().min(2),
+        limit: z.number().int().min(1).max(20).optional()
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ brief, limit }) => json({ suggestions: suggest(brief, { limit: limit ?? 5 }) })
+  );
+  server2.registerTool(
+    "describe_background",
+    {
+      title: "Describe a background",
+      description: "Full style card for one structure: what it looks like, mood, where text can go, tips, and every parameter it honours with ranges, defaults and the visual effect of low/high values. Also returns the JSON Schema for a generate request.",
+      inputSchema: {
+        name: z.string().describe('Structure name from list_backgrounds, e.g. "wave".'),
+        format: z.enum(["markdown", "json"]).optional().describe(
+          "markdown (default) is best for reading; json includes the JSON Schema."
+        )
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ name, format }) => {
+      try {
+        if (format === "json")
+          return json({ ...describe(name), jsonSchema: jsonSchemaFor(name) });
+        return text(styleCard(name));
+      } catch (e) {
+        return error(e.message);
+      }
+    }
+  );
+  server2.registerTool(
+    "list_palettes",
+    {
+      title: "List palettes",
+      description: "Built-in curated colour palettes with their hex colours and derived mood tags (dark, pastel, vivid, warm, cool\u2026). Pass the id as palette.palette to generate_background.",
+      inputSchema: {
+        mood: z.string().optional().describe('Filter by a mood tag, e.g. "dark" or "pastel".')
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ mood }) => {
+      let items = listPalettes();
+      if (mood)
+        items = items.filter((p) => p.mood.includes(mood.toLowerCase()));
+      return json({ count: items.length, palettes: items });
+    }
+  );
+  if (hosted?.listBrandKits) {
+    server2.registerTool(
+      "list_brand_kits",
+      {
+        title: "List brand kits",
+        description: "Saved brand palettes on this account. Pass a kit's slug as `brand` to generate_background to render on-brand without repeating hex colours.",
+        inputSchema: {},
+        annotations: {
+          readOnlyHint: true,
+          idempotentHint: true,
+          openWorldHint: false
+        }
+      },
+      async () => json({ brandKits: await hosted.listBrandKits() })
+    );
+  }
+  server2.registerTool(
+    "generate_background",
+    {
+      title: "Generate a background",
+      description: [
+        "Render a background as SVG or PNG. Deterministic: the same structure, options and seed always give the same image, so store the returned seed.",
+        hosted ? "Returns a permanent, cacheable image URL you can use directly in <img>/CSS, plus an inline PNG preview." : "Returns the image inline (PNG previews are visible to you); pass saveTo to also write the file to disk.",
+        "Call describe_background first to learn which shape options the structure honours."
+      ].join(" "),
+      inputSchema: {
+        structure: z.string().describe('Structure name, e.g. "wave".'),
+        seed: z.string().optional().describe(
+          "Any string. Omit for a fresh random seed (returned in the result)."
+        ),
+        width: z.number().int().min(1).max(8192).optional(),
+        height: z.number().int().min(1).max(8192).optional(),
+        palette: paletteShape.optional(),
+        shape: shapeShape.optional(),
+        format: z.enum(["svg", "png"]).optional().describe(
+          "png (default) returns a viewable image; svg returns the vector source."
+        ),
+        pngWidth: z.number().int().min(16).max(8192).optional().describe(
+          "Raster width for PNG output/preview. Defaults to the render width, capped for inline previews."
+        ),
+        ...hosted?.listBrandKits ? {
+          brand: z.string().optional().describe(
+            "Slug of a saved brand kit (see list_brand_kits); its colours become the palette baseline."
+          )
+        } : {},
+        ...hosted ? {} : {
+          saveTo: z.string().optional().describe(
+            "Local file path to write the result to (extension decides svg/png if format is omitted)."
+          )
+        }
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async (args) => {
+      const input = { ...args };
+      const brandSlug = typeof input.brand === "string" ? input.brand : void 0;
+      delete input.brand;
+      if (brandSlug) {
+        const kit = (await hosted?.listBrandKits?.())?.find(
+          (k) => k.slug === brandSlug
+        );
+        if (!kit)
+          return error(
+            `Unknown brand kit "${brandSlug}". Call list_brand_kits to see the available ones.`
+          );
+        const basePalette = { colors: kit.colors };
+        if (kit.backgroundColor)
+          basePalette.backgroundColor = kit.backgroundColor;
+        input.palette = {
+          ...basePalette,
+          ...input.palette ?? {}
+        };
+        if (!input.structure && kit.defaultStructure)
+          input.structure = kit.defaultStructure;
+      }
+      let normalized;
+      try {
+        normalized = normalizeRequest(input);
+      } catch (e) {
+        return error(e.message);
+      }
+      const { request, warnings } = normalized;
+      const saveTo = hosted ? void 0 : args.saveTo;
+      const format = args.format ?? (saveTo?.toLowerCase().endsWith(".svg") ? "svg" : "png");
+      try {
+        await hosted?.beforeRender?.(request);
+      } catch (e) {
+        return error(e.message);
+      }
+      const result = await renderSvg(request);
+      await hosted?.onRender?.(result, format);
+      const content = [];
+      const meta = {
+        structure: result.structure,
+        seed: result.seed,
+        width: result.width,
+        height: result.height,
+        format,
+        svgBytes: result.svg.length,
+        renderMs: result.durationMs,
+        // Echo the resolved options so the caller can reproduce or tweak.
+        request: { ...request, seed: result.seed },
+        ...warnings.length ? { warnings } : {}
+      };
+      if (hosted) {
+        meta.url = renderUrl(
+          hosted.publicBaseUrl,
+          { ...request, seed: result.seed },
+          format
+        );
+        meta.svgUrl = renderUrl(
+          hosted.publicBaseUrl,
+          { ...request, seed: result.seed },
+          "svg"
+        );
+      }
+      if (saveTo) {
+        const path = resolve(saveTo);
+        await mkdir(dirname(path), { recursive: true });
+        const bytes = format === "png" ? await renderPng(result.svg, { width: args.pngWidth ?? result.width }) : Buffer.from(result.svg, "utf8");
+        await writeFile(path, bytes);
+        meta.savedTo = path;
+        meta.bytes = bytes.length;
+      }
+      if (format === "svg") {
+        if (result.svg.length <= maxInline && !saveTo) {
+          content.push({
+            type: "resource",
+            resource: {
+              uri: `creatica://render/${result.structure}/${result.seed}.svg`,
+              mimeType: "image/svg+xml",
+              text: result.svg
+            }
+          });
+        } else if (!saveTo && !hosted) {
+          meta.note = `SVG is ${result.svg.length} bytes; pass saveTo to write it to disk instead of returning it inline.`;
+        }
+      }
+      const previewWidth = Math.min(args.pngWidth ?? 800, 1200);
+      const png = await renderPng(result.svg, { width: previewWidth });
+      if (png.length <= maxInline) {
+        content.push({
+          type: "image",
+          data: png.toString("base64"),
+          mimeType: "image/png"
+        });
+      } else {
+        const small = await renderPng(result.svg, { width: 480 });
+        content.push({
+          type: "image",
+          data: small.toString("base64"),
+          mimeType: "image/png"
+        });
+        meta.note = `Preview downscaled to 480px (full PNG would be ${png.length} bytes).`;
+      }
+      content.unshift({ type: "text", text: JSON.stringify(meta, null, 2) });
+      return { content };
+    }
+  );
+  return server2;
+}
+function renderUrl(baseUrl, req, format) {
+  const u = new URL(
+    `/v1/render/${encodeURIComponent(req.structure)}.${format}`,
+    baseUrl
+  );
+  if (req.seed !== void 0) u.searchParams.set("seed", String(req.seed));
+  if (req.width) u.searchParams.set("width", String(req.width));
+  if (req.height) u.searchParams.set("height", String(req.height));
+  for (const [k, v] of Object.entries(req.palette ?? {})) {
+    if (v === void 0) continue;
+    u.searchParams.set(k, Array.isArray(v) ? v.join(",") : String(v));
+  }
+  for (const [k, v] of Object.entries(req.shape ?? {})) {
+    if (v !== void 0) u.searchParams.set(k, String(v));
+  }
+  return u.toString();
+}
+function json(value) {
+  return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };
+}
+function text(value) {
+  return { content: [{ type: "text", text: value }] };
+}
+function error(message) {
+  return { isError: true, content: [{ type: "text", text: message }] };
+}
+
+// src/stdio.ts
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+  process.stdout.write(
+    [
+      "creatica-mcp \u2014 Model Context Protocol server for Creatica backgrounds (stdio).",
+      "",
+      "Tools: list_backgrounds, suggest_backgrounds, describe_background, list_palettes, generate_background",
+      "",
+      "Claude Code:   claude mcp add creatica -- npx -y @creatica/mcp",
+      'Claude Desktop: add {"mcpServers":{"creatica":{"command":"npx","args":["-y","@creatica/mcp"]}}}',
+      ""
+    ].join("\n")
+  );
+  process.exit(0);
+}
+var server = createMcpServer();
+var transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stdio.ts","../src/server.ts"],"sourcesContent":["#!/usr/bin/env node\n// Local MCP server over stdio. Runs the whole engine on this machine; no\n// network, no account. Add to Claude Desktop / Claude Code / Cursor as:\n//   { \"command\": \"npx\", \"args\": [\"-y\", \"@creatica/mcp\"] }\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { createMcpServer } from './server.js';\n\nif (process.argv.includes('--help') || process.argv.includes('-h')) {\n  process.stdout.write(\n    [\n      'creatica-mcp — Model Context Protocol server for Creatica backgrounds (stdio).',\n      '',\n      'Tools: list_backgrounds, suggest_backgrounds, describe_background, list_palettes, generate_background',\n      '',\n      'Claude Code:   claude mcp add creatica -- npx -y @creatica/mcp',\n      'Claude Desktop: add {\"mcpServers\":{\"creatica\":{\"command\":\"npx\",\"args\":[\"-y\",\"@creatica/mcp\"]}}}',\n      '',\n    ].join('\\n'),\n  );\n  process.exit(0);\n}\n\nconst server = createMcpServer();\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\n","import {\n  ENGINE_VERSION,\n  renderPng,\n  renderSvg,\n  type RenderRequest,\n  type RenderResult,\n} from '@creatica/engine';\nimport {\n  catalog,\n  describe,\n  jsonSchemaFor,\n  listPalettes,\n  normalizeRequest,\n  styleCard,\n  suggest,\n} from '@creatica/schema';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, resolve } from 'node:path';\nimport { z } from 'zod';\n\nexport interface BrandKitSummary {\n  slug: string;\n  name: string;\n  colors: string[];\n  backgroundColor?: string;\n  defaultStructure?: string;\n}\n\nexport interface HostedOptions {\n  /** Public origin of the API, e.g. https://api.creatica.app */\n  publicBaseUrl: string;\n  /** Brand kits of the calling account; enables `brand` on generate and list_brand_kits. */\n  listBrandKits?: () => Promise<BrandKitSummary[]>;\n  /**\n   * Called before rendering. Throw to refuse (e.g. quota exhausted); the\n   * message is returned to the model as a tool error, so discovery tools keep\n   * working and the model can explain what to do next.\n   */\n  beforeRender?: (request: RenderRequest) => void | Promise<void>;\n  /** Called after a successful render so the host can meter usage. */\n  onRender?: (\n    result: RenderResult,\n    format: 'svg' | 'png',\n  ) => void | Promise<void>;\n}\n\nexport interface McpServerOptions {\n  /**\n   * Local mode (default) renders in-process and can write files to disk.\n   * Hosted mode additionally returns permanent, cacheable image URLs and\n   * never touches the filesystem.\n   */\n  hosted?: HostedOptions;\n  /** Inline PNG previews above this many bytes are downscaled. */\n  maxInlineBytes?: number;\n}\n\nconst hexColor = z\n  .string()\n  .regex(\n    /^#?([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/,\n    'hex colour like #1e90ff',\n  );\n\nconst paletteShape = z\n  .object({\n    colors: z\n      .array(hexColor)\n      .min(1)\n      .max(12)\n      .optional()\n      .describe(\n        'Explicit hex colours to draw from (best for brand matching). Overrides palette/scheme.',\n      ),\n    palette: z\n      .string()\n      .optional()\n      .describe(\n        'Id of a built-in palette from list_palettes, e.g. \"underTheSea\".',\n      ),\n    primaryColor: hexColor.optional(),\n    secondaryColor: hexColor.optional(),\n    backgroundColor: hexColor.optional(),\n    gradientColor: z\n      .boolean()\n      .optional()\n      .describe('Gradient fills instead of flat colour.'),\n    useMultiColor: z\n      .boolean()\n      .optional()\n      .describe('false = everything in primaryColor.'),\n    colorSchemeType: z\n      .enum(['Mono', 'Tetrade', 'Analogic'])\n      .optional()\n      .describe('Derive a palette from primaryColor.'),\n    opaqueColors: z.boolean().optional(),\n  })\n  .strict();\n\n// Shape options are a loose record: which keys apply depends on the structure\n// (see describe_background). normalizeRequest() validates against that.\nconst shapeShape = z\n  .record(z.string(), z.union([z.number(), z.boolean(), z.string()]))\n  .describe(\n    'Structure-specific options; call describe_background for the exact keys, ranges and what they do.',\n  );\n\nexport function createMcpServer(options: McpServerOptions = {}): McpServer {\n  const { hosted } = options;\n  const maxInline = options.maxInlineBytes ?? 600_000;\n\n  const server = new McpServer(\n    { name: 'creatica-backgrounds', version: ENGINE_VERSION },\n    {\n      instructions: [\n        'Creatica generates abstract, procedural SVG/PNG backgrounds (waves, blobs, bauhaus grids, topo lines, aurora glows…) for websites, slides, social cards and apps.',\n        'Workflow: suggest_backgrounds (or list_backgrounds) with the brief → describe_background for the chosen one → generate_background with a seed. Every render is deterministic: same structure + params + seed = identical image, so keep the seed to reproduce or make on-brand variants.',\n        'For brand colours pass palette.colors as hex. For a curated look pass palette.palette from list_palettes. Prefer PNG when you need a preview; SVG for the final asset.',\n      ].join('\\n'),\n    },\n  );\n\n  server.registerTool(\n    'list_backgrounds',\n    {\n      title: 'List backgrounds',\n      description:\n        'Browse the catalog of background structures. Optionally filter by a free-text query, tag or mood word. Returns name, one-line summary, mood, use cases and a preview URL for each.',\n      inputSchema: {\n        query: z\n          .string()\n          .optional()\n          .describe('Free text, e.g. \"calm waves\" or \"geometric poster\".'),\n        mood: z\n          .string()\n          .optional()\n          .describe('A mood word, e.g. dark, playful, minimal, retro.'),\n        tag: z.string().optional(),\n        limit: z.number().int().min(1).max(100).optional(),\n      },\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n      },\n    },\n    async ({ query, mood, tag, limit }) => {\n      let items = catalog();\n      if (mood)\n        items = items.filter((c) =>\n          c.mood.some((m) => m.toLowerCase().includes(mood.toLowerCase())),\n        );\n      if (tag)\n        items = items.filter((c) =>\n          c.tags.some((t) => t.toLowerCase().includes(tag.toLowerCase())),\n        );\n      if (query) {\n        const ranked = suggest(query, { limit: 100 }).map((s) => s.name);\n        items = items\n          .filter((c) => ranked.includes(c.name))\n          .sort((a, b) => ranked.indexOf(a.name) - ranked.indexOf(b.name));\n      }\n      items = items.slice(0, limit ?? 100);\n      return json({ count: items.length, backgrounds: items });\n    },\n  );\n\n  server.registerTool(\n    'suggest_backgrounds',\n    {\n      title: 'Suggest backgrounds for a brief',\n      description:\n        'Rank structures for a natural-language brief (\"dark aurora glow for an AI landing page\"). Returns why each matched, matching built-in palettes, and a ready-to-run example request for generate_background.',\n      inputSchema: {\n        brief: z.string().min(2),\n        limit: z.number().int().min(1).max(20).optional(),\n      },\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n      },\n    },\n    async ({ brief, limit }) =>\n      json({ suggestions: suggest(brief, { limit: limit ?? 5 }) }),\n  );\n\n  server.registerTool(\n    'describe_background',\n    {\n      title: 'Describe a background',\n      description:\n        'Full style card for one structure: what it looks like, mood, where text can go, tips, and every parameter it honours with ranges, defaults and the visual effect of low/high values. Also returns the JSON Schema for a generate request.',\n      inputSchema: {\n        name: z\n          .string()\n          .describe('Structure name from list_backgrounds, e.g. \"wave\".'),\n        format: z\n          .enum(['markdown', 'json'])\n          .optional()\n          .describe(\n            'markdown (default) is best for reading; json includes the JSON Schema.',\n          ),\n      },\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n      },\n    },\n    async ({ name, format }) => {\n      try {\n        if (format === 'json')\n          return json({ ...describe(name), jsonSchema: jsonSchemaFor(name) });\n        return text(styleCard(name));\n      } catch (e) {\n        return error((e as Error).message);\n      }\n    },\n  );\n\n  server.registerTool(\n    'list_palettes',\n    {\n      title: 'List palettes',\n      description:\n        'Built-in curated colour palettes with their hex colours and derived mood tags (dark, pastel, vivid, warm, cool…). Pass the id as palette.palette to generate_background.',\n      inputSchema: {\n        mood: z\n          .string()\n          .optional()\n          .describe('Filter by a mood tag, e.g. \"dark\" or \"pastel\".'),\n      },\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n      },\n    },\n    async ({ mood }) => {\n      let items = listPalettes();\n      if (mood)\n        items = items.filter((p) => p.mood.includes(mood.toLowerCase()));\n      return json({ count: items.length, palettes: items });\n    },\n  );\n\n  if (hosted?.listBrandKits) {\n    server.registerTool(\n      'list_brand_kits',\n      {\n        title: 'List brand kits',\n        description:\n          \"Saved brand palettes on this account. Pass a kit's slug as `brand` to generate_background to render on-brand without repeating hex colours.\",\n        inputSchema: {},\n        annotations: {\n          readOnlyHint: true,\n          idempotentHint: true,\n          openWorldHint: false,\n        },\n      },\n      async () => json({ brandKits: await hosted.listBrandKits!() }),\n    );\n  }\n\n  server.registerTool(\n    'generate_background',\n    {\n      title: 'Generate a background',\n      description: [\n        'Render a background as SVG or PNG. Deterministic: the same structure, options and seed always give the same image, so store the returned seed.',\n        hosted\n          ? 'Returns a permanent, cacheable image URL you can use directly in <img>/CSS, plus an inline PNG preview.'\n          : 'Returns the image inline (PNG previews are visible to you); pass saveTo to also write the file to disk.',\n        'Call describe_background first to learn which shape options the structure honours.',\n      ].join(' '),\n      inputSchema: {\n        structure: z.string().describe('Structure name, e.g. \"wave\".'),\n        seed: z\n          .string()\n          .optional()\n          .describe(\n            'Any string. Omit for a fresh random seed (returned in the result).',\n          ),\n        width: z.number().int().min(1).max(8192).optional(),\n        height: z.number().int().min(1).max(8192).optional(),\n        palette: paletteShape.optional(),\n        shape: shapeShape.optional(),\n        format: z\n          .enum(['svg', 'png'])\n          .optional()\n          .describe(\n            'png (default) returns a viewable image; svg returns the vector source.',\n          ),\n        pngWidth: z\n          .number()\n          .int()\n          .min(16)\n          .max(8192)\n          .optional()\n          .describe(\n            'Raster width for PNG output/preview. Defaults to the render width, capped for inline previews.',\n          ),\n        ...(hosted?.listBrandKits\n          ? {\n              brand: z\n                .string()\n                .optional()\n                .describe(\n                  'Slug of a saved brand kit (see list_brand_kits); its colours become the palette baseline.',\n                ),\n            }\n          : {}),\n        ...(hosted\n          ? {}\n          : {\n              saveTo: z\n                .string()\n                .optional()\n                .describe(\n                  'Local file path to write the result to (extension decides svg/png if format is omitted).',\n                ),\n            }),\n      },\n      annotations: {\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n      },\n    },\n    async (args) => {\n      const input = { ...(args as Record<string, unknown>) };\n      const brandSlug =\n        typeof input.brand === 'string' ? input.brand : undefined;\n      delete input.brand;\n      if (brandSlug) {\n        const kit = (await hosted?.listBrandKits?.())?.find(\n          (k) => k.slug === brandSlug,\n        );\n        if (!kit)\n          return error(\n            `Unknown brand kit \"${brandSlug}\". Call list_brand_kits to see the available ones.`,\n          );\n        const basePalette: Record<string, unknown> = { colors: kit.colors };\n        if (kit.backgroundColor)\n          basePalette.backgroundColor = kit.backgroundColor;\n        input.palette = {\n          ...basePalette,\n          ...((input.palette as Record<string, unknown>) ?? {}),\n        };\n        if (!input.structure && kit.defaultStructure)\n          input.structure = kit.defaultStructure;\n      }\n      let normalized;\n      try {\n        normalized = normalizeRequest(input);\n      } catch (e) {\n        return error((e as Error).message);\n      }\n      const { request, warnings } = normalized;\n      const saveTo = hosted ? undefined : (args as { saveTo?: string }).saveTo;\n      const format: 'svg' | 'png' =\n        (args.format as 'svg' | 'png' | undefined) ??\n        (saveTo?.toLowerCase().endsWith('.svg') ? 'svg' : 'png');\n\n      try {\n        await hosted?.beforeRender?.(request);\n      } catch (e) {\n        return error((e as Error).message);\n      }\n      const result = await renderSvg(request);\n      await hosted?.onRender?.(result, format);\n\n      const content: CallToolResult['content'] = [];\n      const meta: Record<string, unknown> = {\n        structure: result.structure,\n        seed: result.seed,\n        width: result.width,\n        height: result.height,\n        format,\n        svgBytes: result.svg.length,\n        renderMs: result.durationMs,\n        // Echo the resolved options so the caller can reproduce or tweak.\n        request: { ...request, seed: result.seed },\n        ...(warnings.length ? { warnings } : {}),\n      };\n\n      if (hosted) {\n        meta.url = renderUrl(\n          hosted.publicBaseUrl,\n          { ...request, seed: result.seed },\n          format,\n        );\n        meta.svgUrl = renderUrl(\n          hosted.publicBaseUrl,\n          { ...request, seed: result.seed },\n          'svg',\n        );\n      }\n\n      if (saveTo) {\n        const path = resolve(saveTo);\n        await mkdir(dirname(path), { recursive: true });\n        const bytes =\n          format === 'png'\n            ? await renderPng(result.svg, { width: args.pngWidth ?? result.width })\n            : Buffer.from(result.svg, 'utf8');\n        await writeFile(path, bytes);\n        meta.savedTo = path;\n        meta.bytes = bytes.length;\n      }\n\n      if (format === 'svg') {\n        if (result.svg.length <= maxInline && !saveTo) {\n          content.push({\n            type: 'resource',\n            resource: {\n              uri: `creatica://render/${result.structure}/${result.seed}.svg`,\n              mimeType: 'image/svg+xml',\n              text: result.svg,\n            },\n          });\n        } else if (!saveTo && !hosted) {\n          meta.note = `SVG is ${result.svg.length} bytes; pass saveTo to write it to disk instead of returning it inline.`;\n        }\n      }\n\n      // Always attach a PNG preview so the model can see what it made. Keep\n      // it modest: previews are for judging composition, not final delivery.\n      const previewWidth = Math.min(args.pngWidth ?? 800, 1200);\n      const png = await renderPng(result.svg, { width: previewWidth });\n      if (png.length <= maxInline) {\n        content.push({\n          type: 'image',\n          data: png.toString('base64'),\n          mimeType: 'image/png',\n        });\n      } else {\n        const small = await renderPng(result.svg, { width: 480 });\n        content.push({\n          type: 'image',\n          data: small.toString('base64'),\n          mimeType: 'image/png',\n        });\n        meta.note = `Preview downscaled to 480px (full PNG would be ${png.length} bytes).`;\n      }\n\n      content.unshift({ type: 'text', text: JSON.stringify(meta, null, 2) });\n      return { content };\n    },\n  );\n\n  return server;\n}\n\nexport function renderUrl(\n  baseUrl: string,\n  req: RenderRequest,\n  format: 'svg' | 'png',\n): string {\n  const u = new URL(\n    `/v1/render/${encodeURIComponent(req.structure)}.${format}`,\n    baseUrl,\n  );\n  if (req.seed !== undefined) u.searchParams.set('seed', String(req.seed));\n  if (req.width) u.searchParams.set('width', String(req.width));\n  if (req.height) u.searchParams.set('height', String(req.height));\n  for (const [k, v] of Object.entries(req.palette ?? {})) {\n    if (v === undefined) continue;\n    u.searchParams.set(k, Array.isArray(v) ? v.join(',') : String(v));\n  }\n  for (const [k, v] of Object.entries(req.shape ?? {})) {\n    if (v !== undefined) u.searchParams.set(k, String(v));\n  }\n  return u.toString();\n}\n\nfunction json(value: unknown): CallToolResult {\n  return { content: [{ type: 'text', text: JSON.stringify(value, null, 2) }] };\n}\nfunction text(value: string): CallToolResult {\n  return { content: [{ type: 'text', text: value }] };\n}\nfunction error(message: string): CallToolResult {\n  return { isError: true, content: [{ type: 'text', text: message }] };\n}\n"],"mappings":"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","names":["server"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@creatica/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Creatica: let AI agents browse, describe and generate procedural SVG/PNG backgrounds on demand.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "creatica-mcp": "./dist/stdio.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "start": "node dist/stdio.js"
+  },
+  "dependencies": {
+    "@creatica/engine": "0.1.0",
+    "@creatica/schema": "0.1.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^4.5.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anup-a/web-backgrounds",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://creatica.app",
+  "keywords": [
+    "svg",
+    "background",
+    "generator",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "design",
+    "procedural"
+  ],
+  "engines": {
+    "node": ">=20"
+  }
+}