@wizeworks/silicaui-mcp 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WizeWorks
+
+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,88 @@
+# @wizeworks/silicaui-mcp
+
+A local [MCP](https://modelcontextprotocol.io) server for **Silica UI**. It gives
+your AI coding assistant real, extracted-from-source answers about the design
+system — exact CSS class names, real component props, working usage examples,
+composed blocks, and the behavior contract — instead of guessing.
+
+[![Website](https://img.shields.io/badge/website-silicaui.com-8b5cf6?style=flat-square)](https://silicaui.com)
+[![npm version](https://img.shields.io/npm/v/@wizeworks/silicaui-mcp.svg?style=flat-square)](https://www.npmjs.com/package/@wizeworks/silicaui-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/@wizeworks/silicaui-mcp.svg?style=flat-square)](https://www.npmjs.com/package/@wizeworks/silicaui-mcp)
+[![license](https://img.shields.io/npm/l/@wizeworks/silicaui-mcp.svg?style=flat-square)](https://github.com/silicaui/silicaui/blob/main/LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/silicaui/silicaui/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/silicaui/silicaui/actions/workflows/ci.yml)
+
+## Why
+
+Every class name, prop, and usage example this server returns is **extracted
+from Silica UI's actual source** at release time — never hand-written prose that
+can drift out of date. `list_classes("button")` calls the real class generator;
+`get_component("Select")` reads the real TypeScript props and a real, working
+playground demo. If your assistant is about to write `<Button intent="primary">`
+or `btn-purple`, this catches it before it ships.
+
+## Install
+
+**Claude Code:**
+
+```bash
+claude mcp add @wizeworks/silicaui -- npx -y @wizeworks/silicaui-mcp
+```
+
+**Claude Desktop / other `.mcp.json`-style clients** — add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "@wizeworks/silicaui": {
+      "command": "npx",
+      "args": ["-y", "@wizeworks/silicaui-mcp"]
+    }
+  }
+}
+```
+
+**Cursor** — Settings → MCP → Add new MCP server, same command/args as above, or
+add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "@wizeworks/silicaui": {
+      "command": "npx",
+      "args": ["-y", "@wizeworks/silicaui-mcp"]
+    }
+  }
+}
+```
+
+No API key, account, or network access required after install — everything the
+server answers with is bundled in the package.
+
+## Tools
+
+| Tool | Purpose |
+| --- | --- |
+| `list_packages` | The Silica UI package family, purpose, install command, version. |
+| `list_components({ package? })` | Component names + categories, optionally filtered to one package. |
+| `get_component({ name })` | A component's real props (from source) + a real usage example (from the playground). |
+| `list_classes({ component? })` | Exact, literal CSS class names — extracted from the actual class generators. |
+| `get_tokens()` | Semantic color list, light/dark values, typography tokens. |
+| `list_blocks({ category?, tag? })` | Composed page blocks (hero, FAQ, feature grid, …), summary only. |
+| `get_block({ key })` | One block's full node tree. |
+| `list_behaviors()` / `get_behavior({ type })` | The `data-sui-*` interactive-behavior contract. |
+| `search_docs({ query })` | Free-text search across components, blocks, and behaviors. |
+
+## A note on versioning
+
+This server ships a **static catalog**, regenerated from the Silica UI monorepo
+and published in step with the rest of the family. It doesn't read your
+project's actual installed `@wizeworks/silicaui` version — for the fast-moving, mostly
+additive pre-1.0 stage that's a fine trade for zero setup and zero dependency on
+your project's module resolution. If you're pinned to an older Silica UI
+version and hit a mismatch, pin `@wizeworks/silicaui-mcp` to a matching release too.
+
+## Links
+
+- [silicaui.com](https://silicaui.com) — website & docs
+- [GitHub repo](https://github.com/silicaui/silicaui)
+- [Issues](https://github.com/silicaui/silicaui/issues)

package/bin/silicaui-mcp.mjs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { main } from "../dist/server.js";
+
+main().catch((err) => {
+  console.error("[@wizeworks/silicaui-mcp] fatal:", err);
+  process.exit(1);
+});

package/dist/data/behaviors.json

@@ -0,0 +1,46 @@
+[
+  {
+    "type": "carousel",
+    "description": "`carousel` — a `track` of `slide`s with optional `prev`/`next` buttons and `dot` pagination. `params.autoplay` (+ `params.interval`, default 5000ms) advances automatically, pausing on hover; suppressed entirely in preview and when the user prefers reduced motion (§7, §9.8)."
+  },
+  {
+    "type": "disclosure",
+    "description": "`disclosure` — trigger/panel pairs, correlated by document order (architecture §7: \"parts correlate to their root by structural nesting, never by id\"). With `params.single`, opening one pair closes every other pair under the same root (single-open accordion); otherwise each pair toggles independently."
+  },
+  {
+    "type": "tabs",
+    "description": "`tabs` — a `tab`/`panel` list, exclusive selection, with roving arrow-key navigation (Left/Right, Up/Down, Home/End) per the standard tabs pattern. Pairing is positional (Nth `tab` ↔ Nth `panel`), same nesting-scoped lookup as `disclosure`."
+  },
+  {
+    "type": "menu",
+    "description": "`menu` — a click-triggered popup (dropdown/mega-menu): a `trigger` opens a `panel` of `item` parts. Escape and outside-click dismiss; Up/Down/Home/End rove focus across items while open. This is the vanilla counterpart to @wizeworks/silicaui-react's Base-UI-backed `DropdownMenu` — same authored markers, same `.dropdown*` classes, no React required."
+  },
+  {
+    "type": "marquee",
+    "description": "`marquee` — an auto-scrolling ticker. The motion itself is a CSS animation authored on the component (§7 prefers CSS-only where it suffices); this handler only wires `params.pauseOnHover` (default `true`) and keeps the animation paused for editor preview, matching the autoplay-suppression rule (§9.8) without a JS animation loop of its own."
+  },
+  {
+    "type": "scrollspy",
+    "description": "Shared implementation behind `scrollspy` and `toc`: `spy` parts are links (`href=\"#id\"`) tracked against the section they point to; the in-view one gets `aria-current=\"true\"` for a nav/TOC to style. `toc` differs only in its default intersection threshold (a smaller sliver of a heading counts as \"current\" for a table of contents than a full scrollspy section does)."
+  },
+  {
+    "type": "counter",
+    "description": "`counter` — animates the root's own text content from 0 to a target number once it scrolls into view. `params.target` overrides the parsed initial text (so authored content can show the final value statically); `duration` defaults to 1500ms. Suppressed (jumps straight to the final value) in preview, under reduced motion, or without `IntersectionObserver`."
+  },
+  {
+    "type": "dismiss",
+    "description": "`dismiss` — a self-dismissing widget (alert, toast): clicking its `trigger` hides or removes the root. `params.remove` (default `true`) removes the element outright; `false` just sets `hidden` (e.g. to keep layout stable)."
+  },
+  {
+    "type": "toc",
+    "description": "Shared implementation behind `scrollspy` and `toc`: `spy` parts are links (`href=\"#id\"`) tracked against the section they point to; the in-view one gets `aria-current=\"true\"` for a nav/TOC to style. `toc` differs only in its default intersection threshold (a smaller sliver of a heading counts as \"current\" for a table of contents than a full scrollspy section does)."
+  },
+  {
+    "type": "sidebar",
+    "description": "`sidebar` — a persistent nav panel that collapses IN PLACE to an icon rail (unlike `disclosure`, the root is never hidden — only its `data-collapsed` state changes, and CSS alone handles the width/label transition). Any number of `trigger` parts nested inside the root toggle it; `params.defaultCollapsed` seeds the initial state."
+  },
+  {
+    "type": "selection-list",
+    "description": "`selection-list` — a listbox of `item` parts (single- or multi-select, via `params.multiple`). Click (or Enter/Space on the focused item) toggles selection; the vanilla counterpart to @wizeworks/silicaui-react's `SelectionList`. Roving tabindex + ↑/↓/Home/End mirror the React component's keyboard behavior."
+  }
+]