@tetrascience-npm/tetrascience-react-ui 0.6.0-beta.84.1 → 0.6.0-beta.85.1

package/README.md

@@ -392,6 +392,61 @@ Visit <http://localhost:6006>.
 - [Theming Guide](./THEMING.md) - Customise the design system
 - [Contributing](./CONTRIBUTING.md#development-setup) - Clone the repo and run `yarn storybook`
 
+## MCP server (for AI coding agents)
+
+This library exposes an [MCP](https://modelcontextprotocol.io/) server so AI
+coding agents (Claude Code, Cursor, Claude Desktop) can query authoritative
+component lists, prop/variant options, and usage examples instead of guessing —
+reducing hallucinated component APIs when scaffolding a data app.
+
+There are two endpoints. Pick whichever fits; you can add both.
+
+| Endpoint | URL | Tools |
+| --- | --- | --- |
+| **Deployed** (no local checkout needed) | `https://ts-lib-ui-kit-storybook.vercel.app/api/mcp` | docs: `list_components`, `get_component`, `search_components` |
+| **Local** (needs `yarn storybook` running) | `http://localhost:6006/mcp` | full set: docs **+** write/preview/test stories |
+
+### Add the connection
+
+**Claude Code** — register the deployed server (HTTP transport):
+
+```bash
+claude mcp add --transport http ts-ui-kit https://ts-lib-ui-kit-storybook.vercel.app/api/mcp
+```
+
+Use `--scope project` to share it with your team via a checked-in `.mcp.json`, or
+`--scope user` to make it available across all your projects. For the local
+server, run `yarn storybook` first, then:
+
+```bash
+claude mcp add --transport http ts-ui-kit-local http://localhost:6006/mcp
+```
+
+**Cursor / Claude Desktop / other clients** — add an HTTP MCP server to the
+client's MCP config (e.g. Cursor's `.cursor/mcp.json`, or Claude Desktop's
+`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "ts-ui-kit": {
+      "type": "http",
+      "url": "https://ts-lib-ui-kit-storybook.vercel.app/api/mcp"
+    }
+  }
+}
+```
+
+**Any client (generic helper):**
+
+```bash
+npx mcp-add --type http --url "https://ts-lib-ui-kit-storybook.vercel.app/api/mcp"
+```
+
+Then ask your agent something like *"using the ts-ui-kit MCP, list the available
+components"* or *"build a form using ts-ui-kit primitives"* to confirm it's wired
+up.
+
 ## Tech Stack
 
 - React 19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tetrascience-npm/tetrascience-react-ui",
-  "version": "0.6.0-beta.84.1",
+  "version": "0.6.0-beta.85.1",
   "description": "TetraScience React UI",
   "type": "module",
   "author": "TetraScience",
@@ -87,7 +87,8 @@
     "postbuild": "yarn dlx @tailwindcss/cli@4.2.2 -i ./src/index.tailwind.css -o ./dist/index.tailwind.css --minify",
     "dev": "yarn storybook",
     "storybook": "storybook dev -p 6006",
-    "build-storybook": "storybook build",
+    "build-storybook": "storybook build && yarn run build-storybook:metadata",
+    "build-storybook:metadata": "tsx scripts/mcp/build-metadata.ts",
     "prepare": "husky",
     "prepublishOnly": "yarn run build",
     "release": "semantic-release",
@@ -173,19 +174,21 @@
     "@commitlint/config-conventional": "^20.5.0",
     "@databricks/sql": "^1.12.0",
     "@eslint/js": "^9.9.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^12.0.6",
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
-    "@storybook/addon-a11y": "^10.2.15",
-    "@storybook/addon-docs": "^10.2.15",
-    "@storybook/addon-links": "^10.2.15",
-    "@storybook/addon-themes": "^10.2.15",
-    "@storybook/addon-vitest": "^10.2.15",
-    "@storybook/builder-vite": "^10.2.15",
-    "@storybook/react-vite": "^10.2.15",
+    "@storybook/addon-a11y": "^10.4.6",
+    "@storybook/addon-docs": "^10.4.6",
+    "@storybook/addon-links": "^10.4.6",
+    "@storybook/addon-mcp": "^0.6.0",
+    "@storybook/addon-themes": "^10.4.6",
+    "@storybook/addon-vitest": "^10.4.6",
+    "@storybook/builder-vite": "^10.4.6",
+    "@storybook/react-vite": "^10.4.6",
     "@tailwindcss/vite": "^4.2.2",
     "@types/eslint-plugin-jsx-a11y": "^6",
     "@types/jsdom": "^27",
@@ -195,6 +198,7 @@
     "@types/react-dom": "^19.0.0",
     "@types/react-plotly.js": "^2.6.3",
     "@types/react-syntax-highlighter": "^15",
+    "@vercel/node": "^5.4.5",
     "@vitejs/plugin-react": "^4.3.1",
     "@vitest/browser": "^3",
     "@vitest/coverage-v8": "^3",
@@ -206,7 +210,7 @@
     "eslint-plugin-react-hooks": "^5.1.0-rc.0",
     "eslint-plugin-react-refresh": "^0.4.9",
     "eslint-plugin-sonarjs": "^3.0.7",
-    "eslint-plugin-storybook": "^10.2.15",
+    "eslint-plugin-storybook": "^10.4.6",
     "eslint-plugin-unicorn": "^63.0.0",
     "fast-xml-parser": "^5.3.4",
     "globals": "^15.9.0",
@@ -221,15 +225,17 @@
     "semantic-release": "^25.0.3",
     "shadcn": "^3.8.5",
     "snowflake-sdk": "^2.3.3",
-    "storybook": "^10.2.15",
+    "storybook": "^10.4.6",
     "tailwindcss": "^4.2.2",
     "ts-morph": "^27.0.2",
+    "tsx": "^4.20.6",
     "tw-animate-css": "^1.4.0",
     "typescript": "^5.5.3",
     "typescript-eslint": "^8.0.1",
     "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^3"
+    "vitest": "^3",
+    "zod": "^3.25.76"
   },
   "resolutions": {
     "jackspeak": "2.1.1",