@adobe/design-data-mcp 1.8.13 → 1.9.0

package/README.md

@@ -59,15 +59,16 @@ any network failure (offline/air-gapped use is unaffected); set
 
 ## Tools
 
-| Tool                         | Description                                                                        |
-| ---------------------------- | ---------------------------------------------------------------------------------- |
-| `design-data-primer`         | Session-start overview: token count, mode-sets, components, guidelines, provenance |
-| `design-data-query`          | Filter tokens by query expression (`component=button`, `property=color-*`)         |
-| `design-data-suggest`        | Natural-language token suggestions with Jaccard similarity confidence scores       |
-| `design-data-component`      | Full component schema (variants, sizes, states, props) by kebab-case ID            |
-| `design-data-resolve`        | Resolve a token's concrete value for a mode context (colorScheme, scale, contrast) |
-| `design-data-guideline-list` | List available Spectrum design guideline pages, optionally filtered by category    |
-| `design-data-guideline`      | Full guideline document by slug ID (purpose, rules, accessibility, examples)       |
+| Tool                           | Description                                                                         |
+| ------------------------------ | ----------------------------------------------------------------------------------- |
+| `design-data-primer`           | Session-start overview: token count, mode-sets, components, guidelines, provenance  |
+| `design-data-query`            | Filter tokens by query expression (`component=button`, `property=color-*`)          |
+| `design-data-suggest`          | Natural-language token suggestions with Jaccard similarity confidence scores        |
+| `design-data-component`        | Full component schema (variants, sizes, states, props) by kebab-case ID             |
+| `design-data-component-search` | Search components by name, description, or docs text; returns id, category, snippet |
+| `design-data-resolve`          | Resolve a token's concrete value for a mode context (colorScheme, scale, contrast)  |
+| `design-data-guideline-list`   | List available Spectrum design guideline pages, optionally filtered by category     |
+| `design-data-guideline`        | Full guideline document by slug ID (purpose, rules, accessibility, examples)        |
 
 ## Testing guideline content
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/design-data-mcp",
-  "version": "1.8.13",
+  "version": "1.9.0",
   "description": "MCP server for Spectrum design tokens, component schemas, and design guidelines (embedded, offline)",
   "type": "module",
   "main": "./src/index.js",
@@ -29,9 +29,9 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@adobe/design-data": "3.2.11",
-    "@adobe/design-data-wasm": "0.12.0",
-    "@adobe/spectrum-design-data": "3.8.0"
+    "@adobe/design-data-wasm": "0.14.0",
+    "@adobe/spectrum-design-data": "3.8.0",
+    "@adobe/design-data": "3.3.0"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "^2.1.2",

package/src/tools/design-data.js

@@ -20,6 +20,7 @@ import { createRequire } from "module";
 import { readFileSync, existsSync } from "fs";
 import { join, dirname, resolve, sep } from "path";
 
+import { searchComponents } from "@adobe/design-data/component";
 import { listGuidelines, loadGuideline } from "@adobe/design-data/guideline";
 
 import { checkDatasetFreshness } from "../dataset-freshness.js";
@@ -286,6 +287,60 @@ export function createDesignDataTools() {
       },
     },
 
+    // ── component search ────────────────────────────────────────────────────
+    {
+      name: "design-data-component-search",
+      annotations: {
+        title: "Design Data: Search Components",
+        readOnlyHint: true,
+        openWorldHint: false,
+      },
+      description:
+        "Search Spectrum components by name, description, or documentation text " +
+        '(e.g. "date", "form input", "navigation"). Returns id, displayName, ' +
+        "category, and a snippet per match. Use the id with design-data-component " +
+        "for the full declaration.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: {
+            type: "string",
+            description: "Words to look for, e.g. 'select from a list'",
+          },
+          category: {
+            type: "string",
+            description: "Optional component category filter, e.g. actions",
+          },
+          limit: {
+            type: "integer",
+            minimum: 1,
+            description: "Maximum number of results (default: 10)",
+            default: 10,
+          },
+        },
+        required: ["query"],
+        additionalProperties: false,
+      },
+      async handler({ query, category, limit = 10 }) {
+        const pkgRoot = resolveSpectrumDataPackage();
+        if (!pkgRoot) {
+          throw new Error(
+            "@adobe/spectrum-design-data is not installed — cannot search components. " +
+              "Install it with: pnpm add @adobe/spectrum-design-data",
+          );
+        }
+        const results = searchComponents(
+          resolve(pkgRoot, "components"),
+          query,
+          {
+            category,
+            limit,
+          },
+        );
+        return { results, total: results.length };
+      },
+    },
+
     // ── resolve ─────────────────────────────────────────────────────────────
     {
       name: "design-data-resolve",