@uidbai/mcp-server 0.2.0 → 0.3.0

package/dist/tools/detect-pattern.js

@@ -2,17 +2,18 @@
  * UIDB MCP Tool: uidb_detect_pattern
  *
  * Check if a UI composition is a reusable pattern.
+ * Uses LLM via UIDB API for intelligent detection, falls back to local heuristics.
  */
 import { apiClient } from "../core/api-client.js";
-import { formatErrorResponse } from "../core/errors.js";
+import { readPatternsIndex, UIDBNotFoundError, } from "../core/local-fs.js";
 export const detectPatternTool = {
     name: "uidb_detect_pattern",
     description: `Check if a UI composition (3+ components) is a reusable pattern.
 
-Use this after building a multi-component UI to see if it should be documented as a pattern.
-If a pattern is detected, use uidb_submit_pattern to add it to the design system.
+Use this after building a multi-component UI to see if it should be documented.
+If is_pattern is true, use uidb_submit_pattern to add it to the design system.
 
-Example: After building a user profile card with Avatar, Text, and Flex components.`,
+Example: After building a user profile card with Avatar, Text, and Badge components.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -34,26 +35,77 @@ Example: After building a user profile card with Avatar, Text, and Flex componen
     },
     async execute(args) {
         try {
-            const response = await apiClient.post("/api/pattern/detect", {
-                description: args.description,
-                components_used: args.components_used,
-                ...(args.context && { context: args.context }),
-            });
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify(response, null, 2),
-                    },
-                ],
-            };
+            // First, check against existing patterns locally
+            const existingPatterns = await checkExistingPatterns(args);
+            if (existingPatterns.exists) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                is_pattern: false,
+                                reason: "Similar pattern already exists",
+                                existing_pattern: existingPatterns.pattern,
+                                suggestion: "Consider using the existing pattern instead",
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            // Try LLM detection via API
+            try {
+                const response = await apiClient.post("/api/pattern/detect", {
+                    description: args.description,
+                    components_used: args.components_used,
+                    ...(args.context && { context: args.context }),
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(response, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch {
+                // Fall back to local heuristics
+                const localResult = detectPatternLocally(args);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(localResult, null, 2),
+                        },
+                    ],
+                };
+            }
         }
         catch (error) {
+            if (error instanceof UIDBNotFoundError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "NOT_INITIALIZED",
+                                message: "No .uidb folder found. Run uidb_init first.",
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
             return {
                 content: [
                     {
                         type: "text",
-                        text: formatErrorResponse(error),
+                        text: JSON.stringify({
+                            error: "DETECT_FAILED",
+                            message: error instanceof Error
+                                ? error.message
+                                : "Failed to detect pattern",
+                        }, null, 2),
                     },
                 ],
                 isError: true,
@@ -61,4 +113,85 @@ Example: After building a user profile card with Avatar, Text, and Flex componen
         }
     },
 };
