@getflip/swirl-mcp 0.0.0 → 0.1.0

package/dist/chunk-656TS2QU.js

@@ -0,0 +1,283 @@
+#!/usr/bin/env node
+
+// src/create-server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// src/data-source.ts
+var DataSource = class {
+  constructor(version) {
+    this.version = version;
+  }
+  async readJson(relativePath) {
+    const url = `${this.baseUrl}/${relativePath}`;
+    const res = await fetch(url);
+    if (!res.ok) {
+      throw new Error(
+        `Failed to fetch ${url}: ${res.status} ${res.statusText}`
+      );
+    }
+    return await res.json();
+  }
+  async readText(relativePath) {
+    const url = `${this.baseUrl}/${relativePath}`;
+    try {
+      const res = await fetch(url);
+      if (!res.ok) {
+        return void 0;
+      }
+      return await res.text();
+    } catch {
+      return void 0;
+    }
+  }
+  get baseUrl() {
+    return `https://unpkg.com/@getflip/swirl-ai@${this.version}/dist/agent`;
+  }
+};
+
+// src/artifact-library.ts
+var ArtifactLibrary = class _ArtifactLibrary {
+  catalog;
+  tagIndex;
+  dataSource;
+  constructor(catalog, dataSource) {
+    this.catalog = catalog;
+    this.dataSource = dataSource;
+    this.tagIndex = /* @__PURE__ */ new Map();
+    for (const entry of this.catalog) {
+      this.tagIndex.set(entry.tag, entry);
+    }
+  }
+  /**
+   * Load artifacts from a remote base URL (CDN).
+   */
+  static async fromRemote(version) {
+    const ds = new DataSource(version);
+    const json = await ds.readJson(
+      "components-index.json"
+    );
+    return new _ArtifactLibrary(json.components, ds);
+  }
+  getByCategory(category) {
+    return this.catalog.filter((c) => categorize(c.tag) === category);
+  }
+  getByTag(tag) {
+    return this.tagIndex.get(tag);
+  }
+  async getComponentMarkdown(tag) {
+    return this.dataSource.readText(`components/${tag}.md`);
+  }
+  async getGuide(name) {
+    return this.dataSource.readText(`${name}.md`);
+  }
+};
+function categorize(tag) {
+  if (tag.startsWith("swirl-icon-")) {
+    return "icon";
+  }
+  if (tag.startsWith("swirl-symbol-")) {
+    return "symbol";
+  }
+  if (tag.startsWith("swirl-emoji-")) {
+    return "emoji";
+  }
+  return "core";
+}
+
+// src/library-cache.ts
+var LibraryCache = class {
+  cache = /* @__PURE__ */ new Map();
+  maxSize;
+  constructor(maxSize = 20) {
+    this.maxSize = maxSize;
+  }
+  get(version) {
+    const lib = this.cache.get(version);
+    if (lib) {
+      this.cache.delete(version);
+      this.cache.set(version, lib);
+    }
+    return lib;
+  }
+  set(version, lib) {
+    if (this.cache.has(version)) {
+      this.cache.delete(version);
+    } else if (this.cache.size >= this.maxSize) {
+      const oldest = this.cache.keys().next().value;
+      this.cache.delete(oldest);
+    }
+    this.cache.set(version, lib);
+  }
+};
+
+// src/tools/list-components.ts
+import { z } from "zod";
+var VERSION_DESCRIPTION = "The @getflip/swirl-components version installed in the project. Read the user's package.json or node_modules/@getflip/swirl-components/package.json to find this.";
+function registerListComponents(server, loadLibrary2) {
+  registerListTool(
+    server,
+    loadLibrary2,
+    "list_components",
+    "List all Swirl design system UI components (buttons, modals, forms, etc.) with brief summaries and related components. Does NOT include icons, symbols, or emojis \u2014 use list_icons, list_symbols, or list_emojis for those. Use get_component_details for full props, events, slots, and examples. IMPORTANT: First read the user's package.json to determine their installed @getflip/swirl-components version, then pass it as the 'version' parameter.",
+    "core"
+  );
+}
+function registerListIcons(server, loadLibrary2) {
+  registerListTool(
+    server,
+    loadLibrary2,
+    "list_icons",
+    "List all Swirl icon components (swirl-icon-*). Use get_component_details for full details on a specific icon. IMPORTANT: First read the user's package.json to determine their installed @getflip/swirl-components version, then pass it as the 'version' parameter.",
+    "icon"
+  );
+}
+function registerListSymbols(server, loadLibrary2) {
+  registerListTool(
+    server,
+    loadLibrary2,
+    "list_symbols",
+    "List all Swirl symbol components (swirl-symbol-*). Use get_component_details for full details on a specific symbol. IMPORTANT: First read the user's package.json to determine their installed @getflip/swirl-components version, then pass it as the 'version' parameter.",
+    "symbol"
+  );
+}
+function registerListEmojis(server, loadLibrary2) {
+  registerListTool(
+    server,
+    loadLibrary2,
+    "list_emojis",
+    "List all Swirl emoji components (swirl-emoji-*). Use get_component_details for full details on a specific emoji. IMPORTANT: First read the user's package.json to determine their installed @getflip/swirl-components version, then pass it as the 'version' parameter.",
+    "emoji"
+  );
+}
+function registerListTool(server, loadLibrary2, name, description, category) {
+  server.registerTool(
+    name,
+    {
+      description,
+      inputSchema: {
+        version: z.string().describe(VERSION_DESCRIPTION)
+      }
+    },
+    // @ts-ignore - MCP SDK + zod 3.x causes excessively deep type instantiation
+    async ({ version }) => {
+      const lib = await loadLibrary2(version);
+      const components = lib.getByCategory(category);
+      return {
+        content: [{ type: "text", text: JSON.stringify(components) }]
+      };
+    }
+  );
+}
+
+// src/tools/get-component-details.ts
+import { z as z2 } from "zod";
+var VERSION_DESCRIPTION2 = "The @getflip/swirl-components version installed in the project. Read the user's package.json or node_modules/@getflip/swirl-components/package.json to find this.";
+function registerGetComponentDetails(server, loadLibrary2) {
+  server.registerTool(
+    "get_component_details",
+    {
+      description: "Get full details for a Swirl component including all props with types and defaults, events, methods, slots, accessibility info, and usage examples. IMPORTANT: First read the user's package.json to determine their installed @getflip/swirl-components version, then pass it as the 'version' parameter.",
+      inputSchema: {
+        tag: z2.string().describe('The component tag name, e.g. "swirl-button"'),
+        version: z2.string().describe(VERSION_DESCRIPTION2)
+      }
+    },
+    // @ts-ignore - MCP SDK + zod 3.x causes excessively deep type instantiation
+    async ({ tag, version }) => {
+      const lib = await loadLibrary2(version);
+      const entry = lib.getByTag(tag);
+      if (!entry) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Component "${tag}" not found. Use list_components to see available components.`
+            }
+          ]
+        };
+      }
+      const markdown = await lib.getComponentMarkdown(tag);
+      if (!markdown) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Component "${tag}" exists but no detailed documentation was found.`
+            }
+          ]
+        };
+      }
+      return {
+        content: [{ type: "text", text: markdown }]
+      };
+    }
+  );
+}
+
+// src/tools/get-started.ts
+import { z as z3 } from "zod";
+var VERSION_DESCRIPTION3 = "The @getflip/swirl-components version installed in the project. Read the user's package.json or node_modules/@getflip/swirl-components/package.json to find this.";
+function registerGetStarted(server, loadLibrary2) {
+  server.registerTool(
+    "get_started",
+    {
+      description: "Get installation and setup instructions for Swirl components. Covers Web Components, Angular, and React wrapper libraries. IMPORTANT: First read the user's package.json to determine their installed @getflip/swirl-components version, then pass it as the 'version' parameter.",
+      inputSchema: {
+        version: z3.string().describe(VERSION_DESCRIPTION3)
+      }
+    },
+    async ({ version }) => {
+      const lib = await loadLibrary2(version);
+      const markdown = await lib.getGuide("get-started");
+      if (!markdown) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "Getting started guide not found."
+            }
+          ]
+        };
+      }
+      return {
+        content: [{ type: "text", text: markdown }]
+      };
+    }
+  );
+}
+
+// src/create-server.ts
+var cache = new LibraryCache();
+async function loadLibrary(version) {
+  const cached = cache.get(version);
+  if (cached) {
+    return cached;
+  }
+  try {
+    const lib = await ArtifactLibrary.fromRemote(version);
+    cache.set(version, lib);
+    return lib;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `Version "${version}" not found or failed to load. Make sure the version matches your installed @getflip/swirl-components version. Details: ${message}`
+    );
+  }
+}
+function createMcpServer() {
+  const server = new McpServer({
+    name: "swirl-mcp",
+    version: "0.1.0"
+  });
+  registerListComponents(server, loadLibrary);
+  registerListIcons(server, loadLibrary);
+  registerListSymbols(server, loadLibrary);
+  registerListEmojis(server, loadLibrary);
+  registerGetComponentDetails(server, loadLibrary);
+  registerGetStarted(server, loadLibrary);
+  return server;
+}
+
+export {
+  createMcpServer
+};

