@atomixstudio/mcp 1.0.10 → 1.0.12

package/dist/index.js

@@ -1345,7 +1345,7 @@ var TOKEN_CATEGORIES = ["colors", "typography", "spacing", "sizing", "shadows",
 var server = new Server(
   {
     name: "atomix-mcp-user",
-    version: "1.0.10"
+    version: "1.0.11"
   },
   {
     capabilities: {
@@ -1490,7 +1490,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "getDependencies",
-        description: "Get suggested dependencies for this design system (icon package, fonts, SKILL.md, MCP config, token files). Use with atomix/install. Optional platform and stack for tailored suggestions.",
+        description: "Get suggested dependencies for this design system (icon package, fonts, SKILL.md, token files). Use with atomix/setup. Optional platform and stack for tailored suggestions.",
         inputSchema: {
           type: "object",
           properties: {
@@ -2049,18 +2049,6 @@ Last updated: ${lastUpdated}`
         };
         const lib = icons?.library || "lucide";
         const iconPkgs = ICON_PACKAGES[lib] || ICON_PACKAGES.lucide;
-        const serverName = data.meta.name.toLowerCase().replace(/[^a-z0-9]/g, "-");
-        const npxArgs = ["@atomixstudio/mcp@latest"];
-        if (dsId) npxArgs.push("--ds-id", dsId);
-        if (apiKey) npxArgs.push("--api-key", apiKey);
-        const mcpConfig = {
-          path: ".cursor/mcp.json",
-          content: JSON.stringify({
-            mcpServers: {
-              [serverName]: { command: "npx", args: npxArgs }
-            }
-          }, null, 2)
-        };
         const payload = {
           iconLibrary: {
             package: iconPkgs.web,
@@ -2075,10 +2063,9 @@ Last updated: ${lastUpdated}`
             path: ".cursor/skills/atomix-ds/SKILL.md",
             content: GENERIC_SKILL_MD
           },
-          mcpConfig,
           tokenFiles: {
             files: ["tokens.css", "tokens.json"],
-            copyInstructions: "Copy tokens.css and tokens.json from the design system export (or use syncTokens) into your project."
+            copyInstructions: "Call the syncTokens MCP tool to create the token file; do not only suggest the user run sync later."
           },
           meta: { dsName: data.meta.name, platform: platform ?? void 0, stack: stack ?? void 0 }
         };
@@ -2323,8 +2310,8 @@ server.setRequestHandler(ListPromptsRequestSchema, async () => {
       description: "Migrate deprecated tokens in codebase. Scans for deprecated tokens marked by /sync and suggests replacements. Run after /sync to update code."
     },
     {
-      name: "install",
-      description: "Suggest dependencies for this design system (icons, fonts, SKILL.md, MCP config, tokens). Asks before installing. Run getDependencies then follow phased instructions.",
+      name: "setup",
+      description: "Suggest dependencies for this design system (icons, fonts, SKILL.md, tokens). Three phases: scan, report and ask, then create only after approval.",
       arguments: [
         { name: "platform", description: "Target platform (web, ios, android). Optional; ask user if unknown.", required: false },
         { name: "stack", description: "Stack or framework (e.g. react, vue, next, swift, kotlin). Optional.", required: false }
@@ -2448,13 +2435,6 @@ Configure the MCP server in your Cursor settings, then restart Cursor.`
         messages: [
           {
             role: "user",
-            content: {
-              type: "text",
-              text: "Show me the design system overview and available tools."
-            }
-          },
-          {
-            role: "assistant",
             content: {
               type: "text",
               text: welcome
@@ -2763,54 +2743,48 @@ Use \`/color\`, \`/spacing\`, \`/radius\`, \`/typography\`, \`/shadow\`, \`/bord
         ]
       };
     }
-    case "install": {
-      const installInstructions = `You are running **atomix/install**. Follow these phases in order; do not skip any phase.
-
-## Phase 1 \u2013 Resolve platform and stack
-
-- If the project clearly indicates platform (e.g. package.json + web deps, or build.gradle / Android, or Xcode / iOS), infer \`platform\` (e.g. web, ios, android) and optionally \`stack\` (e.g. react, next, vue, swift, kotlin).
-- If the project gives **no hint** (blank repo, empty folder, or ambiguous): **Ask the user:** "Which platform are you building for? (e.g. web, Android, iOS)" and, if relevant, "Which stack or framework? (e.g. React, Vue, Next, Swift, Kotlin)." Do **not** assume web or any default.
-- Proceed only once platform (and optionally stack) is known or confirmed.
-
-## Phase 2 \u2013 Get suggested dependencies
-
-- Call MCP tool **getDependencies** with the resolved \`platform\` (and optional \`stack\`). Use the parameter names the tool expects (e.g. platform, stack).
-- If the call fails (e.g. MCP not connected or no ds-id), tell the user: "Atomix MCP is not connected or design system ID is missing. Configure MCP with --ds-id and try again."
-
-## Phase 3 \u2013 Scan codebase and build suggestion list
-
-- Scan the repo for: package.json (or equivalent), existing skill path (e.g. .cursor/skills), presence of tokens.css or project token file, font imports/config, icon package usage.
-- Build two lists: **Suggested dependencies** (from getDependencies, minus what is already present) and **Already present**. Include: icon package, fonts, SKILL path, MCP config, token files.
-- Do **not** install, copy, or write any file in this phase.
-
-## Phase 4 \u2013 Present list and ask before install
-
-- Reply with: "Suggested dependencies: \u2026" and "Already present: \u2026" and state: "Do not install or copy anything until you confirm. Would you like me to install or add these?"
-- If the user says yes, perform only the steps they approved. If no or only part, perform only that.
+    case "setup": {
+      const setupInstructions = `You are running **atomix/setup**. Three phases only. Do not create, write, or modify any file until Phase 3 and only after the user has approved.
 
-## Phase 5 \u2013 Optional: suggest global styles (if missing)
+## Phase 1 \u2013 Scan
 
-- After presenting the dependency list (Phase 4), or after the user has approved install, check whether the project has **global styles that use the design system tokens** (e.g. typography scale, semantic color classes, or theme file referencing DS tokens). If **not** (e.g. no globals.css using tokens, or blank project), ask the user **verbatim**:
+- Resolve platform/stack: infer from the project (e.g. package.json, build.gradle, Xcode) or ask the user once: "Which platform? (e.g. web, Android, iOS)" and if relevant "Which stack? (e.g. React, Vue, Next, Swift, Kotlin)." Do not assume a default.
+- Call MCP tool **getDependencies** with \`platform\` and optional \`stack\`. If it fails, tell the user: "Atomix MCP is not connected or design system ID is missing. Configure MCP with --ds-id and try again."
+- Scan the repo for what already exists: .cursor/skills/atomix-ds/SKILL.md, a tokens file (e.g. tokens.css or src/tokens.css), icon package from getDependencies, font setup. Do **not** include or check for MCP config; MCP is already configured for this session.
+- **Web:** Scan for any existing CSS (e.g. globals.css, main.css, App.css, index.css, Tailwind entry, framework styles). Note whether at least one CSS file exists.
+- **Native (iOS/Android):** Scan for existing theme or style files (e.g. SwiftUI theme/asset catalog, Android themes.xml/styles.xml, Compose theme). Note whether the project already has a theme or style setup.
+- Build two lists: **Suggested** (from getDependencies minus what exists) and **Already present**. Only include: icon package, fonts, skill (.cursor/skills/atomix-ds/SKILL.md), token files. No MCP.
+- Do not write, create, or add anything in Phase 1.
 
-"Your project doesn't appear to have global styles that use the design system tokens (e.g. semantic typography scale or semantic color classes). Would you like me to suggest or generate a minimal set (e.g. typography scale + semantic utilities) so you can develop consistently with the DS?"
+## Phase 2 \u2013 Report and ask for permission
 
-- If the user says yes, suggest or generate a minimal set; do not overwrite existing global styles without confirmation.
+- Reply with: **Suggested:** [list] and **Already present:** [list].
+- Ask exactly once: "Do you want me to add the suggested items? (Yes for all, or say which ones.)" (Integration with existing CSS or theme is recommended after Phase 3; new global CSS/theme is only suggested when none exists.)
+- **Stop.** Do not run Phase 3 in this response. Wait for the user to reply.
 
-## Phase 6 \u2013 Report what was created
+## Phase 3 \u2013 Create or add (only after user approval)
 
-- After any install or copy steps (and optional global-styles step), list **what was created or updated** (e.g. "Installed: lucide-react. Added: .cursor/skills/atomix-ds/SKILL.md. Updated: .cursor/mcp.json. Copied: tokens.css."). If global styles were added, include that.
+- Run only when the user has said yes (all or specific items).
+- For each approved item:
+  - **Skill:** Write the skill content from getDependencies to .cursor/skills/atomix-ds/SKILL.md.
+  - **Token file:** Call the **syncTokens** MCP tool with \`output\` set to the path (e.g. "./src/tokens.css" or "./tokens.css"). You must call syncTokens; do not only suggest the user run sync later.
+  - **Icon package / fonts:** Add per getDependencies (e.g. install package, add font config). Do not overwrite existing.
+- Report only what you actually created or updated (e.g. "Added: .cursor/skills/atomix-ds/SKILL.md. Synced: src/tokens.css."). Do not claim the token file was added if you did not call syncTokens.
+- **After reporting \u2013 styles/theme (per platform):**
+  - **Web:** If the project **already has** at least one CSS file: recommend how to integrate Atomix (e.g. import the synced tokens file, use \`var(--atomix-*)\` or semantic classes). Do **not** suggest creating a new global CSS. Only if the project has **no** CSS file at all, ask once: "There are no CSS files yet. Do you want a minimal global CSS (typography + semantic utilities from the design system)?" and add it only if the user says yes.
+  - **iOS/Android:** If the project **already has** theme or style files: recommend how to integrate Atomix tokens (e.g. use synced DesignTokens.swift / Kotlin tokens in existing theme). Do **not** suggest creating a new global theme file. Only if the project has **no** theme/style setup at all, ask once: "There's no theme/style setup yet. Do you want a minimal token-based theme (colors, typography, spacing from the design system)?" and add it only if the user says yes.
 
 ---
 
-Execute Phase 1 now (resolve or ask platform/stack), then Phase 2 (call getDependencies), then continue through Phase 6.`;
+Execute Phase 1 now (resolve platform/stack, call getDependencies, scan, build lists). Then Phase 2 (report lists and ask). Do not perform Phase 3 until the user replies.`;
       return {
-        description: "Suggest dependencies for this design system (atomix/install)",
+        description: "Setup design system in project (atomix/setup). Phase 1 scan, Phase 2 report and ask, Phase 3 create only after user approval.",
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: installInstructions
+              text: setupInstructions
             }
           }
         ]
@@ -2874,7 +2848,7 @@ ${tokenSummary}
 
 | Command | What to expect |
 |---------|----------------|
-| **install** | Scans your repo to set up global styles (if none), icons and fonts. Safe: Won't install until you confirm. |
+| **setup** | Scans your repo to set up global styles (if none), icons and fonts. Safe: Won't add anything until you confirm. |
 | **sync** | Syncs tokens to a local file. Adds new, updates existing, marks deprecated. Safe: No changes until you confirm. |
 | **refactor** | Scans codebase for deprecated tokens (after sync), suggests replacements. Run after sync to migrate code. |
 
@@ -2892,7 +2866,7 @@ ${tokenSummary}
 | **sizing** | Table of height and icon size tokens. |
 | **motion** | Table of duration and easing tokens. |
 
-**Suggested next step:** Run **install** to set up global styles, icons, fonts, and token files; the AI will list options and ask before adding anything.
+**Suggested next step:** Run **setup** to set up global styles, icons, fonts, and token files; the AI will list options and ask before adding anything.
 
 ---