@shadsapp/mcp 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,190 @@
+# @shadsapp/mcp
+
+MCP server for [shads.app](https://shads.app). It gives AI clients access to curated shadcn/ui themes, theme validation, registry URLs, theme skills, and installation plans.
+
+The server uses the MCP **stdio transport**. It runs as a child process started by an MCP client such as Claude Desktop, Cursor, VS Code, or another MCP host.
+
+## Requirements
+
+- Node.js 18 or newer
+- Internet access for registry tools (`resolve_share`, `get_system`, `get_skill`, and `install_plan`)
+- A project using the shadcn CLI for generated install commands
+
+`list_themes`, `get_theme`, `validate_theme`, `theme_schema`, and `list_starters` work from the installed package without a network request.
+
+## Installation
+
+### Run directly with npx
+
+This is the simplest option. The MCP client downloads the package when it starts the server:
+
+```bash
+npx -y @shadsapp/mcp
+```
+
+Use the following configuration in an MCP client that supports JSON server configuration:
+
+```json
+{
+  "mcpServers": {
+    "shads": {
+      "command": "npx",
+      "args": ["-y", "@shadsapp/mcp"]
+    }
+  }
+}
+```
+
+### Install globally
+
+```bash
+npm install --global @shadsapp/mcp
+shads-mcp
+```
+
+Then configure the client with:
+
+```json
+{
+  "mcpServers": {
+    "shads": {
+      "command": "shads-mcp"
+    }
+  }
+}
+```
+
+### Install locally in a project
+
+```bash
+npm install --save-dev @shadsapp/mcp
+```
+
+Use an absolute executable path when the MCP host does not inherit your project's `node_modules/.bin` path. For example:
+
+```json
+{
+  "mcpServers": {
+    "shads": {
+      "command": "/absolute/path/to/project/node_modules/.bin/shads-mcp"
+    }
+  }
+}
+```
+
+On Windows, use the generated `shads-mcp.cmd` path or run through `npx.cmd`:
+
+```json
+{
+  "mcpServers": {
+    "shads": {
+      "command": "npx.cmd",
+      "args": ["-y", "@shadsapp/mcp"]
+    }
+  }
+}
+```
+
+## Client setup
+
+Add the configuration to the MCP client's server settings, then restart the client. The server communicates over stdin/stdout, so do not add logging or other output to stdout in a wrapper script. Diagnostics belong on stderr.
+
+If the client supports an explicit working directory, set it to the project where shadcn commands should run. The MCP server itself does not modify that project; it returns install commands for the agent or user to review and run.
+
+## Available tools
+
+| Tool | Input | Purpose |
+|------|-------|---------|
+| `list_themes` | `{}` | List bundled starter theme metadata. |
+| `get_theme` | `{ "id": "workspace" }` | Return a bundled theme and CSS. |
+| `validate_theme` | `{ "source": "..." }` | Validate raw or fenced `theme.json` text. |
+| `theme_schema` | `{}` | Return the active schema id. |
+| `list_starters` | `{}` | List starter registry and skill URLs. |
+| `get_install_prompt` | `{ "item": "workspace", "mode": "both" }` | Return a copyable install prompt. |
+| `resolve_share` | `{ "item": "abc123" }` | Resolve a registry/share item and return its prompt. |
+| `get_system` | `{ "id": "workspace" }` | Return theme, skill, dependencies, and install data. |
+| `get_skill` | `{ "id": "workspace" }` | Return the theme-specific skill markdown. |
+| `install_plan` | `{ "id": "workspace", "mode": "existing" }` | Return validated install commands and notes. |
+
+Starter names such as `workspace` are converted to registry item ids such as `workspace-theme`. You may also provide a theme item id, a share id, or a registry URL such as `https://shads.app/r/workspace-theme.json`.
+
+Registry item ids accept only letters, numbers, hyphens, and underscores. This keeps generated shell commands safe to review and execute.
+
+## Typical workflows
+
+### Install a starter into an existing app
+
+1. Call `get_system` with `{ "id": "workspace" }`.
+2. Review the returned theme URL, skill markdown, dependencies, and prompt.
+3. Call `install_plan` with mode `existing` if you only need the command.
+4. Run the returned command from the target shadcn project.
+
+### Create a new app from a starter
+
+Call `get_install_prompt` with mode `new`:
+
+```json
+{
+  "item": "workspace",
+  "mode": "new"
+}
+```
+
+The result contains the `shadcn create` command and the relevant theme skill instructions.
+
+### Validate a theme document
+
+Pass the complete JSON text or a fenced JSON block:
+
+````json
+{
+  "source": "```json\n{\"$schema\":\"shads-theme/v1\",\"config\":{}}\n```"
+}
+````
+
+The result has `ok: true` and a normalized document when valid, or `ok: false` with a list of validation errors.
+
+## Troubleshooting
+
+### The client cannot start the server
+
+Check that Node.js 18 or newer is available to the client process:
+
+```bash
+node --version
+npx -y @shadsapp/mcp
+```
+
+For GUI clients, use an absolute command path or configure the full path to `npx`/`npx.cmd`. GUI applications often have a smaller `PATH` than your shell.
+
+### The server starts but registry tools fail
+
+The remote registry tools require network access to `https://shads.app`. Check that the client process can reach the registry and that the item exists. Remote requests fail with a bounded timeout rather than waiting indefinitely.
+
+### Install commands do not affect the project
+
+The server only returns commands. Run them from the target shadcn project, or configure the MCP host's working directory when supported.
+
+## Development
+
+From the repository root:
+
+```bash
+npm install
+npm run test -w @shadsapp/mcp
+npm run typecheck -w @shadsapp/mcp
+npm run build -w @shadsapp/mcp
+npm pack -w @shadsapp/mcp --dry-run
+```
+
+The published package contains `dist`, the executable entrypoint, and this README. The server uses stderr for fatal startup diagnostics and reserves stdout for MCP protocol messages.
+
+## Related packages
+
+- [`@shadsapp/schema`](https://www.npmjs.com/package/@shadsapp/schema)
+- [`@shadsapp/themes`](https://www.npmjs.com/package/@shadsapp/themes)
+- [`@shadsapp/cli`](https://www.npmjs.com/package/@shadsapp/cli)
+
+## License
+
+MIT

package/dist/index.js

@@ -4,9 +4,10 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { parseThemeDocumentInput, THEME_SCHEMA } from "@shadsapp/schema";
 import { getTheme, listThemes } from "@shadsapp/themes";
+import { buildAgentInstallPrompt, buildInstallPlan, listStarterInstallEntries, REGISTRY_HOMEPAGE, resolveSafeItemId, systemSkillItemId, } from "./install-prompt.js";
 const server = new Server({
     name: "shads",
-    version: "0.1.0",
+    version: "0.1.1",
 }, {
     capabilities: {
         tools: {},
@@ -62,8 +63,122 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 additionalProperties: false,
             },
         },
+        {
+            name: "list_starters",
+            description: "List all shads starter themes with registry install URLs for agents",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "get_install_prompt",
+            description: "Return a copyable agent install prompt for a starter, share id, or registry URL",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    item: {
+                        type: "string",
+                        description: "Starter id (workspace), theme item id, share id, or full registry URL",
+                    },
+                    mode: {
+                        type: "string",
+                        enum: ["existing", "new", "both"],
+                        description: "Which install commands to include (default both)",
+                    },
+                },
+                required: ["item"],
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "resolve_share",
+            description: "Resolve a share or registry item URL and return title plus install prompt",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    item: {
+                        type: "string",
+                        description: "Share id, theme item id, or registry URL",
+                    },
+                },
+                required: ["item"],
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "get_system",
+            description: "Fetch a full theme package: registry theme, theme skill markdown, and install URLs",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: {
+                        type: "string",
+                        description: "Starter id (workspace), theme item id, share id, or registry URL",
+                    },
+                },
+                required: ["id"],
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "get_skill",
+            description: "Return the theme-specific skill markdown for a starter or share",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: {
+                        type: "string",
+                        description: "Starter id, theme item id, share id, or registry URL",
+                    },
+                },
+                required: ["id"],
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "install_plan",
+            description: "Ordered shell commands to install a system into a new or existing project",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: {
+                        type: "string",
+                        description: "Starter id, theme item id, share id, or registry URL",
+                    },
+                    mode: {
+                        type: "string",
+                        enum: ["new", "existing"],
+                        description: "Install target (default existing)",
+                    },
+                },
+                required: ["id"],
+                additionalProperties: false,
+            },
+        },
     ],
 }));
