@cascivo/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 urbanisierung
+
+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,59 @@
+<!-- generated by scripts/readme/generate.ts — edit readme.body.md, not this file -->
+
+# @cascivo/mcp
+
+> MCP server exposing the cascade component registry to AI agents
+
+[cascivo.com](https://cascivo.com) · [Docs](https://docs.cascivo.com) · [Storybook](https://storybook.cascivo.com) · [GitHub](https://github.com/urbanisierung/cascivo)
+
+## 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.
+
+## Install
+
+```sh
+pnpm add @cascivo/mcp
+```
+
+---
+
+[cascivo.com](https://cascivo.com) · [Docs](https://docs.cascivo.com) · [Storybook](https://storybook.cascivo.com) · [GitHub](https://github.com/urbanisierung/cascivo) · AI agents: use [`@cascivo/mcp`](https://github.com/urbanisierung/cascivo/tree/main/packages/mcp) and [`registry.json`](https://github.com/urbanisierung/cascivo/blob/main/registry.json) · MIT

package/dist/index.d.mts

@@ -0,0 +1,100 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/server.d.ts
+type FetchFn = (url: string, init?: RequestInit) => Promise<Response>;
+interface ServerOptions {
+  registryPath?: string;
+  version?: string;
+  /** Injectable fetch function — used for testing multi-registry features. */
+  fetchFn?: FetchFn;
+}
+/** Build a configured McpServer exposing the cascade component registry. */
+declare function createServer(options?: ServerOptions): McpServer;
+//#endregion
+//#region src/theme.d.ts
+interface ThemeColors {
+  /** Main brand / interactive color (maps to the accent token family). */
+  primary: string;
+  /** Base gray used to derive surfaces, borders, and text. */
+  neutral: string;
+  /** Secondary highlight color (info / focus ring). */
+  accent: string;
+}
+/**
+ * Generate a custom cascade theme as CSS. Maps the three input colors onto the
+ * semantic token layer; component tokens inherit automatically.
+ */
+declare function generateThemeCss(colors: ThemeColors, name?: string): string;
+//#endregion
+//#region src/scaffold.d.ts
+interface ScaffoldOptions {
+  description: string;
+  components?: string[];
+}
+/**
+ * Generate a JSX page layout string from a natural-language description and an
+ * optional list of cascade components to include.
+ */
+declare function scaffoldPage(options: ScaffoldOptions): string;
+//#endregion
+//#region src/registry.d.ts
+interface PropManifest {
+  name: string;
+  type: string;
+  required: boolean;
+  default?: string;
+  description?: string;
+}
+interface ComponentManifest {
+  name: string;
+  description: string;
+  category: string;
+  states: string[];
+  variants: string[];
+  sizes: string[];
+  props: PropManifest[];
+  tokens: string[];
+  accessibility: {
+    role: string;
+    wcag: string;
+    keyboard: string[];
+  };
+  examples: {
+    title: string;
+    code: string;
+    description?: string;
+  }[];
+  dependencies: string[];
+  tags: string[];
+}
+interface RegistryComponent {
+  name: string;
+  type?: 'component' | 'layout' | 'block' | 'chart' | 'section';
+  description: string;
+  category: string;
+  version: string;
+  files: string[];
+  dependencies: string[];
+  tags: string[];
+  meta: ComponentManifest;
+}
+interface Registry {
+  version: string;
+  generatedAt: string;
+  components: RegistryComponent[];
+}
+declare function loadRegistry(path?: string): Registry;
+/** List component manifests, optionally filtered by category and/or type. */
+declare function listComponents(registry: Registry, category?: string, type?: string): ComponentManifest[];
+/** Find one component manifest by name (matches registry name or meta name). */
+declare function getComponent(registry: Registry, name: string): ComponentManifest | undefined;
+/** Fuzzy search over name, tags, and description. */
+declare function searchComponents(registry: Registry, query: string): ComponentManifest[];
+//#endregion
+//#region src/index.d.ts
+declare const VERSION = "0.0.0";
+/** Start the MCP server over stdio. */
+declare function main(): Promise<void>;
+//#endregion
+export { type ComponentManifest, type Registry, type RegistryComponent, type ScaffoldOptions, type ServerOptions, type ThemeColors, VERSION, createServer, generateThemeCss, getComponent, listComponents, loadRegistry, main, scaffoldPage, searchComponents };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/server.ts","../src/theme.ts","../src/scaffold.ts","../src/registry.ts","../src/index.ts"],"mappings":";;;KAsBK,OAAA,IAAW,GAAA,UAAa,IAAA,GAAO,WAAA,KAAgB,OAAA,CAAQ,QAAA;AAAA,UAE3C,aAAA;EACf,YAAA;EACA,OAAA;;EAEA,OAAA,GAAU,OAAO;AAAA;;iBAeH,YAAA,CAAa,OAAA,GAAS,aAAA,GAAqB,SAAS;;;UC3CnD,WAAA;;EAEf,OAAA;EDoBG;EClBH,OAAA;;EAEA,MAAA;AAAA;;;;;iBAiBc,gBAAA,CAAiB,MAAA,EAAQ,WAAW,EAAE,IAAA;;;UCvBrC,eAAA;EACf,WAAA;EACA,UAAU;AAAA;;;;;iBAgCI,YAAA,CAAa,OAAwB,EAAf,eAAe;;;UC9BpC,YAAA;EACf,IAAA;EACA,IAAA;EACA,QAAA;EACA,OAAA;EACA,WAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;EACA,WAAA;EACA,QAAA;EACA,MAAA;EACA,QAAA;EACA,KAAA;EACA,KAAA,EAAO,YAAY;EACnB,MAAA;EACA,aAAA;IAAiB,IAAA;IAAc,IAAA;IAAc,QAAA;EAAA;EAC7C,QAAA;IAAY,KAAA;IAAe,IAAA;IAAc,WAAA;EAAA;EACzC,YAAA;EACA,IAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;EACA,IAAA;EACA,WAAA;EACA,QAAA;EACA,OAAA;EACA,KAAA;EACA,YAAA;EACA,IAAA;EACA,IAAA,EAAM,iBAAiB;AAAA;AAAA,UAGR,QAAA;EACf,OAAA;EACA,WAAA;EACA,UAAA,EAAY,iBAAiB;AAAA;AAAA,iBAwBf,YAAA,CAAa,IAAA,YAAgB,QAAQ;;iBAUrC,cAAA,CACd,QAAA,EAAU,QAAA,EACV,QAAA,WACA,IAAA,YACC,iBAAiB;;iBAQJ,YAAA,CAAa,QAAA,EAAU,QAAA,EAAU,IAAA,WAAe,iBAAiB;;iBAoGjE,gBAAA,CAAiB,QAAA,EAAU,QAAA,EAAU,KAAA,WAAgB,iBAAiB;;;cCvLzE,OAAA;;iBAiBS,IAAA,IAAQ,OAAO"}