@udixio/mcp 0.3.2

package/README.md

@@ -0,0 +1,127 @@
+# @udixio/mcp
+
+Model Context Protocol (MCP) server for the Udixio UI Design System. This package exposes tools and resources to interact with the UI library documentation and theme tokens.
+
+## Installation
+
+```bash
+npm install @udixio/mcp
+# or
+pnpm add @udixio/mcp
+```
+
+## Usage
+
+### Running the MCP Server
+
+```bash
+# Development
+pnpm dev
+
+# Production
+pnpm start
+```
+
+The server runs on `http://localhost:3000/mcp` by default.
+
+### Configuring with Claude Desktop
+
+Add to your Claude Desktop configuration (`~/.config/claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "udixio-ui": {
+      "command": "npx",
+      "args": ["@udixio/mcp"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Components
+
+| Tool | Description |
+|------|-------------|
+| `listComponents` | Lists all available UI components |
+| `getComponentDoc` | Gets documentation for a specific component (props, examples, links) |
+
+### Documentation
+
+| Tool | Description |
+|------|-------------|
+| `searchDocs` | Full-text search in the documentation |
+
+### Theme
+
+| Tool | Description |
+|------|-------------|
+| `getThemeTokens` | Gets all theme tokens (config, light/dark colors, palettes) |
+| `getThemeConfig` | Gets theme configuration (sourceColor, contrastLevel, variant) |
+| `listColors` | Lists all available colors in the theme |
+| `getColor` | Gets details of a specific color (hex, tone) in light or dark mode |
+| `listPalettes` | Lists all color palettes (hue, chroma) |
+| `compareColor` | Compares a color between light and dark modes |
+
+## Available Resources
+
+| Resource | URI Pattern | Description |
+|----------|-------------|-------------|
+| `doc` | `doc://{path}` | Access documentation files |
+| `theme` | `theme://tokens` | Access complete theme tokens |
+
+## Example Queries
+
+### Get theme configuration
+```
+Tool: getThemeConfig
+```
+
+### Get a specific color in dark mode
+```
+Tool: getColor
+Input: { "name": "primary", "mode": "dark" }
+```
+
+### Compare primary color between modes
+```
+Tool: compareColor
+Input: { "name": "primary" }
+```
+
+### List all available palettes
+```
+Tool: listPalettes
+```
+
+## Building
+
+```bash
+pnpm build
+```
+
+## Development
+
+```bash
+# Run in development mode with hot reload
+pnpm dev
+
+# Run tests
+pnpm test
+```
+
+## Architecture
+
+The MCP server bundles documentation and theme data at build time via the `snapshot.ts` script. This allows the package to work standalone without requiring access to the full monorepo.
+
+### Bundled Assets
+
+- `bundled/doc-src/` - Documentation source files (md, mdx, astro)
+- `bundled/components-index.json` - Index of all UI components
+- `bundled/theme.json` - Complete theme snapshot with colors and palettes
+
+## License
+
+MIT

package/dist/bundled/components-index.json

@@ -0,0 +1,369 @@
+{
+  "count": 91,
+  "components": [
+    {
+      "name": "Button",
+      "file": "lib/components/Button.tsx"
+    },
+    {
+      "name": "Card",
+      "file": "lib/components/Card.tsx"
+    },
+    {
+      "name": "Carousel",
+      "file": "lib/components/Carousel.tsx"
+    },
+    {
+      "name": "CarouselItem",
+      "file": "lib/components/CarouselItem.tsx"
+    },
+    {
+      "name": "Checkbox",
+      "file": "lib/components/Checkbox.tsx"
+    },
+    {
+      "name": "Chip",
+      "file": "lib/components/Chip.tsx"
+    },
+    {
+      "name": "Chips",
+      "file": "lib/components/Chips.tsx"
+    },
+    {
+      "name": "DatePicker",
+      "file": "lib/components/DatePicker.tsx"
+    },
+    {
+      "name": "Divider",
+      "file": "lib/components/Divider.tsx"
+    },
+    {
+      "name": "Fab",
+      "file": "lib/components/Fab.tsx"
+    },
+    {
+      "name": "FabMenu",
+      "file": "lib/components/FabMenu.tsx"
+    },
+    {
+      "name": "IconButton",
+      "file": "lib/components/IconButton.tsx"
+    },
+    {
+      "name": "NavigationRail",
+      "file": "lib/components/NavigationRail.tsx"
+    },
+    {
+      "name": "NavigationRailSection",
+      "file": "lib/components/NavigationRailItem.tsx"
+    },
+    {
+      "name": "NavigationRailItem",
+      "file": "lib/components/NavigationRailItem.tsx"
+    },
+    {
+      "name": "ProgressIndicator",
+      "file": "lib/components/ProgressIndicator.tsx"
+    },
+    {
+      "name": "SideSheet",
+      "file": "lib/components/SideSheet.tsx"
+    },
+    {
+      "name": "Slider",
+      "file": "lib/components/Slider.tsx"
+    },
+    {
+      "name": "Snackbar",
+      "file": "lib/components/Snackbar.tsx"
+    },
+    {
+      "name": "Switch",
+      "file": "lib/components/Switch.tsx"
+    },
+    {
+      "name": "Tab",
+      "file": "lib/components/Tab.tsx"
+    },
+    {
+      "name": "TabGroup",
+      "file": "lib/components/TabGroup.tsx"
+    },
+    {
+      "name": "TabGroupContext",
+      "file": "lib/components/TabGroupContext.tsx"
+    },
+    {
+      "name": "TabPanel",
+      "file": "lib/components/TabPanel.tsx"
+    },
+    {
+      "name": "TabPanels",
+      "file": "lib/components/TabPanels.tsx"
+    },
+    {
+      "name": "Tabs",
+      "file": "lib/components/Tabs.tsx"
+    },
+    {
+      "name": "TextField",
+      "file": "lib/components/TextField.tsx"
+    },
+    {
+      "name": "Tooltip",
+      "file": "lib/components/Tooltip.tsx"
+    },
+    {
+      "name": "AnimateOnScrollInit",
+      "file": "lib/effects/AnimateOnScroll.ts"
+    },
+    {
+      "name": "State",
+      "file": "lib/effects/State.tsx"
+    },
+    {
+      "name": "SyncedFixedWrapper",
+      "file": "lib/effects/SyncedFixedWrapper.tsx"
+    },
+    {
+      "name": "ThemeProvider",
+      "file": "lib/effects/ThemeProvider.tsx"
+    },
+    {
+      "name": "BlockScroll",
+      "file": "lib/effects/block-scroll.effect.tsx"
+    },
+    {
+      "name": "CustomScroll",
+      "file": "lib/effects/custom-scroll/custom-scroll.effect.tsx"
+    },
+    {
+      "name": "SmoothScroll",
+      "file": "lib/effects/smooth-scroll.effect.tsx"
+    },
+    {
+      "name": "Icon",
+      "file": "lib/icon/icon.tsx"
+    },
+    {
+      "name": "Filled",
+      "file": "stories/action/button.stories.tsx"
+    },
+    {
+      "name": "Outlined",
+      "file": "stories/action/button.stories.tsx"
+    },
+    {
+      "name": "Text",
+      "file": "stories/action/button.stories.tsx"
+    },
+    {
+      "name": "Elevated",
+      "file": "stories/action/button.stories.tsx"
+    },
+    {
+      "name": "Tonal",
+      "file": "stories/action/button.stories.tsx"
+    },
+    {
+      "name": "Standard",
+      "file": "stories/action/icon-button.stories.tsx"
+    },
+    {
+      "name": "Filled",
+      "file": "stories/action/icon-button.stories.tsx"
+    },
+    {
+      "name": "Tonal",
+      "file": "stories/action/icon-button.stories.tsx"
+    },
+    {
+      "name": "Outlined",
+      "file": "stories/action/icon-button.stories.tsx"
+    },
+    {
+      "name": "StandardToggleable",
+      "file": "stories/action/icon-button.stories.tsx"
+    },
+    {
+      "name": "FilledToggleable",
+      "file": "stories/action/icon-button.stories.tsx"
+    },
+    {
+      "name": "TonalToggleable",
+      "file": "stories/action/icon-button.stories.tsx"
+    },
+    {
+      "name": "OutlinedToggleable",
+      "file": "stories/action/icon-button.stories.tsx"
+    },
+    {
+      "name": "LinearDeterminate",
+      "file": "stories/communication/ProgressIndicator.stories.tsx"
+    },
+    {
+      "name": "CircularIndeterminate",
+      "file": "stories/communication/ProgressIndicator.stories.tsx"
+    },
+    {
+      "name": "SingleLineSnackbar",
+      "file": "stories/communication/SnackBar.stories.tsx"
+    },
+    {
+      "name": "Plain",
+      "file": "stories/communication/tool-tip.stories.tsx"
+    },
+    {
+      "name": "PlainAuto",
+      "file": "stories/communication/tool-tip.stories.tsx"
+    },
+    {
+      "name": "Rich",
+      "file": "stories/communication/tool-tip.stories.tsx"
+    },
+    {
+      "name": "RichAuto",
+      "file": "stories/communication/tool-tip.stories.tsx"
+    },
+    {
+      "name": "Outlined",
+      "file": "stories/containment/card.stories.tsx"
+    },
+    {
+      "name": "Elevated",
+      "file": "stories/containment/card.stories.tsx"
+    },
+    {
+      "name": "Filled",
+      "file": "stories/containment/card.stories.tsx"
+    },
+    {
+      "name": "Horizontal",
+      "file": "stories/containment/divider.stories.tsx"
+    },
+    {
+      "name": "Vertical",
+      "file": "stories/containment/divider.stories.tsx"
+    },
+    {
+      "name": "Standard",
+      "file": "stories/containment/slide-sheet.stories.tsx"
+    },
+    {
+      "name": "Modal",
+      "file": "stories/containment/slide-sheet.stories.tsx"
+    },
+    {
+      "name": "SmoothScrollStory",
+      "file": "stories/effect/smooth-scroll.stories.tsx"
+    },
+    {
+      "name": "VerticalIconAndLabel",
+      "file": "stories/navigation/navigation-rail/navigation-rail-item.stories.tsx"
+    },
+    {
+      "name": "VerticalIconOnly",
+      "file": "stories/navigation/navigation-rail/navigation-rail-item.stories.tsx"
+    },
+    {
+      "name": "HorizontalIconAndLabel",
+      "file": "stories/navigation/navigation-rail/navigation-rail-item.stories.tsx"
+    },
+    {
+      "name": "HorizontalLabelOnly",
+      "file": "stories/navigation/navigation-rail/navigation-rail-item.stories.tsx"
+    },
+    {
+      "name": "PrimaryLabelOnly",
+      "file": "stories/navigation/navigation-rail/navigation-rail.stories.tsx"
+    },
+    {
+      "name": "PrimaryIconAndLabel",
+      "file": "stories/navigation/navigation-rail/navigation-rail.stories.tsx"
+    },
+    {
+      "name": "PrimaryIconOnly",
+      "file": "stories/navigation/navigation-rail/navigation-rail.stories.tsx"
+    },
+    {
+      "name": "SecondaryLabelOnly",
+      "file": "stories/navigation/navigation-rail/navigation-rail.stories.tsx"
+    },
+    {
+      "name": "SecondaryIconAndLabel",
+      "file": "stories/navigation/navigation-rail/navigation-rail.stories.tsx"
+    },
+    {
+      "name": "PrimaryIconAndLabel",
+      "file": "stories/navigation/tabs/tab.stories.tsx"
+    },
+    {
+      "name": "PrimaryIconOnly",
+      "file": "stories/navigation/tabs/tab.stories.tsx"
+    },
+    {
+      "name": "PrimaryLabelOnly",
+      "file": "stories/navigation/tabs/tab.stories.tsx"
+    },
+    {
+      "name": "SecondaryLabelOnly",
+      "file": "stories/navigation/tabs/tab.stories.tsx"
+    },
+    {
+      "name": "SecondaryIconAndLabel",
+      "file": "stories/navigation/tabs/tab.stories.tsx"
+    },
+    {
+      "name": "PrimaryLabelOnly",
+      "file": "stories/navigation/tabs/tabs.stories.tsx"
+    },
+    {
+      "name": "PrimaryIconAndLabel",
+      "file": "stories/navigation/tabs/tabs.stories.tsx"
+    },
+    {
+      "name": "PrimaryIconOnly",
+      "file": "stories/navigation/tabs/tabs.stories.tsx"
+    },
+    {
+      "name": "SecondaryLabelOnly",
+      "file": "stories/navigation/tabs/tabs.stories.tsx"
+    },
+    {
+      "name": "SecondaryIconAndLabel",
+      "file": "stories/navigation/tabs/tabs.stories.tsx"
+    },
+    {
+      "name": "Filled",
+      "file": "stories/text-inputs/text-field.stories.tsx"
+    },
+    {
+      "name": "FilledTrailingIcon",
+      "file": "stories/text-inputs/text-field.stories.tsx"
+    },
+    {
+      "name": "FilledLealingIconAndTrailingIcon",
+      "file": "stories/text-inputs/text-field.stories.tsx"
+    },
+    {
+      "name": "FilledLealingIcon",
+      "file": "stories/text-inputs/text-field.stories.tsx"
+    },
+    {
+      "name": "Outlined",
+      "file": "stories/text-inputs/text-field.stories.tsx"
+    },
+    {
+      "name": "OutlinedTrailingIcon",
+      "file": "stories/text-inputs/text-field.stories.tsx"
+    },
+    {
+      "name": "OutlinedLealingIconAndTrailingIcon",
+      "file": "stories/text-inputs/text-field.stories.tsx"
+    },
+    {
+      "name": "OutlinedLealingIcon",
+      "file": "stories/text-inputs/text-field.stories.tsx"
+    }
+  ]
+}

package/dist/bundled/doc-src/components/Code.astro

@@ -0,0 +1,14 @@
+---
+import { Code } from 'astro:components';
+import { CodePreview } from '@/components/CodePreview';
+
+const { 'data-code': code, 'data-language': language } = Astro.props;
+---
+<CodePreview client:load code={code} preview={language == 'jsx'}>
+  <Code code={code} lang={language} defaultColor={false} />
+</CodePreview>
+<style is:global>
+  pre {
+    text-wrap: auto;
+  }
+</style>