@wizeworks/silicaui-mcp 0.3.0

package/dist/data/packages.json

@@ -0,0 +1,63 @@
+[
+  {
+    "name": "@wizeworks/silicaui",
+    "purpose": "Tailwind v4 plugin — design tokens + component CSS classes (the vocabulary every other package builds on).",
+    "install": "pnpm add -D @wizeworks/silicaui tailwindcss",
+    "version": "0.3.0"
+  },
+  {
+    "name": "@wizeworks/silicaui-react",
+    "purpose": "Typed React components over the @wizeworks/silicaui classes, built on Base UI.",
+    "install": "pnpm add @wizeworks/silicaui-react",
+    "version": "0.3.0"
+  },
+  {
+    "name": "@wizeworks/silicaui-html",
+    "purpose": "Framework-neutral node-tree schema + HTML projection + composed blocks (for non-React output).",
+    "install": "pnpm add @wizeworks/silicaui-html",
+    "version": "0.3.0"
+  },
+  {
+    "name": "@wizeworks/silicaui-behaviors",
+    "purpose": "Zero-dependency runtime that hydrates data-sui-* markers with interactivity (the vanilla-JS counterpart to @wizeworks/silicaui-react's Base UI behavior).",
+    "install": "pnpm add @wizeworks/silicaui-behaviors",
+    "version": "0.3.0"
+  },
+  {
+    "name": "@wizeworks/silicaui-builder",
+    "purpose": "The visual document editor/engine used to build the SilicaUI sitebuilder itself — not typically installed by app developers.",
+    "install": null,
+    "private": true,
+    "version": "0.3.0"
+  },
+  {
+    "name": "@wizeworks/silicaui-charts",
+    "purpose": "Apache ECharts wrapped and auto-themed to Silica's design tokens.",
+    "install": "pnpm add @wizeworks/silicaui-charts @wizeworks/silicaui-react",
+    "version": "0.3.0"
+  },
+  {
+    "name": "@wizeworks/silicaui-table",
+    "purpose": "TanStack Table wrapped in Silica's table CSS.",
+    "install": "pnpm add @wizeworks/silicaui-table @wizeworks/silicaui-react",
+    "version": "0.3.0"
+  },
+  {
+    "name": "@wizeworks/silicaui-editor",
+    "purpose": "TipTap rich-text editor with a Silica-styled toolbar.",
+    "install": "pnpm add @wizeworks/silicaui-editor @wizeworks/silicaui-react",
+    "version": "0.3.0"
+  },
+  {
+    "name": "@wizeworks/silicaui-dnd",
+    "purpose": "dnd-kit wrapped — SortableList + drag primitives.",
+    "install": "pnpm add @wizeworks/silicaui-dnd @wizeworks/silicaui-react",
+    "version": "0.3.0"
+  },
+  {
+    "name": "@wizeworks/silicaui-panels",
+    "purpose": "react-resizable-panels wrapped in Silica styling.",
+    "install": "pnpm add @wizeworks/silicaui-panels @wizeworks/silicaui-react",
+    "version": "0.3.0"
+  }
+]

package/dist/data/tokens.json

