@aleph-alpha/lib-mcp 1.3.0 → 1.5.0

package/components-meta.json

@@ -1105,7 +1105,8 @@
       "WithSearch",
       "WithActions",
       "WithSubmenu",
-      "WithSkeleton"
+      "WithSkeleton",
+      "ProgrammaticControl"
     ],
     "_autoGenerated": true
   },

package/dist/cli.js

@@ -3222,8 +3222,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path8) {
-      let input = path8;
+    function removeDotSegments(path9) {
+      let input = path9;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3422,8 +3422,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path8, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path8 && path8 !== "/" ? path8 : void 0;
+        const [path9, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path9 && path9 !== "/" ? path9 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -6838,8 +6838,15 @@ function findMatchingBrace(text2, openingBraceIndex, openChar = "{", closeChar =
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = path.dirname(__filename);
 var IDE_CONFIG = {
-  claude: { dir: null, file: ".mcp.json", name: "Claude Code" },
-  cursor: { dir: ".cursor", file: "mcp.json", name: "Cursor" }
+  claude: { dir: null, file: ".mcp.json", name: "Claude Code", rootKey: "mcpServers" },
+  cursor: { dir: ".cursor", file: "mcp.json", name: "Cursor", rootKey: "mcpServers" },
+  vscode: {
+    dir: ".vscode",
+    file: "mcp.json",
+    name: "VS Code",
+    rootKey: "servers",
+    extraFields: { type: "stdio" }
+  }
 };
 function getProjectRoot() {
   let dir = process.cwd();
@@ -6858,15 +6865,16 @@ function getMcpServerPath(projectRoot) {
   throw new Error("Could not find lib-mcp. Make sure @aleph-alpha/lib-mcp is installed.");
 }
 function configureIDE(ide, projectRoot, mcpPath) {
-  const { dir, file, name } = IDE_CONFIG[ide];
+  const { dir, file, name, rootKey, extraFields } = IDE_CONFIG[ide];
   const settingsDir = dir ? path.join(projectRoot, dir) : projectRoot;
   const settingsFile = path.join(settingsDir, file);
   if (dir && !fs2.existsSync(settingsDir)) {
     fs2.mkdirSync(settingsDir, { recursive: true });
   }
   const settings = readJsonFile(settingsFile) ?? {};
-  settings.mcpServers ??= {};
-  settings.mcpServers["ui-library"] = { command: "node", args: [mcpPath, "serve"] };
+  const servers = settings[rootKey] ?? {};
+  servers["ui-library"] = { command: "node", args: [mcpPath, "serve"], ...extraFields };
+  settings[rootKey] = servers;
   const tempFile = `${settingsFile}.tmp`;
   try {
     fs2.writeFileSync(tempFile, JSON.stringify(settings, null, 2) + "\n");
@@ -6885,10 +6893,11 @@ function configureIDE(ide, projectRoot, mcpPath) {
 function runInstall(args) {
   if (args.includes("--help") || args.includes("-h")) {
     console.log(`
-Usage: npx @aleph-alpha/lib-mcp mcp-install [--cursor]
+Usage: npx @aleph-alpha/lib-mcp mcp-install [--cursor] [--vscode]
 
 Options:
   --cursor    Also configure for Cursor IDE
+  --vscode    Also configure for VS Code
   --help      Show this help message
 `);
     return;
@@ -6903,6 +6912,9 @@ Installing UI Library MCP Server...
     if (args.includes("--cursor")) {
       configureIDE("cursor", projectRoot, mcpPath);
     }
+    if (args.includes("--vscode")) {
+      configureIDE("vscode", projectRoot, mcpPath);
+    }
     console.log(`
 \u2705 Done! Restart your IDE to use these tools:
    - list_components
@@ -7392,8 +7404,8 @@ function getErrorMap() {
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path8, errorMaps, issueData } = params;
-  const fullPath = [...path8, ...issueData.path || []];
+  const { data, path: path9, errorMaps, issueData } = params;
+  const fullPath = [...path9, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -7509,11 +7521,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path8, key) {
+  constructor(parent, value, path9, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path8;
+    this._path = path9;
     this._key = key;
   }
   get path() {
@@ -11151,10 +11163,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path8) {
-  if (!path8)
+function getElementAtPath(obj, path9) {
+  if (!path9)
     return obj;
-  return path8.reduce((acc, key) => acc?.[key], obj);
+  return path9.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -11474,11 +11486,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path8, issues) {
+function prefixIssues(path9, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path8);
+    iss.path.unshift(path9);
     return iss;
   });
 }
@@ -21102,6 +21114,9 @@ function findUiLibraryRoot() {
   }
   throw new Error("Could not find @aleph-alpha/ui-library. Is it installed?");
 }
+function getLibraryRootPath() {
+  return findUiLibraryRoot();
+}
 function getLibrarySourcePath() {
   const uiLibraryRoot = findUiLibraryRoot();
   const srcPath = path3.join(uiLibraryRoot, "src");
@@ -21446,6 +21461,23 @@ function getComponentDocs(componentName) {
   };
 }
 
+// src/tools/get-setup.ts
+import * as path8 from "node:path";
+function getSetupGuide() {
+  const libraryRoot = getLibraryRootPath();
+  const quickStartPath = path8.join(libraryRoot, "docs", "public-docs", "quick-start.md");
+  const quickStart = readTextFile(quickStartPath);
+  if (quickStart) {
+    return quickStart;
+  }
+  const readmePath = path8.join(libraryRoot, "README.md");
+  const readme = readTextFile(readmePath);
+  if (readme) {
+    return readme;
+  }
+  return null;
+}
+
 // src/server.ts
 var text = (t) => ({ content: [{ type: "text", text: t }] });
 var error2 = (msg) => ({ ...text(msg), isError: true });
@@ -21542,6 +21574,20 @@ async function startServer() {
       }
     }
   );
+  server.tool(
+    "get_setup_guide",
+    "Get the setup and installation guide for integrating the UI library into a project. Returns UnoCSS config, Vite config, required dependencies, and MCP setup instructions.",
+    {},
+    async () => {
+      try {
+        const guide = getSetupGuide();
+        if (!guide) return error2("Setup guide not found. Is @aleph-alpha/ui-library installed?");
+        return text(guide);
+      } catch (e) {
+        return handleError(e);
+      }
+    }
+  );
   const transport = new StdioServerTransport();
   await server.connect(transport);
   console.error("UI Library MCP Server running");
@@ -21556,12 +21602,13 @@ Usage:
   npx @aleph-alpha/lib-mcp <command> [options]
 
 Commands:
-  mcp-install [--cursor]    Configure MCP server for Claude Code (and optionally Cursor)
-  serve                     Start the MCP server (used internally by IDE)
+  mcp-install [--cursor] [--vscode]  Configure MCP server for Claude Code (and optionally Cursor/VS Code)
+  serve                              Start the MCP server (used internally by IDE)
 
 Examples:
   npx @aleph-alpha/lib-mcp mcp-install
   npx @aleph-alpha/lib-mcp mcp-install --cursor
+  npx @aleph-alpha/lib-mcp mcp-install --vscode
 
 After installation, restart your IDE to use these MCP tools:
   - list_components: Browse all UI components (optionally filter by name/category/description)

package/dist/server.js

@@ -3221,8 +3221,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path7) {
-      let input = path7;
+    function removeDotSegments(path8) {
+      let input = path8;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3421,8 +3421,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path7, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path7 && path7 !== "/" ? path7 : void 0;
+        const [path8, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path8 && path8 !== "/" ? path8 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -7266,8 +7266,8 @@ function getErrorMap() {
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path7, errorMaps, issueData } = params;
-  const fullPath = [...path7, ...issueData.path || []];
+  const { data, path: path8, errorMaps, issueData } = params;
+  const fullPath = [...path8, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -7383,11 +7383,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path7, key) {
+  constructor(parent, value, path8, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path7;
+    this._path = path8;
     this._key = key;
   }
   get path() {
@@ -11025,10 +11025,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path7) {
-  if (!path7)
+function getElementAtPath(obj, path8) {
+  if (!path8)
     return obj;
-  return path7.reduce((acc, key) => acc?.[key], obj);
+  return path8.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -11348,11 +11348,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path7, issues) {
+function prefixIssues(path8, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path7);
+    iss.path.unshift(path8);
     return iss;
   });
 }
@@ -21018,6 +21018,9 @@ function findUiLibraryRoot() {
   }
   throw new Error("Could not find @aleph-alpha/ui-library. Is it installed?");
 }
+function getLibraryRootPath() {
+  return findUiLibraryRoot();
+}
 function getLibrarySourcePath() {
   const uiLibraryRoot = findUiLibraryRoot();
   const srcPath = path2.join(uiLibraryRoot, "src");
@@ -21362,6 +21365,23 @@ function getComponentDocs(componentName) {
   };
 }
 
+// src/tools/get-setup.ts
+import * as path7 from "node:path";
+function getSetupGuide() {
+  const libraryRoot = getLibraryRootPath();
+  const quickStartPath = path7.join(libraryRoot, "docs", "public-docs", "quick-start.md");
+  const quickStart = readTextFile(quickStartPath);
+  if (quickStart) {
+    return quickStart;
+  }
+  const readmePath = path7.join(libraryRoot, "README.md");
+  const readme = readTextFile(readmePath);
+  if (readme) {
+    return readme;
+  }
+  return null;
+}
+
 // src/server.ts
 var text = (t) => ({ content: [{ type: "text", text: t }] });
 var error2 = (msg) => ({ ...text(msg), isError: true });
@@ -21458,6 +21478,20 @@ async function startServer() {
       }
     }
   );
+  server.tool(
+    "get_setup_guide",
+    "Get the setup and installation guide for integrating the UI library into a project. Returns UnoCSS config, Vite config, required dependencies, and MCP setup instructions.",
+    {},
+    async () => {
+      try {
+        const guide = getSetupGuide();
+        if (!guide) return error2("Setup guide not found. Is @aleph-alpha/ui-library installed?");
+        return text(guide);
+      } catch (e) {
+        return handleError(e);
+      }
+    }
+  );
   const transport = new StdioServerTransport();
   await server.connect(transport);
   console.error("UI Library MCP Server running");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aleph-alpha/lib-mcp",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/server.js",
@@ -28,7 +28,7 @@
     "@aleph-alpha/tsconfig-frontend": "0.5.0"
   },
   "peerDependencies": {
-    "@aleph-alpha/ui-library": "1.14.0"
+    "@aleph-alpha/ui-library": "1.15.0"
   },
   "homepage": "https://docs.aleph-alpha.com",
   "scripts": {