wunderui-mcp 1.1.0 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wunderui-mcp",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "mcpName": "io.github.Kl-webmedia/wunderui-mcp",
   "description": "MCP server that gives AI coding agents the WunderUI design system: tokens, component props, templates and starters. Works with Claude Code, Cursor, Windsurf, Cline and Codex.",
   "keywords": [
@@ -46,7 +46,7 @@
     "smoke": "node ./test/smoke.mjs"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@modelcontextprotocol/sdk": "^1.32.1",
     "zod": "^4.6.5"
   }
 }

package/src/index.mjs

@@ -218,13 +218,31 @@ server.registerTool(
   {
     title: "Get a WunderUI component",
     description:
-      "Everything needed to use one component correctly: its exported names, the TypeScript prop signature straight from the build, the import line and a link to its documentation page.",
+      "Everything needed to use one component correctly: its exported names, the TypeScript prop signature straight from the build, a props table per export (type, allowed values, default, required, description), its anatomy (parts and data-slot names), best practices, the CSS variables it reads with their defaults, the import line and a link to its documentation page. Also answers for hooks (signature, parameters, return value, notes), providers and utilities (useToast, ThemeProvider …).",
     inputSchema: {
       name: z.string().describe('Export name ("DataGrid"), slug ("data-grid") or title ("Data Grid")'),
     },
   },
   async ({ name }) => {
     const component = findComponent(name)
+    const other = component ? null : (design.otherExports ?? []).find((entry) => normalize(entry.name) === normalize(name))
+    if (other) {
+      return text({
+        name: other.name,
+        kind: other.kind,
+        plan: other.tier ?? "pro",
+        description: other.summary ?? other.description ?? undefined,
+        guide: other.guide ?? undefined,
+        import: `import { ${other.name} } from "${design.name}"`,
+        signature: other.signature ?? undefined,
+        params: other.params?.length ? other.params : undefined,
+        returns: other.returns ?? undefined,
+        notes: other.notes ?? undefined,
+        examples: other.examples ?? undefined,
+        propsTable: other.props ? [{ name: other.name, props: other.props, inherits: other.inherits }] : undefined,
+        docs: other.docs ?? undefined,
+      })
+    }
     if (!component) {
       const suggestions = design.components
         .filter((candidate) => matches(candidate, name))
@@ -249,6 +267,13 @@ server.registerTool(
       exports: component.exports,
       example: component.example ?? undefined,
       props: component.props ?? "No generated signature — see the documentation page.",
+      // per export: name, type, values (literal unions), default, required, description; DOM attributes summed up in inherits
+      propsTable: component.api?.length ? component.api : undefined,
+      // the guide: parts (export, data-slot, required, a sentence), do/don't/when notes, and the CSS
+      // variables the component reads with their defaults; `source` "generated" = drafted from the code
+      anatomy: component.anatomy ?? undefined,
+      bestPractices: component.bestPractices ?? undefined,
+      themingVariables: component.themingVariables ?? undefined,
       docs: component.docs,
     })
   }
@@ -377,7 +402,16 @@ server.registerTool(
 
 const siteUrl = () => (process.env.WUNDERUI_SITE ?? design.site ?? "https://wunderui.com").replace(/\/$/, "")
 const licenseKey = () => process.env.WUNDERUI_LICENSE_KEY?.trim() || null
-const authHeaders = () => (licenseKey() ? { authorization: `Bearer ${licenseKey()}` } : {})
+/** The key goes to wunderui.com (or a local dev server) only, never to another WUNDERUI_SITE. */
+const keyAllowed = () => {
+  try {
+    const { protocol, hostname } = new URL(siteUrl())
+    return (protocol === "https:" && (hostname === "wunderui.com" || hostname === "www.wunderui.com")) || ["localhost", "127.0.0.1", "[::1]"].includes(hostname)
+  } catch {
+    return false
+  }
+}
+const authHeaders = () => (licenseKey() && keyAllowed() ? { authorization: `Bearer ${licenseKey()}` } : {})
 let instructions = null
 try {
   instructions = readFileSync(resolve(dataDir, "INSTRUCTIONS.md"), "utf8")