+/**
+ * Check if a similar pattern already exists locally
+ */
+async function checkExistingPatterns(args) {
+    try {
+        const index = await readPatternsIndex();
+        const descLower = args.description.toLowerCase();
+        for (const pattern of index.patterns) {
+            // Check if description matches
+            const patternWords = pattern.description.toLowerCase().split(" ");
+            let matchCount = 0;
+            for (const word of patternWords) {
+                if (word.length > 3 && descLower.includes(word))
+                    matchCount++;
+            }
+            // If more than 50% of words match, consider it a duplicate
+            if (matchCount > patternWords.length * 0.5) {
+                return { exists: true, pattern: pattern.name };
+            }
+        }
+        return { exists: false };
+    }
+    catch {
+        return { exists: false };
+    }
+}
+/**
+ * Local heuristic-based pattern detection
+ */
+function detectPatternLocally(args) {
+    const componentCount = args.components_used.length;
+    // Not a pattern if fewer than 3 components
+    if (componentCount < 3) {
+        return {
+            is_pattern: false,
+            confidence: "high",
+            reason: "Fewer than 3 components - too simple to be a reusable pattern",
+        };
+    }
+    // Likely a pattern if 3+ components with semantic meaning
+    const hasInteractiveComponent = args.components_used.some((c) => ["Button", "IconButton", "Link", "Switch", "Checkbox"].includes(c));
+    const hasLayoutComponent = args.components_used.some((c) => ["Card", "Flex", "Box", "Grid"].includes(c));
+    const hasDataComponent = args.components_used.some((c) => ["Avatar", "Badge", "Text", "Heading"].includes(c));
+    const diversityScore = (hasInteractiveComponent ? 1 : 0) +
+        (hasLayoutComponent ? 1 : 0) +
+        (hasDataComponent ? 1 : 0);
+    if (diversityScore >= 2 && componentCount >= 3) {
+        // Suggest a category based on components
+        let suggestedCategory = "layout";
+        if (args.components_used.includes("Avatar"))
+            suggestedCategory = "identity";
+        if (args.components_used.includes("TextField") ||
+            args.components_used.includes("Select"))
+            suggestedCategory = "forms";
+        if (args.components_used.includes("Callout"))
+            suggestedCategory = "feedback";
+        if (args.components_used.includes("Tabs") ||
+            args.components_used.includes("DropdownMenu"))
+            suggestedCategory = "navigation";
+        // Generate suggested name from description
+        const words = args.description
+            .split(" ")
+            .filter((w) => w.length > 2)
+            .slice(0, 3);
+        const suggestedName = words
+            .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+            .join("");
+        return {
+            is_pattern: true,
+            confidence: componentCount >= 5 ? "high" : "medium",
+            suggested_name: suggestedName || "CustomPattern",
+            suggested_category: suggestedCategory,
+            reason: `${componentCount} components with diverse functionality - good candidate for reuse`,
+        };
+    }
+    return {
+        is_pattern: false,
+        confidence: "medium",
+        reason: "Components don't form a semantically meaningful reusable unit",
+    };
+}
 //# sourceMappingURL=detect-pattern.js.map

package/dist/tools/detect-pattern.js.map

