@cascivo/mcp 0.1.0

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@cascivo/mcp",
+  "version": "0.1.0",
+  "private": false,
+  "description": "MCP server exposing the cascade component registry to AI agents",
+  "keywords": [
+    "ai",
+    "cascivo",
+    "css",
+    "design-system",
+    "mcp",
+    "model-context-protocol",
+    "react",
+    "signals"
+  ],
+  "homepage": "https://github.com/urbanisierung/cascivo/tree/main/packages/mcp#readme",
+  "bugs": "https://github.com/urbanisierung/cascivo/issues",
+  "license": "MIT",
+  "author": "urbanisierung",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/urbanisierung/cascivo.git",
+    "directory": "packages/mcp"
+  },
+  "bin": {
+    "cascade-mcp": "./dist/index.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25",
+    "typescript": "^5",
+    "vite-plus": "^0.1.24"
+  },
+  "scripts": {
+    "build": "vp pack && node -e \"const fs=require('fs');const f='dist/index.mjs';const c=fs.readFileSync(f,'utf8');if(!c.startsWith('#!/'))fs.writeFileSync(f,'#!/usr/bin/env node\\n'+c);fs.copyFileSync('../../registry.json','dist/registry.json')\" && chmod +x dist/index.mjs",
+    "check": "tsc --noEmit",
+    "test": "vp test"
+  }
+}

package/readme.body.md

@@ -0,0 +1,41 @@
+## Usage
+
+Add it to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "cascivo": {
+      "command": "npx",
+      "args": ["-y", "@cascivo/mcp"]
+    }
+  }
+}
+```
+
+The server speaks the MCP stdio transport. By default it reads the `registry.json` bundled with the package; override with the `CASCIVO_REGISTRY_PATH` environment variable to point at a local registry.
+
+## Tools
+
+| Tool                | Input                                 | Returns                                                  |
+| ------------------- | ------------------------------------- | -------------------------------------------------------- |
+| `list_components`   | `{ category? }`                       | All component manifests, optionally filtered by category |
+| `get_component`     | `{ name }`                            | The full manifest for one component                      |
+| `search_components` | `{ query }`                           | Components matching name, tags, or description           |
+| `add_to_project`    | `{ name, outputDir? }`                | Runs `cascivo add <name>` as a child process             |
+| `create_theme`      | `{ primary, neutral, accent, name? }` | A custom theme as CSS (semantic token layer)             |
+| `scaffold_page`     | `{ description, components? }`        | A JSX page layout string                                 |
+
+`category` is one of `inputs`, `display`, `overlay`, `navigation`, `feedback`.
+
+## Programmatic use
+
+```ts
+import { createServer } from '@cascivo/mcp'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+
+const server = createServer({ registryPath: './registry.json' })
+await server.connect(new StdioServerTransport())
+```
+
+The pure helpers (`listComponents`, `getComponent`, `searchComponents`, `generateThemeCss`, `scaffoldPage`) are exported too, so the registry can be queried without spinning up the protocol.