@@ -0,0 +1,65 @@
+{
+  "semanticColors": [
+    "primary",
+    "secondary",
+    "accent",
+    "neutral",
+    "info",
+    "success",
+    "warning",
+    "error"
+  ],
+  "light": {
+    "base-100": "oklch(98% 0.003 250)",
+    "base-200": "oklch(95% 0.004 250)",
+    "base-300": "oklch(90% 0.006 250)",
+    "base-content": "oklch(21% 0.012 255)",
+    "primary": "oklch(42% 0.055 252)",
+    "primary-content": "oklch(98% 0.004 250)",
+    "secondary": "oklch(55% 0.035 255)",
+    "secondary-content": "oklch(98% 0.004 250)",
+    "accent": "oklch(64% 0.13 211)",
+    "accent-content": "oklch(15% 0.02 255)",
+    "neutral": "oklch(26% 0.014 255)",
+    "neutral-content": "oklch(95% 0.004 250)",
+    "info": "oklch(68% 0.1 232)",
+    "info-content": "oklch(16% 0.03 232)",
+    "success": "oklch(70% 0.12 150)",
+    "success-content": "oklch(18% 0.03 150)",
+    "warning": "oklch(80% 0.11 85)",
+    "warning-content": "oklch(24% 0.04 85)",
+    "error": "oklch(58% 0.17 25)",
+    "error-content": "oklch(97% 0.01 25)"
+  },
+  "dark": {
+    "base-100": "oklch(16% 0.01 255)",
+    "base-200": "oklch(13.5% 0.01 255)",
+    "base-300": "oklch(11% 0.01 255)",
+    "base-content": "oklch(93% 0.006 250)",
+    "primary": "oklch(72% 0.06 252)",
+    "primary-content": "oklch(14% 0.015 255)",
+    "secondary": "oklch(78% 0.035 255)",
+    "secondary-content": "oklch(15% 0.015 255)",
+    "accent": "oklch(72% 0.13 211)",
+    "accent-content": "oklch(14% 0.02 255)",
+    "neutral": "oklch(32% 0.016 255)",
+    "neutral-content": "oklch(93% 0.006 250)",
+    "info": "oklch(74% 0.09 232)",
+    "info-content": "oklch(14% 0.03 232)",
+    "success": "oklch(75% 0.11 150)",
+    "success-content": "oklch(14% 0.03 150)",
+    "warning": "oklch(83% 0.1 85)",
+    "warning-content": "oklch(16% 0.04 85)",
+    "error": "oklch(66% 0.18 25)",
+    "error-content": "oklch(14% 0.03 25)"
+  },
+  "typography": {
+    "baseFontSize": "100% (≈16px) — an explicit anchor, not the UA default by accident; the whole rem-based type scale (text-md = 1rem) scales with it.",
+    "fontFamilyTokens": [
+      "--font-sans",
+      "--font-serif",
+      "--font-mono"
+    ],
+    "note": "Every non-namespace token (--size-field, --border, --depth, --duration, --ease, --focus-width, --focus-offset, --disabled-opacity, --noise, …) carries its default inline via var(--token, default) in each component, so an app's own :root/@theme override always wins."
+  }
+}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+declare function createServer(): McpServer;
+declare function main(): Promise<void>;
+
+export { createServer, main };

package/dist/server.js