@@ -1 +1 @@
-{"version":3,"file":"detect-pattern.js","sourceRoot":"","sources":["../../src/tools/detect-pattern.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;oFAKqE;IAElF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kFAAkF;aACrF;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,wEAAwE;aAC3E;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,0EAA0E;aAC7E;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,EAAE,iBAAiB,CAAC;KAC7C;IAED,KAAK,CAAC,OAAO,CAAC,IAIb;QACC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CACnC,qBAAqB,EACrB;gBACE,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;aAC/C,CACF,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;qBACxC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC;qBACjC;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"detect-pattern.js","sourceRoot":"","sources":["../../src/tools/detect-pattern.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-config.d.ts

@@ -1,7 +1,7 @@
 /**
  * UIDB MCP Tool: uidb_get_config
  *
- * Get the project's design system configuration.
+ * Get the project's design system configuration from the local .uidb folder.
  */
 export declare const getConfigTool: {
     name: string;

package/dist/tools/get-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-config.d.ts","sourceRoot":"","sources":["../../src/tools/get-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;CAyCzB,CAAC"}
+{"version":3,"file":"get-config.d.ts","sourceRoot":"","sources":["../../src/tools/get-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;CA2FzB,CAAC"}

package/dist/tools/get-config.js

@@ -1,18 +1,18 @@
 /**
  * UIDB MCP Tool: uidb_get_config
  *
- * Get the project's design system configuration.
+ * Get the project's design system configuration from the local .uidb folder.
  */
-import { apiClient } from "../core/api-client.js";
-import { formatErrorResponse } from "../core/errors.js";
+import { readConfig, readManifest, UIDBNotFoundError } from "../core/local-fs.js";
 export const getConfigTool = {
     name: "uidb_get_config",
-    description: `Get the current design system configuration for this project.
+    description: `Get the current design system configuration from .uidb/config.json.
 
 Returns:
-- accentColor: Primary brand color (e.g., 'blue', 'violet', 'green')
-- grayColor: Neutral color palette (e.g., 'slate', 'gray', 'mauve')
-- radius: Border radius scale (none, small, medium, large, full)
+- theme.accentColor: Primary brand color (e.g., 'blue', 'violet', 'green')
+- theme.grayColor: Neutral color palette (e.g., 'slate', 'gray', 'mauve')
+- theme.radius: Border radius scale (none, small, medium, large, full)
+- appearance: Color scheme (light, dark)
 
 Use these values when building UI to ensure consistency with the project theme.`,
     inputSchema: {
@@ -22,22 +22,57 @@ Use these values when building UI to ensure consistency with the project theme.`
     },
     async execute() {
         try {
-            const response = await apiClient.get("/api/config");
+            const [config, manifest] = await Promise.all([
+                readConfig(),
+                readManifest().catch(() => null),
+            ]);
             return {
                 content: [
                     {
                         type: "text",
-                        text: JSON.stringify(response, null, 2),
+                        text: JSON.stringify({
+                            project: manifest?.name || "Unknown",
+                            config: {
+                                accentColor: config.theme.accentColor,
+                                grayColor: config.theme.grayColor,
+                                radius: config.theme.radius,
+                                appearance: config.appearance || "light",
+                                scaling: config.scaling || "100%",
+                            },
+                            usage: {
+                                radix_theme: `<Theme accentColor="${config.theme.accentColor}" grayColor="${config.theme.grayColor}" radius="${config.theme.radius}">`,
+                                import: "import config from '../.uidb/config.json';",
+                            },
+                        }, null, 2),
                     },
                 ],
             };
         }
         catch (error) {
+            if (error instanceof UIDBNotFoundError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "NOT_INITIALIZED",
+                                message: "No .uidb folder found. Run uidb_init first.",
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
             return {
                 content: [
                     {
                         type: "text",
-                        text: formatErrorResponse(error),
+                        text: JSON.stringify({
+                            error: "READ_FAILED",
+                            message: error instanceof Error
+                                ? error.message
+                                : "Failed to read config",
+                        }, null, 2),
                     },
                 ],
                 isError: true,

package/dist/tools/get-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-config.js","sourceRoot":"","sources":["../../src/tools/get-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;gFAOiE;IAE9E,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAgB,aAAa,CAAC,CAAC;YAEnE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;qBACxC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC;qBACjC;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-config.js","sourceRoot":"","sources":["../../src/tools/get-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAElF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;gFAQiE;IAE9E,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC3C,UAAU,EAAE;gBACZ,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;aACjC,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,SAAS;4BACpC,MAAM,EAAE;gCACN,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;gCACrC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;gCACjC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;gCAC3B,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,OAAO;gCACxC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM;6BAClC;4BACD,KAAK,EAAE;gCACL,WAAW,EAAE,uBAAuB,MAAM,CAAC,KAAK,CAAC,WAAW,gBAAgB,MAAM,CAAC,KAAK,CAAC,SAAS,aAAa,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI;gCACtI,MAAM,EAAE,4CAA4C;6BACrD;yBACF,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;gBACvC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;gCACE,KAAK,EAAE,iBAAiB;gCACxB,OAAO,EAAE,6CAA6C;6BACvD,EACD,IAAI,EACJ,CAAC,CACF;yBACF;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,KAAK,EAAE,aAAa;4BACpB,OAAO,EACL,KAAK,YAAY,KAAK;gCACpB,CAAC,CAAC,KAAK,CAAC,OAAO;gCACf,CAAC,CAAC,uBAAuB;yBAC9B,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/guide.d.ts

@@ -0,0 +1,65 @@
+/**
+ * UIDB MCP Tool: uidb_guide
+ *
+ * Unified component guidance tool. Replaces the multi-step ask_intent/ask_question/finalize flow.
+ * Reads local .uidb/ files and optionally calls UIDB API for LLM-powered recommendations.
+ */
+interface GuideInput {
+    description: string;
+    context?: {
+        file?: string;
+        existing_components?: string[];
+    };
+    use_llm?: boolean;
+}
+export declare const guideTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            description: {
+                type: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                properties: {
+                    file: {
+                        type: string;
+                        description: string;
+                    };
+                    existing_components: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                        description: string;
+                    };
+                };
+                description: string;
+            };
+            use_llm: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+    execute(args: GuideInput): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};
+export {};
+//# sourceMappingURL=guide.d.ts.map

package/dist/tools/guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/tools/guide.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;KAChC,CAAC;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAyBD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA8CA,UAAU;;;;;;;;;;;;;CA2E/B,CAAC"}