@urbicon-ui/mcp-server 8.16.0 → 8.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urbicon-ui/mcp-server",
-  "version": "8.16.0",
+  "version": "8.18.0",
   "description": "Model Context Protocol server exposing the Urbicon UI component catalog, recipes and design intelligence to LLM agents",
   "license": "MIT",
   "repository": {
@@ -39,8 +39,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@urbicon-ui/design-content": "8.16.0",
-    "@urbicon-ui/design-engine": "8.16.0",
+    "@urbicon-ui/design-content": "8.18.0",
+    "@urbicon-ui/design-engine": "8.18.0",
     "zod": "^4.5.4"
   },
   "devDependencies": {

package/src/tools/find-components.ts

@@ -7,14 +7,14 @@ import { formatCompactCatalog, formatComponentLine } from '../utils/format-catal
 /**
  * Register the `find_components` tool: the catalog entry point. With no query it
  * renders the full catalog grouped by category (via `formatCompactCatalog`);
- * with a query it fuzzy-matches names/descriptions/tags through the engine's
- * `matchComponents` (top 10). Every line keeps the origin-package tag so a
+ * with a query it fuzzy-matches names, descriptions, summaries, prop docs, variant
+ * values and tags through the engine's `matchComponents` (top 10). Every line keeps the origin-package tag so a
  * non-blocks match (e.g. `Table`) is never mistaken for a blocks export.
  */
 export function registerFindComponentsTool(server: McpServer): void {
   server.tool(
     'find_components',
-    'Browse and search the Urbicon UI component catalog. Without a query, lists all components grouped by category. With a query, performs fuzzy search across names, descriptions, and tags.',
+    'Browse and search the Urbicon UI component catalog. Without a query, lists all components grouped by category. With a query, performs fuzzy search across names, descriptions, summaries, prop docs, variant values and tags.',
     {
       query: z
         .string()

package/src/tools/get-checklist.ts

@@ -1,4 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { isBooleanAxis } from '@urbicon-ui/design-engine/search';
 import { z } from 'zod';
 import { loadCatalog } from '../data/catalog-loader.js';
 
@@ -118,7 +119,7 @@ export function registerGetChecklistTool(server: McpServer): void {
             md += `### ${comp.name}\n`;
             if (comp.variants.length > 0) {
               const key = comp.variants
-                .filter((v) => !['true', 'false'].every((b) => v.values.includes(b)))
+                .filter((v) => !isBooleanAxis(v.values))
                 .map((v) => `\`${v.name}\`: ${v.values.join(' / ')}`)
                 .join(', ');
               if (key) md += `- Variants: ${key}\n`;

package/src/tools/get-component.ts

@@ -1,4 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { isBooleanAxis } from '@urbicon-ui/design-engine/search';
 import { z } from 'zod';
 import type { ComponentCatalogEntry } from '../data/catalog-loader.js';
 import { loadCatalog } from '../data/catalog-loader.js';
@@ -91,13 +92,7 @@ function generateCompactView(entry: ComponentCatalogEntry, llmContent: string):
   }
 
   // Variants (if any meaningful ones exist beyond what's in keyPropTypes)
-  const meaningfulVariants = entry.variants.filter((v) => {
-    const sorted = [...v.values].sort();
-    return !(
-      (sorted.length === 1 && (sorted[0] === 'true' || sorted[0] === 'false')) ||
-      (sorted.length === 2 && sorted[0] === 'false' && sorted[1] === 'true')
-    );
-  });
+  const meaningfulVariants = entry.variants.filter((v) => !isBooleanAxis(v.values));
 
   if (meaningfulVariants.length > 0) {
     md += '## Variants\n\n';

package/src/tools/suggest-implementation.ts

@@ -1,5 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { matchComponents } from '@urbicon-ui/design-engine/search';
+import { isBooleanAxis, matchComponents } from '@urbicon-ui/design-engine/search';
 import { z } from 'zod';
 import type { ComponentCatalogEntry } from '../data/catalog-loader.js';
 import { loadCatalog } from '../data/catalog-loader.js';
@@ -166,13 +166,7 @@ export function registerSuggestImplementationTool(server: McpServer): void {
       md += '## Components\n\n';
       for (const comp of matched) {
         const meaningfulVariants = comp.variants
-          .filter((v) => {
-            const sorted = [...v.values].sort();
-            return !(
-              (sorted.length === 1 && (sorted[0] === 'true' || sorted[0] === 'false')) ||
-              (sorted.length === 2 && sorted[0] === 'false' && sorted[1] === 'true')
-            );
-          })
+          .filter((v) => !isBooleanAxis(v.values))
           .map((v) => {
             const def = v.default ? ` (default: ${v.default})` : '';
             return `${v.name}: ${v.values.join('/')}${def}`;

package/src/utils/format-catalog.ts

@@ -1,3 +1,4 @@
+import { isBooleanAxis } from '@urbicon-ui/design-engine/search';
 import type { ComponentCatalogEntry, RecipeEntry } from '../data/catalog-loader.js';
 
 /**
@@ -119,14 +120,6 @@ export function formatCompactCatalog(
   return md;
 }
 
-function isBooleanVariant(values: string[]): boolean {
-  const sorted = [...values].sort();
-  return (
-    (sorted.length === 1 && (sorted[0] === 'true' || sorted[0] === 'false')) ||
-    (sorted.length === 2 && sorted[0] === 'false' && sorted[1] === 'true')
-  );
-}
-
 /**
  * Format one catalog entry as a single markdown bullet: name, an origin-package
  * tag for non-blocks components (so `Table` reads as `@urbicon-ui/table`), the
@@ -135,7 +128,7 @@ function isBooleanVariant(values: string[]): boolean {
  */
 export function formatComponentLine(comp: ComponentCatalogEntry): string {
   const variants = comp.variants
-    .filter((v) => !isBooleanVariant(v.values))
+    .filter((v) => !isBooleanAxis(v.values))
     .map((v) => `${v.name}: ${v.values.join('/')}`)
     .join(' · ');