@udixio/mcp 0.3.2

package/dist/cli.mjs

@@ -0,0 +1,450 @@
+#!/usr/bin/env node
+import { ResourceTemplate, McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { globby } from "globby";
+import fs from "node:fs/promises";
+import path from "node:path";
+import matter from "gray-matter";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express from "express";
+function hereDir$2() {
+  const u = new URL(import.meta.url);
+  return path.dirname(u.pathname);
+}
+function bundledComponentsIndexPath() {
+  const candidates = [
+    path.resolve(hereDir$2(), "./bundled/components-index.json"),
+    path.resolve(hereDir$2(), "../bundled/components-index.json")
+  ];
+  return candidates[0];
+}
+function bundledDocSrc$1() {
+  const candidates = [
+    path.resolve(hereDir$2(), "./bundled/doc-src"),
+    path.resolve(hereDir$2(), "../bundled/doc-src")
+  ];
+  return candidates[0];
+}
+async function pathExists$2(p) {
+  try {
+    await fs.stat(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function loadComponentsIndex() {
+  const bundledIndex = bundledComponentsIndexPath();
+  if (await pathExists$2(bundledIndex)) {
+    const raw = await fs.readFile(bundledIndex, "utf8");
+    return JSON.parse(raw);
+  }
+  throw new Error("Bundled components-index.json not found. Please install @udixio/mcp package with bundled assets.");
+}
+async function loadComponentDoc(name) {
+  const base = bundledDocSrc$1();
+  if (!await pathExists$2(base)) {
+    throw new Error("Bundled docs not found.");
+  }
+  const patterns = [
+    `**/${name}.md*`,
+    `**/${name.toLowerCase()}.md*`,
+    `**/${name}.stories.@(mdx|tsx)`
+  ];
+  const matches = await globby(patterns, { cwd: base, absolute: true });
+  return {
+    name,
+    docs: matches.map((m) => path.relative(base, m))
+  };
+}
+function hereDir$1() {
+  const u = new URL(import.meta.url);
+  return path.dirname(u.pathname);
+}
+function bundledDocSrc() {
+  const candidates = [
+    path.resolve(hereDir$1(), "./bundled/doc-src"),
+    path.resolve(hereDir$1(), "../bundled/doc-src")
+  ];
+  for (const c of candidates) {
+    return c;
+  }
+  return path.resolve(hereDir$1(), "./bundled/doc-src");
+}
+async function pathExists$1(p) {
+  try {
+    await fs.stat(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function resolveDocBase() {
+  const bundled = bundledDocSrc();
+  if (await pathExists$1(bundled)) return bundled;
+  throw new Error("Bundled documentation not found.");
+}
+async function searchDocs(query, limit = 10) {
+  const DOC_BASE = await resolveDocBase();
+  const files = await globby(["**/*.{md,mdx,astro}"], {
+    cwd: DOC_BASE,
+    absolute: true
+  });
+  const scored = [];
+  for (const f of files) {
+    const text = await fs.readFile(f, "utf8");
+    const { content, data } = matter(text);
+    const score = (content.match(new RegExp(query, "ig")) || []).length + (JSON.stringify(data).match(new RegExp(query, "ig")) || []).length;
+    if (score > 0) {
+      scored.push({
+        file: path.relative(DOC_BASE, f),
+        score,
+        title: data.title,
+        snippet: content.slice(0, 240)
+      });
+    }
+  }
+  scored.sort((a, b) => b.score - a.score);
+  return scored.slice(0, limit);
+}
+async function getDocByPath(relPath) {
+  const DOC_BASE = await resolveDocBase();
+  const full = path.join(DOC_BASE, relPath);
+  const content = await fs.readFile(full, "utf8");
+  const mimeType = relPath.endsWith(".astro") ? "text/x-astro" : "text/markdown";
+  return { mimeType, content };
+}
+function hereDir() {
+  const u = new URL(import.meta.url);
+  return path.dirname(u.pathname);
+}
+function bundledThemePath() {
+  const candidates = [
+    path.resolve(hereDir(), "./bundled/theme.json"),
+    path.resolve(hereDir(), "../bundled/theme.json")
+  ];
+  return candidates[0];
+}
+async function pathExists(p) {
+  try {
+    await fs.stat(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function loadThemeTokens() {
+  const bundled = bundledThemePath();
+  if (await pathExists(bundled)) {
+    const raw = await fs.readFile(bundled, "utf8");
+    return JSON.parse(raw);
+  }
+  throw new Error("Bundled theme.json not found.");
+}
+async function getColor(name, mode = "light") {
+  const tokens = await loadThemeTokens();
+  const colors = mode === "dark" ? tokens.colors.dark : tokens.colors.light;
+  const color = colors[name];
+  if (!color) return null;
+  return { name, ...color };
+}
+async function listColors(mode = "light") {
+  const tokens = await loadThemeTokens();
+  const colors = mode === "dark" ? tokens.colors.dark : tokens.colors.light;
+  return Object.keys(colors);
+}
+async function listPalettes() {
+  const tokens = await loadThemeTokens();
+  return Object.entries(tokens.palettes).map(([name, palette]) => ({
+    name,
+    ...palette
+  }));
+}
+async function getThemeConfig() {
+  const tokens = await loadThemeTokens();
+  return tokens.config;
+}
+function registerToolsAndResources(server) {
+  server.registerTool(
+    "listComponents",
+    {
+      title: "List Components",
+      description: "Liste tous les composants UI disponibles",
+      inputSchema: {}
+    },
+    async () => {
+      const list = await loadComponentsIndex();
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(list, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "getComponentDoc",
+    {
+      title: "Get Component Doc",
+      description: "Récupère la doc d'un composant (props, exemples, liens)",
+      inputSchema: {
+        name: z.string().describe("Nom du composant")
+      }
+    },
+    async ({ name }) => {
+      const doc = await loadComponentDoc(name);
+      return {
+        content: [
+          {
+            type: "text",
+            text: typeof doc === "string" ? doc : JSON.stringify(doc, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "searchDocs",
+    {
+      title: "Search Docs",
+      description: "Recherche plein texte dans la documentation",
+      inputSchema: {
+        query: z.string(),
+        limit: z.number().optional().default(10)
+      }
+    },
+    async ({ query, limit = 10 }) => {
+      const results = await searchDocs(query, limit);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(results, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "getThemeTokens",
+    {
+      title: "Get Theme Tokens",
+      description: "Récupère tous les tokens de thème (config, couleurs light/dark, palettes)",
+      inputSchema: {}
+    },
+    async () => {
+      const tokens = await loadThemeTokens();
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(tokens, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "getThemeConfig",
+    {
+      title: "Get Theme Config",
+      description: "Récupère la configuration du thème (sourceColor, contrastLevel, variant)",
+      inputSchema: {}
+    },
+    async () => {
+      const config = await getThemeConfig();
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(config, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "listColors",
+    {
+      title: "List Colors",
+      description: "Liste toutes les couleurs disponibles dans le thème",
+      inputSchema: {
+        mode: z.enum(["light", "dark"]).optional().default("light").describe("Mode de couleur (light ou dark)")
+      }
+    },
+    async ({ mode = "light" }) => {
+      const colors = await listColors(mode);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(colors, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "getColor",
+    {
+      title: "Get Color",
+      description: "Récupère les détails d'une couleur spécifique (hex, tone) en mode light ou dark",
+      inputSchema: {
+        name: z.string().describe("Nom de la couleur (ex: primary, surface)"),
+        mode: z.enum(["light", "dark"]).optional().default("light").describe("Mode de couleur")
+      }
+    },
+    async ({ name, mode = "light" }) => {
+      const color = await getColor(name, mode);
+      if (!color) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ error: `Color '${name}' not found` })
+            }
+          ]
+        };
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(color, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "listPalettes",
+    {
+      title: "List Palettes",
+      description: "Liste toutes les palettes de couleurs (hue, chroma)",
+      inputSchema: {}
+    },
+    async () => {
+      const palettes = await listPalettes();
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(palettes, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "compareColor",
+    {
+      title: "Compare Color",
+      description: "Compare une couleur entre les modes light et dark pour voir les différences",
+      inputSchema: {
+        name: z.string().describe("Nom de la couleur à comparer")
+      }
+    },
+    async ({ name }) => {
+      const [light, dark] = await Promise.all([
+        getColor(name, "light"),
+        getColor(name, "dark")
+      ]);
+      if (!light && !dark) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ error: `Color '${name}' not found` })
+            }
+          ]
+        };
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({ name, light, dark }, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerResource(
+    "doc",
+    new ResourceTemplate("doc://{path}", { list: void 0 }),
+    {
+      title: "Doc Resource",
+      description: "Lit un fichier de doc relatif à apps/doc"
+    },
+    async (uri, { path: path2 }) => {
+      const pathStr = Array.isArray(path2) ? path2.join("/") : path2;
+      const file = await getDocByPath(pathStr);
+      return {
+        contents: [
+          {
+            uri: uri.href,
+            mimeType: file.mimeType,
+            text: file.content
+          }
+        ]
+      };
+    }
+  );
+  server.registerResource(
+    "theme",
+    new ResourceTemplate("theme://tokens", { list: void 0 }),
+    {
+      title: "Theme Tokens Resource",
+      description: "Accès aux tokens de thème complets"
+    },
+    async (uri) => {
+      const tokens = await loadThemeTokens();
+      return {
+        contents: [
+          {
+            uri: uri.href,
+            mimeType: "application/json",
+            text: JSON.stringify(tokens, null, 2)
+          }
+        ]
+      };
+    }
+  );
+}
+async function main() {
+  const server = new McpServer({
+    name: "@udixio/mcp",
+    version: "0.1.0"
+  });
+  registerToolsAndResources(server);
+  const app = express();
+  app.use(express.json());
+  app.post("/mcp", async (req, res) => {
+    const transport = new StreamableHTTPServerTransport({
+      sessionIdGenerator: void 0,
+      enableJsonResponse: true
+    });
+    res.on("close", () => {
+      transport.close();
+    });
+    await server.connect(transport);
+    await transport.handleRequest(req, res, req.body);
+  });
+  const port = parseInt(process.env.PORT || "3000");
+  app.listen(port, () => {
+    console.log(`Demo MCP Server running on http://localhost:${port}/mcp`);
+  }).on("error", (error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+  });
+}
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});
+export {
+  main as m,
+  registerToolsAndResources as r
+};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/cli';
+export * from './lib/main';
+export * from './lib/mcp';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,5 @@
+import { m, r } from "./cli.mjs";
+export {
+  m as main,
+  r as registerToolsAndResources
+};

package/dist/lib/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/lib/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":""}

package/dist/lib/loaders/components.d.ts

@@ -0,0 +1,6 @@
+export declare function loadComponentsIndex(): Promise<any>;
+export declare function loadComponentDoc(name: string): Promise<{
+    name: string;
+    docs: string[];
+}>;
+//# sourceMappingURL=components.d.ts.map

package/dist/lib/loaders/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../src/lib/loaders/components.ts"],"names":[],"mappings":"AAmCA,wBAAsB,mBAAmB,iBAQxC;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM;;;GAgBlD"}

package/dist/lib/loaders/docs.d.ts

@@ -0,0 +1,11 @@
+export declare function searchDocs(query: string, limit?: number): Promise<{
+    file: string;
+    score: number;
+    title?: string;
+    snippet?: string;
+}[]>;
+export declare function getDocByPath(relPath: string): Promise<{
+    mimeType: string;
+    content: string;
+}>;
+//# sourceMappingURL=docs.d.ts.map

package/dist/lib/loaders/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/lib/loaders/docs.ts"],"names":[],"mappings":"AAsCA,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK;UAOhD,MAAM;WACL,MAAM;YACL,MAAM;cACJ,MAAM;KAmBnB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM;;;GAQjD"}

package/dist/lib/loaders/theme.d.ts

@@ -0,0 +1,37 @@
+export interface ThemeSnapshot {
+    config: {
+        sourceColor: string;
+        contrastLevel: number;
+        isDark: boolean;
+        variant: string;
+    };
+    palettes: Record<string, {
+        hue: number;
+        chroma: number;
+    }>;
+    colors: {
+        light: Record<string, {
+            hex: string;
+            tone: number;
+        }>;
+        dark: Record<string, {
+            hex: string;
+            tone: number;
+        }>;
+    };
+    customPalettes: string[];
+}
+export declare function loadThemeTokens(): Promise<ThemeSnapshot>;
+export declare function getColor(name: string, mode?: 'light' | 'dark'): Promise<{
+    name: string;
+    hex: string;
+    tone: number;
+} | null>;
+export declare function listColors(mode?: 'light' | 'dark'): Promise<string[]>;
+export declare function listPalettes(): Promise<Array<{
+    name: string;
+    hue: number;
+    chroma: number;
+}>>;
+export declare function getThemeConfig(): Promise<ThemeSnapshot['config']>;
+//# sourceMappingURL=theme.d.ts.map

package/dist/lib/loaders/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/lib/loaders/theme.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACrD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrD,CAAC;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,aAAa,CAAC,CAO9D;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,OAAO,GAAG,MAAgB,GAC/B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAM7D;AAED,wBAAsB,UAAU,CAC9B,IAAI,GAAE,OAAO,GAAG,MAAgB,GAC/B,OAAO,CAAC,MAAM,EAAE,CAAC,CAInB;AAED,wBAAsB,YAAY,IAAI,OAAO,CAC3C,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CACrD,CAMA;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAGvE"}

package/dist/lib/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/lib/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/lib/main.ts"],"names":[],"mappings":";AAMA,wBAAsB,IAAI,kBAoCzB"}

package/dist/lib/mcp.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerToolsAndResources(server: McpServer): void;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/lib/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/lib/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAEV,MAAM,yCAAyC,CAAC;AAYjD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,QAmS1D"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@udixio/mcp",
+  "version": "0.3.2",
+  "private": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "author": "Udixio",
+  "license": "MIT",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "udixio",
+    "ui",
+    "design-system"
+  ],
+  "bin": {
+    "udixio-mcp": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "clean": "rimraf dist",
+    "prepack": "pnpm build && tsx scripts/snapshot.ts"
+  },
+  "dependencies": {
+    "express": "^5.1.0",
+    "@modelcontextprotocol/sdk": "^1.20.2",
+    "@udixio/theme": "workspace:*",
+    "zod": "^4.1.12",
+    "globby": "^15.0.0",
+    "gray-matter": "^4.0.3"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.5",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "rimraf": "^6.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}