package/dist/transports/http.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import {
+  createMcpServer
+} from "../chunk-656TS2QU.js";
+
+// src/transports/http.ts
+import { createServer } from "http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+var PORT = Number(process.env.PORT ?? 3e3);
+var httpServer = createServer(async (req, res) => {
+  if (req.method === "GET" && req.url === "/health") {
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ status: "ok" }));
+    return;
+  }
+  if (req.method === "POST" && req.url === "/mcp") {
+    try {
+      const mcpServer = createMcpServer();
+      const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: void 0
+        // stateless
+      });
+      await mcpServer.connect(transport);
+      await transport.handleRequest(req, res);
+      res.on("close", () => {
+        transport.close().catch(() => {
+        });
+        mcpServer.close().catch(() => {
+        });
+      });
+    } catch (error) {
+      console.error("MCP request error:", error);
+      if (!res.headersSent) {
+        res.writeHead(500, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "Internal server error" }));
+      }
+    }
+    return;
+  }
+  if (req.url === "/mcp") {
+    res.writeHead(405, { "Content-Type": "application/json" });
+    res.end(
+      JSON.stringify({
+        error: "Method not allowed. Use POST for MCP requests."
+      })
+    );
+    return;
+  }
+  res.writeHead(404, { "Content-Type": "application/json" });
+  res.end(JSON.stringify({ error: "Not found" }));
+});
+httpServer.listen(PORT, () => {
+  console.error(`Swirl MCP HTTP Server listening on port ${PORT}`);
+  console.error(`  MCP endpoint: POST http://localhost:${PORT}/mcp`);
+  console.error(`  Health check: GET  http://localhost:${PORT}/health`);
+});

package/dist/transports/stdio.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import {
+  createMcpServer
+} from "../chunk-656TS2QU.js";
+
+// src/transports/stdio.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+async function main() {
+  const server = createMcpServer();
+  await server.connect(new StdioServerTransport());
+  console.error("Swirl MCP Server running on stdio");
+}
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getflip/swirl-mcp",
-  "version": "0.0.0",
+  "version": "0.1.0",
   "description": "MCP server for Swirl Design System — lets AI agents discover and use Swirl components",
   "author": "Flip GmbH",
   "repository": {