@@ -0,0 +1,240 @@
+import { readFileSync } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+// src/server.ts
+var here = path.dirname(fileURLToPath(import.meta.url));
+var dataDir = path.join(here, "data");
+function loadJson(name) {
+  return JSON.parse(readFileSync(path.join(dataDir, `${name}.json`), "utf8"));
+}
+var packages = loadJson("packages");
+var tokens = loadJson("tokens");
+var classesByComponent = loadJson("classes");
+var blocks = loadJson("blocks");
+var behaviors = loadJson("behaviors");
+var components = loadJson("components");
+function toKebab(name) {
+  return name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+}
+function blockSummary(b) {
+  const { root: _root, ...summary } = b;
+  return summary;
+}
+function createServer() {
+  const server = new McpServer({
+    name: "@wizeworks/silicaui-mcp",
+    version: "0.1.0"
+  });
+  server.registerTool(
+    "list_packages",
+    {
+      title: "List Silica UI packages",
+      description: "List every package in the Silica UI family (@wizeworks/silicaui, @wizeworks/silicaui-react, @wizeworks/silicaui-html, @wizeworks/silicaui-behaviors, and the wrapper packages), with purpose, install command, and version.",
+      inputSchema: {}
+    },
+    async () => ({
+      content: [{ type: "text", text: JSON.stringify(packages, null, 2) }]
+    })
+  );
+  server.registerTool(
+    "list_components",
+    {
+      title: "List Silica UI components",
+      description: "List component names, categories, and source packages. Optionally filter to one package (e.g. '@wizeworks/silicaui-react', '@wizeworks/silicaui-charts').",
+      inputSchema: {
+        package: z.string().optional().describe("Filter to one package name, e.g. '@wizeworks/silicaui-react'.")
+      }
+    },
+    async ({ package: pkg }) => {
+      const filtered = pkg ? components.filter((c) => c.package === pkg) : components;
+      const summary = filtered.map(({ name, package: p, category, sourceFile }) => ({
+        name,
+        package: p,
+        category,
+        sourceFile
+      }));
+      return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "get_component",
+    {
+      title: "Get a Silica UI component's real props and usage example",
+      description: "Get a component's props (name, type, optional, doc \u2014 extracted from its actual TypeScript source) and a real, working usage example pulled from the playground demos. Use this instead of guessing prop names or shapes.",
+      inputSchema: {
+        name: z.string().describe("Component name, e.g. 'Button', 'DataTable', 'Select'.")
+      }
+    },
+    async ({ name }) => {
+      const component = components.find((c) => c.name.toLowerCase() === name.toLowerCase());
+      if (!component) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `No component named "${name}". Call list_components to see valid names.`
+            }
+          ],
+          isError: true
+        };
+      }
+      return { content: [{ type: "text", text: JSON.stringify(component, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "list_classes",
+    {
+      title: "List real Silica UI CSS class names",
+      description: "List the exact, literal CSS class names Silica UI generates for a core component (e.g. 'button', 'card', 'badge') \u2014 or all components if none given. These are extracted directly from the class generators, so they are never hallucinated. Also covers 'color-utilities' (text-*/bg-*/border-* for every declared color).",
+      inputSchema: {
+        component: z.string().optional().describe("A core @wizeworks/silicaui component name, e.g. 'button'. Omit to list every component's classes.")
+      }
+    },
+    async ({ component }) => {
+      if (!component) {
+        return { content: [{ type: "text", text: JSON.stringify(classesByComponent, null, 2) }] };
+      }
+      const key = toKebab(component);
+      const classes = classesByComponent[key];
+      if (!classes) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `No class data for "${component}". Known components: ${Object.keys(classesByComponent).join(", ")}`
+            }
+          ],
+          isError: true
+        };
+      }
+      return { content: [{ type: "text", text: JSON.stringify({ component: key, classes }, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "get_tokens",
+    {
+      title: "Get Silica UI design tokens",
+      description: "Get the semantic color list and their light/dark OKLCH values, plus the typography token model.",
+      inputSchema: {}
+    },
+    async () => ({ content: [{ type: "text", text: JSON.stringify(tokens, null, 2) }] })
+  );
+  server.registerTool(
+    "list_blocks",
+    {
+      title: "List Silica UI composed blocks",
+      description: "List composed page blocks from @wizeworks/silicaui-html (hero sections, FAQs, feature grids, \u2026) without their full node tree. Optionally filter by category or tag.",
+      inputSchema: {
+        category: z.string().optional(),
+        tag: z.string().optional()
+      }
+    },
+    async ({ category, tag }) => {
+      const filtered = blocks.filter(
+        (b) => (!category || b.category === category) && (!tag || (b.tags ?? []).includes(tag))
+      );
+      return { content: [{ type: "text", text: JSON.stringify(filtered.map(blockSummary), null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "get_block",
+    {
+      title: "Get a Silica UI block's full node tree",
+      description: "Get one composed block's full definition, including its node tree \u2014 the real, validated structure to reuse or adapt, not a guess.",
+      inputSchema: {
+        key: z.string().describe("The block's stable key, e.g. 'hero_split_cta'.")
+      }
+    },
+    async ({ key }) => {
+      const block = blocks.find((b) => b.key === key);
+      if (!block) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `No block "${key}". Known keys: ${blocks.map((b) => b.key).join(", ")}`
+            }
+          ],
+          isError: true
+        };
+      }
+      return { content: [{ type: "text", text: JSON.stringify(block, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "list_behaviors",
+    {
+      title: "List Silica UI behavior types",
+      description: "List the closed set of interactive behaviors (carousel, disclosure, tabs, menu, marquee, scrollspy, counter, dismiss, toc) that @wizeworks/silicaui-behaviors hydrates from data-sui-* markers.",
+      inputSchema: {}
+    },
+    async () => ({ content: [{ type: "text", text: JSON.stringify(behaviors, null, 2) }] })
+  );
+  server.registerTool(
+    "get_behavior",
+    {
+      title: "Get one Silica UI behavior's contract",
+      description: "Get the marker contract and semantics for one behavior type.",
+      inputSchema: {
+        type: z.string().describe("Behavior type, e.g. 'disclosure'.")
+      }
+    },
+    async ({ type }) => {
+      const behavior = behaviors.find((b) => b.type === type);
+      if (!behavior) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `No behavior "${type}". Known types: ${behaviors.map((b) => b.type).join(", ")}`
+            }
+          ],
+          isError: true
+        };
+      }
+      return { content: [{ type: "text", text: JSON.stringify(behavior, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "search_docs",
+    {
+      title: "Search Silica UI catalog data",
+      description: "Full-text search across everything this server knows: component names/descriptions, block names/descriptions, behavior descriptions, literal CSS class names, and design tokens. Use this when you don't know the exact name to look up.",
+      inputSchema: {
+        query: z.string().describe("Search term, case-insensitive.")
+      }
+    },
+    async ({ query }) => {
+      const q = query.toLowerCase();
+      const matchedComponents = components.filter((c) => c.name.toLowerCase().includes(q) || c.description.toLowerCase().includes(q)).map((c) => ({ kind: "component", name: c.name, package: c.package }));
+      const matchedBlocks = blocks.filter((b) => b.name.toLowerCase().includes(q) || b.description.toLowerCase().includes(q)).map((b) => ({ kind: "block", key: b.key, name: b.name }));
+      const matchedBehaviors = behaviors.filter((b) => b.type.toLowerCase().includes(q) || b.description.toLowerCase().includes(q)).map((b) => ({ kind: "behavior", type: b.type }));
+      const matchedClasses = Object.entries(classesByComponent).flatMap(
+        ([component, classes]) => classes.filter((cls) => cls.toLowerCase().includes(q)).map((cls) => ({ kind: "class", component, class: cls }))
+      );
+      const matchedTokens = tokens.semanticColors.filter((name) => name.toLowerCase().includes(q)).map((name) => ({ kind: "token", name }));
+      const results = [
+        ...matchedComponents,
+        ...matchedBlocks,
+        ...matchedBehaviors,
+        ...matchedClasses,
+        ...matchedTokens
+      ];
+      return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
+    }
+  );
+  return server;
+}
+async function main() {
+  const server = createServer();
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+export { createServer, main };
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"names":[],"mappings":"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","file":"server.js","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\n\nconst here = path.dirname(fileURLToPath(import.meta.url));\nconst dataDir = path.join(here, \"data\");\n\nfunction loadJson<T>(name: string): T {\n  return JSON.parse(readFileSync(path.join(dataDir, `${name}.json`), \"utf8\")) as T;\n}\n\ninterface PackageMeta {\n  name: string;\n  purpose: string;\n  install: string | null;\n  private?: boolean;\n  version: string;\n}\n\ninterface TokensData {\n  semanticColors: string[];\n  light: Record<string, string>;\n  dark: Record<string, string>;\n  typography: { baseFontSize: string; fontFamilyTokens: string[]; note: string };\n}\n\ninterface PropMember {\n  name: string;\n  optional: boolean;\n  type: string;\n  doc: string;\n}\n\ninterface PropsInterface {\n  name: string;\n  extends?: string;\n  members: PropMember[];\n}\n\ninterface ComponentData {\n  name: string;\n  package: string;\n  category: string;\n  sourceFile: string;\n  description: string;\n  props: PropsInterface[];\n  usageExample: string | null;\n}\n\ninterface BlockSlot {\n  name: string;\n  [key: string]: unknown;\n}\n\ninterface BlockData {\n  key: string;\n  name: string;\n  category: string;\n  version: string;\n  description: string;\n  tags?: string[];\n  colors: string[];\n  behaviors: string[];\n  emailEligible: boolean;\n  slots: BlockSlot[];\n  root: unknown;\n  preview?: unknown;\n}\n\ninterface BehaviorData {\n  type: string;\n  description: string;\n}\n\nconst packages = loadJson<PackageMeta[]>(\"packages\");\nconst tokens = loadJson<TokensData>(\"tokens\");\nconst classesByComponent = loadJson<Record<string, string[]>>(\"classes\");\nconst blocks = loadJson<BlockData[]>(\"blocks\");\nconst behaviors = loadJson<BehaviorData[]>(\"behaviors\");\nconst components = loadJson<ComponentData[]>(\"components\");\n\nfunction toKebab(name: string): string {\n  return name\n    .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n    .toLowerCase();\n}\n\nfunction blockSummary(b: BlockData) {\n  const { root: _root, ...summary } = b;\n  return summary;\n}\n\nexport function createServer(): McpServer {\n  const server = new McpServer({\n    name: \"@wizeworks/silicaui-mcp\",\n    version: \"0.1.0\",\n  });\n\n  server.registerTool(\n    \"list_packages\",\n    {\n      title: \"List Silica UI packages\",\n      description:\n        \"List every package in the Silica UI family (@wizeworks/silicaui, @wizeworks/silicaui-react, @wizeworks/silicaui-html, @wizeworks/silicaui-behaviors, and the wrapper packages), with purpose, install command, and version.\",\n      inputSchema: {},\n    },\n    async () => ({\n      content: [{ type: \"text\", text: JSON.stringify(packages, null, 2) }],\n    }),\n  );\n\n  server.registerTool(\n    \"list_components\",\n    {\n      title: \"List Silica UI components\",\n      description:\n        \"List component names, categories, and source packages. Optionally filter to one package (e.g. '@wizeworks/silicaui-react', '@wizeworks/silicaui-charts').\",\n      inputSchema: {\n        package: z.string().optional().describe(\"Filter to one package name, e.g. '@wizeworks/silicaui-react'.\"),\n      },\n    },\n    async ({ package: pkg }) => {\n      const filtered = pkg ? components.filter((c) => c.package === pkg) : components;\n      const summary = filtered.map(({ name, package: p, category, sourceFile }) => ({\n        name,\n        package: p,\n        category,\n        sourceFile,\n      }));\n      return { content: [{ type: \"text\", text: JSON.stringify(summary, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"get_component\",\n    {\n      title: \"Get a Silica UI component's real props and usage example\",\n      description:\n        \"Get a component's props (name, type, optional, doc — extracted from its actual TypeScript source) and a real, working usage example pulled from the playground demos. Use this instead of guessing prop names or shapes.\",\n      inputSchema: {\n        name: z.string().describe(\"Component name, e.g. 'Button', 'DataTable', 'Select'.\"),\n      },\n    },\n    async ({ name }) => {\n      const component = components.find((c) => c.name.toLowerCase() === name.toLowerCase());\n      if (!component) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No component named \"${name}\". Call list_components to see valid names.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify(component, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"list_classes\",\n    {\n      title: \"List real Silica UI CSS class names\",\n      description:\n        \"List the exact, literal CSS class names Silica UI generates for a core component (e.g. 'button', 'card', 'badge') — or all components if none given. These are extracted directly from the class generators, so they are never hallucinated. Also covers 'color-utilities' (text-*/bg-*/border-* for every declared color).\",\n      inputSchema: {\n        component: z\n          .string()\n          .optional()\n          .describe(\"A core @wizeworks/silicaui component name, e.g. 'button'. Omit to list every component's classes.\"),\n      },\n    },\n    async ({ component }) => {\n      if (!component) {\n        return { content: [{ type: \"text\", text: JSON.stringify(classesByComponent, null, 2) }] };\n      }\n      const key = toKebab(component);\n      const classes = classesByComponent[key];\n      if (!classes) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No class data for \"${component}\". Known components: ${Object.keys(classesByComponent).join(\", \")}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify({ component: key, classes }, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"get_tokens\",\n    {\n      title: \"Get Silica UI design tokens\",\n      description:\n        \"Get the semantic color list and their light/dark OKLCH values, plus the typography token model.\",\n      inputSchema: {},\n    },\n    async () => ({ content: [{ type: \"text\", text: JSON.stringify(tokens, null, 2) }] }),\n  );\n\n  server.registerTool(\n    \"list_blocks\",\n    {\n      title: \"List Silica UI composed blocks\",\n      description:\n        \"List composed page blocks from @wizeworks/silicaui-html (hero sections, FAQs, feature grids, …) without their full node tree. Optionally filter by category or tag.\",\n      inputSchema: {\n        category: z.string().optional(),\n        tag: z.string().optional(),\n      },\n    },\n    async ({ category, tag }) => {\n      const filtered = blocks.filter(\n        (b) => (!category || b.category === category) && (!tag || (b.tags ?? []).includes(tag)),\n      );\n      return { content: [{ type: \"text\", text: JSON.stringify(filtered.map(blockSummary), null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"get_block\",\n    {\n      title: \"Get a Silica UI block's full node tree\",\n      description:\n        \"Get one composed block's full definition, including its node tree — the real, validated structure to reuse or adapt, not a guess.\",\n      inputSchema: {\n        key: z.string().describe(\"The block's stable key, e.g. 'hero_split_cta'.\"),\n      },\n    },\n    async ({ key }) => {\n      const block = blocks.find((b) => b.key === key);\n      if (!block) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No block \"${key}\". Known keys: ${blocks.map((b) => b.key).join(\", \")}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify(block, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"list_behaviors\",\n    {\n      title: \"List Silica UI behavior types\",\n      description:\n        \"List the closed set of interactive behaviors (carousel, disclosure, tabs, menu, marquee, scrollspy, counter, dismiss, toc) that @wizeworks/silicaui-behaviors hydrates from data-sui-* markers.\",\n      inputSchema: {},\n    },\n    async () => ({ content: [{ type: \"text\", text: JSON.stringify(behaviors, null, 2) }] }),\n  );\n\n  server.registerTool(\n    \"get_behavior\",\n    {\n      title: \"Get one Silica UI behavior's contract\",\n      description: \"Get the marker contract and semantics for one behavior type.\",\n      inputSchema: {\n        type: z.string().describe(\"Behavior type, e.g. 'disclosure'.\"),\n      },\n    },\n    async ({ type }) => {\n      const behavior = behaviors.find((b) => b.type === type);\n      if (!behavior) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No behavior \"${type}\". Known types: ${behaviors.map((b) => b.type).join(\", \")}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify(behavior, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"search_docs\",\n    {\n      title: \"Search Silica UI catalog data\",\n      description:\n        \"Full-text search across everything this server knows: component names/descriptions, block names/descriptions, behavior descriptions, literal CSS class names, and design tokens. Use this when you don't know the exact name to look up.\",\n      inputSchema: {\n        query: z.string().describe(\"Search term, case-insensitive.\"),\n      },\n    },\n    async ({ query }) => {\n      const q = query.toLowerCase();\n      const matchedComponents = components\n        .filter((c) => c.name.toLowerCase().includes(q) || c.description.toLowerCase().includes(q))\n        .map((c) => ({ kind: \"component\", name: c.name, package: c.package }));\n      const matchedBlocks = blocks\n        .filter((b) => b.name.toLowerCase().includes(q) || b.description.toLowerCase().includes(q))\n        .map((b) => ({ kind: \"block\", key: b.key, name: b.name }));\n      const matchedBehaviors = behaviors\n        .filter((b) => b.type.toLowerCase().includes(q) || b.description.toLowerCase().includes(q))\n        .map((b) => ({ kind: \"behavior\", type: b.type }));\n      const matchedClasses = Object.entries(classesByComponent).flatMap(([component, classes]) =>\n        classes\n          .filter((cls) => cls.toLowerCase().includes(q))\n          .map((cls) => ({ kind: \"class\" as const, component, class: cls })),\n      );\n      const matchedTokens = tokens.semanticColors\n        .filter((name) => name.toLowerCase().includes(q))\n        .map((name) => ({ kind: \"token\" as const, name }));\n      const results = [\n        ...matchedComponents,\n        ...matchedBlocks,\n        ...matchedBehaviors,\n        ...matchedClasses,\n        ...matchedTokens,\n      ];\n      return { content: [{ type: \"text\", text: JSON.stringify(results, null, 2) }] };\n    },\n  );\n\n  return server;\n}\n\nexport async function main(): Promise<void> {\n  const server = createServer();\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@wizeworks/silicaui-mcp",
+  "version": "0.3.0",
+  "description": "A local MCP server that lets AI coding assistants query the Silica UI design system — real class names, component props, blocks, and behaviors — instead of guessing.",
+  "type": "module",
+  "license": "MIT",
+  "author": "WizeWorks",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/silicaui/silicaui.git",
+    "directory": "packages/silicaui-mcp"
+  },
+  "homepage": "https://silicaui.com",
+  "bugs": "https://github.com/silicaui/silicaui/issues",
+  "sideEffects": false,
+  "bin": {
+    "silicaui-mcp": "bin/silicaui-mcp.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    }
+  },
+  "main": "./dist/server.js",
+  "types": "./dist/server.d.ts",
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "design-system",
+    "silica",
+    "ai",
+    "claude"
+  ],
+  "scripts": {
+    "gen": "node scripts/gen-catalog.mjs",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "verify": "node verify.mjs"
+  }
+}