+const REGISTRY_FETCH_TIMEOUT_MS = 10_000;
+async function fetchRegistryItem(itemId) {
+    try {
+        const response = await fetch(`${REGISTRY_HOMEPAGE}/r/${itemId}.json`, {
+            headers: { Accept: "application/json" },
+            signal: AbortSignal.timeout(REGISTRY_FETCH_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            return null;
+        }
+        return (await response.json());
+    }
+    catch {
+        return null;
+    }
+}
+function skillMarkdownFromItem(item) {
+    const skillFile = item.files?.find((file) => file.target?.endsWith("SKILL.md"));
+    return skillFile?.content ?? null;
+}
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     switch (request.params.name) {
         case "list_themes": {
@@ -115,6 +230,180 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 ],
             };
         }
+        case "list_starters": {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(listStarterInstallEntries(), null, 2),
+                    },
+                ],
+            };
+        }
+        case "get_install_prompt": {
+            const item = String(request.params.arguments?.item ?? "");
+            const mode = request.params.arguments?.mode;
+            const itemId = resolveSafeItemId(item);
+            const prompt = buildAgentInstallPrompt({ itemId, mode });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: prompt,
+                    },
+                ],
+            };
+        }
+        case "resolve_share": {
+            const item = String(request.params.arguments?.item ?? "");
+            const itemId = resolveSafeItemId(item);
+            const registryItem = await fetchRegistryItem(itemId);
+            if (!registryItem) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "Registry item not found",
+                                itemId,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const prompt = buildAgentInstallPrompt({
+                itemId,
+                title: registryItem.title ?? registryItem.name,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            itemId,
+                            title: registryItem.title ?? registryItem.name ?? itemId,
+                            prompt,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        case "get_system": {
+            const id = String(request.params.arguments?.id ?? "");
+            const itemId = resolveSafeItemId(id);
+            const themeItem = await fetchRegistryItem(itemId);
+            if (!themeItem) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: "Registry item not found", itemId }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const skillItemId = systemSkillItemId(itemId);
+            const skillItem = await fetchRegistryItem(skillItemId);
+            const skillMarkdown = skillItem
+                ? skillMarkdownFromItem(skillItem)
+                : null;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            itemId,
+                            title: themeItem.title ?? themeItem.name ?? itemId,
+                            themeUrl: `${REGISTRY_HOMEPAGE}/r/${itemId}.json`,
+                            skillItemId,
+                            skillUrl: `${REGISTRY_HOMEPAGE}/r/${skillItemId}.json`,
+                            skillMarkdown,
+                            registryDependencies: themeItem.registryDependencies ?? [],
+                            installPrompt: buildAgentInstallPrompt({
+                                itemId,
+                                title: themeItem.title ?? themeItem.name,
+                            }),
+                            installPlan: buildInstallPlan({
+                                itemId,
+                                title: themeItem.title ?? themeItem.name,
+                                mode: "existing",
+                            }),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        case "get_skill": {
+            const id = String(request.params.arguments?.id ?? "");
+            const itemId = resolveSafeItemId(id);
+            const skillItemId = itemId.endsWith("-skill")
+                ? itemId
+                : systemSkillItemId(itemId);
+            const skillItem = await fetchRegistryItem(skillItemId);
+            if (!skillItem) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: "System skill not found", skillItemId }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const markdown = skillMarkdownFromItem(skillItem);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: markdown ??
+                            JSON.stringify({ error: "Skill markdown missing", skillItemId }, null, 2),
+                    },
+                ],
+                isError: !markdown,
+            };
+        }
+        case "install_plan": {
+            const id = String(request.params.arguments?.id ?? "");
+            const mode = request.params.arguments?.mode === "new" ? "new" : "existing";
+            const itemId = resolveSafeItemId(id);
+            const registryItem = await fetchRegistryItem(itemId);
+            if (!registryItem) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: "Registry item not found", itemId }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const plan = buildInstallPlan({
+                itemId,
+                mode,
+                title: registryItem?.title ?? registryItem?.name,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            itemId,
+                            mode,
+                            ...plan,
+                            prompt: buildAgentInstallPrompt({
+                                itemId,
+                                mode: mode === "new" ? "new" : "existing",
+                                title: registryItem?.title ?? registryItem?.name,
+                            }),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
         default:
             throw new Error(`Unknown tool: ${request.params.name}`);
     }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAA;AAE3C,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAEvD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAA;AAED,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE;QACL;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,0CAA0C;YACvD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;gBACd,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,oDAAoD;YACjE,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,EAAE,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,0BAA0B;qBACxC;iBACF;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;gBAChB,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,uCAAuC;YACpD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,oCAAoC;qBAClD;iBACF;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;gBACpB,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,kDAAkD;YAC/D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;gBACd,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF;CACF,CAAC,CAAC,CAAA;AAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,QAAQ,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5B,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC5C;iBACF;aACF,CAAA;QACH,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;YACrD,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAA;YAC3B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,EAAE,EAAE,MAAM,CAAC,EAAE;4BACb,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,KAAK,EAAE,MAAM,CAAC,KAAK;4BACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;yBAC1B,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAA;QACH,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,IAAI,EAAE,CAAC,CAAA;YAC7D,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAA;YAC9C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAA;QACH,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,YAAY;qBACnB;iBACF;aACF,CAAA;QACH,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC,CAAC,CAAA;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/install-prompt.d.ts

@@ -0,0 +1,34 @@
+export declare const REGISTRY_HOMEPAGE = "https://shads.app";
+export declare const STARTER_PRESET_IDS: readonly ["workspace", "brief", "insights", "dispatch", "ledger", "canvas", "terminal", "launch", "commerce", "campus", "editorial"];
+export type AgentInstallPromptMode = "existing" | "new" | "both";
+export declare function assertSafeItemId(itemId: string): void;
+export declare function registryItemUrl(origin: string, itemId: string): string;
+export declare function registryInstallCommand(itemId: string, origin?: string): string;
+export declare function registryCreateCommand(itemId: string, origin?: string): string;
+export declare function starterThemeItemId(presetId: string): string;
+export declare function systemSkillItemId(themeItemId: string): string;
+export declare function resolveItemIdFromInput(input: string): string;
+export declare function resolveSafeItemId(input: string): string;
+export declare function buildAgentInstallPrompt(options: {
+    itemId: string;
+    origin?: string;
+    title?: string;
+    mode?: AgentInstallPromptMode;
+}): string;
+export declare function buildInstallPlan(options: {
+    itemId: string;
+    origin?: string;
+    mode?: "new" | "existing";
+    title?: string;
+}): {
+    commands: string[];
+    notes: string[];
+};
+export declare function listStarterInstallEntries(origin?: string): {
+    id: "workspace" | "brief" | "insights" | "dispatch" | "ledger" | "canvas" | "terminal" | "launch" | "commerce" | "campus" | "editorial";
+    itemId: string;
+    url: string;
+    skillItemId: string;
+    skillUrl: string;
+}[];
+//# sourceMappingURL=install-prompt.d.ts.map

package/dist/install-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-prompt.d.ts","sourceRoot":"","sources":["../src/install-prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AAEpD,eAAO,MAAM,kBAAkB,sIAYrB,CAAA;AAEV,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,CAAA;AAIhE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,SAAoB,GACzB,MAAM,CAER;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,SAAoB,GACzB,MAAM,CAER;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAa5D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,sBAAsB,CAAA;CAC9B,GAAG,MAAM,CA4CT;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAkB1C;AAED,wBAAgB,yBAAyB,CAAC,MAAM,SAAoB;;;;;;IAQnE"}

package/dist/install-prompt.js

@@ -0,0 +1,110 @@
+export const REGISTRY_HOMEPAGE = "https://shads.app";
+export const STARTER_PRESET_IDS = [
+    "workspace",
+    "brief",
+    "insights",
+    "dispatch",
+    "ledger",
+    "canvas",
+    "terminal",
+    "launch",
+    "commerce",
+    "campus",
+    "editorial",
+];
+const ITEM_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
+export function assertSafeItemId(itemId) {
+    if (!ITEM_ID_PATTERN.test(itemId)) {
+        throw new Error("Invalid registry item id. Use letters, numbers, hyphens, or underscores only.");
+    }
+}
+export function registryItemUrl(origin, itemId) {
+    assertSafeItemId(itemId);
+    return `${origin}/r/${itemId}.json`;
+}
+export function registryInstallCommand(itemId, origin = REGISTRY_HOMEPAGE) {
+    return `npx shadcn@latest add ${registryItemUrl(origin, itemId)}`;
+}
+export function registryCreateCommand(itemId, origin = REGISTRY_HOMEPAGE) {
+    return `npx shadcn@latest create --name my-app --template next --preset ${registryItemUrl(origin, itemId)}`;
+}
+export function starterThemeItemId(presetId) {
+    return `${presetId}-theme`;
+}
+export function systemSkillItemId(themeItemId) {
+    return `${themeItemId}-skill`;
+}
+export function resolveItemIdFromInput(input) {
+    const trimmed = input.trim();
+    const urlMatch = trimmed.match(/\/r\/([^/?#]+?)(?:\.json)?(?:[/?#]|$)/);
+    if (urlMatch?.[1]) {
+        return urlMatch[1];
+    }
+    if (trimmed.endsWith("-theme") || trimmed.endsWith("-skill")) {
+        return trimmed;
+    }
+    if (STARTER_PRESET_IDS.includes(trimmed)) {
+        return starterThemeItemId(trimmed);
+    }
+    return trimmed;
+}
+export function resolveSafeItemId(input) {
+    const itemId = resolveItemIdFromInput(input);
+    assertSafeItemId(itemId);
+    return itemId;
+}
+export function buildAgentInstallPrompt(options) {
+    assertSafeItemId(options.itemId);
+    const origin = options.origin ?? REGISTRY_HOMEPAGE;
+    const mode = options.mode ?? "both";
+    const globalSkillCommand = registryInstallCommand("skill", origin);
+    const systemSkillCommand = registryInstallCommand(systemSkillItemId(options.itemId), origin);
+    const addCommand = registryInstallCommand(options.itemId, origin);
+    const createCommand = registryCreateCommand(options.itemId, origin);
+    const lines = [
+        options.title
+            ? `Install this shads.app theme: ${options.title}.`
+            : "Install this shads.app theme.",
+        "",
+        "Use the official shadcn CLI. Do not paste CSS or edit components/ui.",
+        "Use semantic tokens (bg-primary, text-muted-foreground, border-border).",
+        "Do not invent a palette — follow the installed theme skill.",
+        "Adapters and the theme skill install as registry dependencies automatically.",
+        "",
+    ];
+    if (mode === "new" || mode === "both") {
+        lines.push("## New project", "", "```bash", createCommand, "```", "");
+    }
+    if (mode === "existing" || mode === "both") {
+        lines.push("## Existing project", "", "```bash", addCommand, "```", "");
+    }
+    lines.push("## Agent rules", "", "Theme install pulls the theme skill. Optionally install the global workflow skill once:", "", "```bash", systemSkillCommand, globalSkillCommand, "```");
+    return lines.join("\n");
+}
+export function buildInstallPlan(options) {
+    assertSafeItemId(options.itemId);
+    const origin = options.origin ?? REGISTRY_HOMEPAGE;
+    const mode = options.mode ?? "existing";
+    const commands = mode === "new"
+        ? [registryCreateCommand(options.itemId, origin)]
+        : [registryInstallCommand(options.itemId, origin)];
+    return {
+        commands,
+        notes: [
+            "Theme install pulls adapters + theme skill via registryDependencies.",
+            "Do not paste CSS or edit components/ui.",
+            "Prefer the theme skill over inventing a palette.",
+            ...(options.title ? [`Theme: ${options.title}`] : []),
+        ],
+    };
+}
+export function listStarterInstallEntries(origin = REGISTRY_HOMEPAGE) {
+    return STARTER_PRESET_IDS.map((id) => ({
+        id,
+        itemId: starterThemeItemId(id),
+        url: registryItemUrl(origin, starterThemeItemId(id)),
+        skillItemId: systemSkillItemId(starterThemeItemId(id)),
+        skillUrl: registryItemUrl(origin, systemSkillItemId(starterThemeItemId(id))),
+    }));
+}
+//# sourceMappingURL=install-prompt.js.map

package/dist/install-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-prompt.js","sourceRoot":"","sources":["../src/install-prompt.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@shadsapp/mcp",
-  "version": "0.1.0",
-  "description": "MCP server for shads theme discovery and validation",
+  "version": "0.1.2",
+  "description": "MCP server that lets AI agents list, fetch, and validate shads.app shadcn/ui themes",
   "type": "module",
   "license": "MIT",
   "bin": {
     "shads-mcp": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "exports": {
     ".": {
@@ -18,14 +19,21 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.5",
-    "@shadsapp/schema": "0.1.0",
-    "@shadsapp/themes": "0.1.0"
+    "@shadsapp/schema": "0.1.1",
+    "@shadsapp/themes": "0.1.2"
+  },
+  "devDependencies": {
+    "vitest": "^5.0.0"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
   }
 }