@createlex/figma-swiftui-mcp 1.0.4 → 1.0.6

package/bin/figma-swiftui-mcp.js

@@ -13,16 +13,19 @@ function printHelp() {
 Usage:
   npx ${PACKAGE_NAME} login
   npx ${PACKAGE_NAME} start [--project /path/to/Xcode/source]
+  npx ${PACKAGE_NAME} setup [--force] [--dry-run]
 
 Commands:
   login   Open the CreateLex browser login flow and save ~/.createlex/auth.json
   start   Start the local figma-swiftui MCP runtime and localhost bridge
+  setup   Auto-configure MCP in Cursor, Claude, VS Code, Windsurf, and more
   help    Show this help message
   version Show the package version
 
 Examples:
   npx ${PACKAGE_NAME} login
   npx ${PACKAGE_NAME} start --project /Users/you/MyApp/MyApp
+  npx ${PACKAGE_NAME} setup
   npm install -g ${PACKAGE_NAME}
   ${CLI_NAME} start --project /Users/you/MyApp/MyApp
 `);
@@ -56,6 +59,24 @@ Description:
     return;
   }
 
+  if (command === 'setup') {
+    console.log(`${CLI_NAME} setup
+
+Usage:
+  npx ${PACKAGE_NAME} setup [--force] [--dry-run]
+
+Options:
+  --force     Overwrite existing figma-swiftui config entries
+  --dry-run   Show what would be configured without writing
+
+Description:
+  Detects installed IDEs (Cursor, Claude Desktop, Claude Code, VS Code,
+  Windsurf, Antigravity) and adds the figma-swiftui MCP server entry
+  to each config file automatically.
+`);
+    return;
+  }
+
   printHelp();
 }
 
@@ -104,6 +125,20 @@ switch (command) {
     }
     runNode(resolveEntry('start'), args);
     break;
+  case 'setup':
+    if (wantsHelp) {
+      printCommandHelp('setup');
+      break;
+    }
+    {
+      const { runSetup } = require(path.join(__dirname, '..', 'companion', 'setup.cjs'));
+      const flags = {
+        force: args.includes('--force'),
+        dryRun: args.includes('--dry-run'),
+      };
+      runSetup(flags);
+    }
+    break;
   case 'help':
   case '--help':
   case '-h':

package/companion/setup.cjs

@@ -0,0 +1,225 @@
+/**
+ * figma-swiftui-mcp setup
+ *
+ * Auto-detect installed IDEs / CLI tools and add the figma-swiftui MCP
+ * server entry to each config file.
+ *
+ * Supported targets:
+ *   - Claude Desktop  (~/Library/Application Support/Claude/claude_desktop_config.json)
+ *   - Claude Code     (~/.claude.json  → mcpServers)
+ *   - Cursor          (~/.cursor/mcp.json)
+ *   - Windsurf        (~/.codeium/windsurf/mcp_config.json)
+ *   - VS Code         (~/.vscode/mcp.json  — user-level)
+ *   - Antigravity     (~/.gemini/antigravity/mcp_config.json)
+ */
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+
+const MCP_KEY = 'figma-swiftui';
+
+// ── Resolve the absolute path to the bin script and node ─────────────
+// IDEs (Cursor, VS Code, etc.) do NOT source shell profiles, so
+// `#!/usr/bin/env node` fails when node is managed by nvm/fnm/volta.
+// Instead we record the absolute node path and the bin script separately.
+function resolvePaths() {
+  const nodePath = process.execPath; // absolute path to node binary
+
+  // Try to find the bin JS file
+  const binScript = process.argv[1];
+  if (binScript) {
+    const resolved = fs.realpathSync(binScript);
+    const dir = path.dirname(resolved);
+    // Check for the .js bin entry point
+    const jsCandidate = path.join(dir, 'figma-swiftui-mcp.js');
+    if (fs.existsSync(jsCandidate)) {
+      return { nodePath, scriptPath: jsCandidate };
+    }
+    // Check for the wrapper (symlink without .js)
+    const candidate = path.join(dir, 'figma-swiftui-mcp');
+    if (fs.existsSync(candidate)) {
+      // Resolve symlinks to get the actual .js file
+      const real = fs.realpathSync(candidate);
+      return { nodePath, scriptPath: real };
+    }
+  }
+
+  // Fallback: search PATH for the binary, then resolve to its .js source
+  const whichCmd = require('node:child_process')
+    .execSync('which figma-swiftui-mcp 2>/dev/null || true')
+    .toString()
+    .trim();
+  if (whichCmd) {
+    const real = fs.realpathSync(whichCmd);
+    return { nodePath, scriptPath: real };
+  }
+
+  // Last resort: use npx invocation
+  return { nodePath, scriptPath: null };
+}
+
+// ── Resolve absolute npx path for fallback ───────────────────────────
+function resolveNpxPath() {
+  try {
+    const npxPath = require('node:child_process')
+      .execSync('which npx 2>/dev/null || true')
+      .toString()
+      .trim();
+    return npxPath || 'npx';
+  } catch {
+    return 'npx';
+  }
+}
+
+// ── IDE config definitions ────────────────────────────────────────────
+function getTargets({ nodePath, scriptPath }) {
+  const home = os.homedir();
+
+  // Use absolute node path + script to avoid #!/usr/bin/env node failures
+  // in IDEs that don't source shell profiles (nvm/fnm/volta).
+  const stdioEntry = scriptPath
+    ? { command: nodePath, args: [scriptPath, 'start'] }
+    : { command: resolveNpxPath(), args: ['-y', '@createlex/figma-swiftui-mcp', 'start'] };
+
+  const stdioEntryWithType = { type: 'stdio', ...stdioEntry };
+
+  return [
+    {
+      name: 'Claude Desktop',
+      path: path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+      key: 'mcpServers',
+      entry: stdioEntry,
+    },
+    {
+      name: 'Claude Code',
+      path: path.join(home, '.claude.json'),
+      key: 'mcpServers',
+      entry: stdioEntryWithType,
+    },
+    {
+      name: 'Cursor',
+      path: path.join(home, '.cursor', 'mcp.json'),
+      key: 'mcpServers',
+      entry: stdioEntry,
+    },
+    {
+      name: 'Windsurf',
+      path: path.join(home, '.codeium', 'windsurf', 'mcp_config.json'),
+      key: 'mcpServers',
+      entry: stdioEntry,
+    },
+    {
+      name: 'VS Code (user)',
+      path: path.join(home, '.vscode', 'mcp.json'),
+      key: 'servers',
+      entry: stdioEntry,
+      wrapKey: null, // VS Code uses { servers: { ... } } at top level
+    },
+    {
+      name: 'Antigravity (Gemini)',
+      path: path.join(home, '.gemini', 'antigravity', 'mcp_config.json'),
+      key: 'mcpServers',
+      entry: { ...stdioEntry, env: {}, disabled: false },
+    },
+  ];
+}
+
+// ── Read / write helpers ──────────────────────────────────────────────
+function readJsonSafe(filePath) {
+  try {
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+function writeJsonSafe(filePath, data) {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+
+// ── Main ──────────────────────────────────────────────────────────────
+function runSetup(flags = {}) {
+  const force = flags.force || false;
+  const dryRun = flags.dryRun || false;
+
+  const paths = resolvePaths();
+
+  console.log();
+  console.log('  🔧  figma-swiftui-mcp setup');
+  console.log('  ─────────────────────────────────────');
+  console.log(`  Node:   ${paths.nodePath}`);
+  if (paths.scriptPath) {
+    console.log(`  Script: ${paths.scriptPath}`);
+  } else {
+    console.log('  Script: not found — will use npx fallback');
+  }
+  console.log();
+
+  const targets = getTargets(paths);
+  let configured = 0;
+  let skipped = 0;
+  let notInstalled = 0;
+
+  for (const target of targets) {
+    const exists = fs.existsSync(target.path);
+
+    if (!exists) {
+      console.log(`  ⚪  ${target.name}  — not installed (${path.basename(target.path)} not found)`);
+      notInstalled++;
+      continue;
+    }
+
+    const config = readJsonSafe(target.path);
+    if (!config) {
+      console.log(`  ⚠️  ${target.name}  — could not parse config`);
+      skipped++;
+      continue;
+    }
+
+    // Ensure the server container key exists
+    if (!config[target.key]) {
+      config[target.key] = {};
+    }
+
+    const servers = config[target.key];
+
+    // Check if already configured
+    if (servers[MCP_KEY] && !force) {
+      console.log(`  ✅  ${target.name}  — already configured`);
+      skipped++;
+      continue;
+    }
+
+    // Add the entry
+    servers[MCP_KEY] = target.entry;
+
+    if (dryRun) {
+      console.log(`  🟡  ${target.name}  — would configure (dry run)`);
+    } else {
+      writeJsonSafe(target.path, config);
+      console.log(`  ✅  ${target.name}  — configured!`);
+    }
+    configured++;
+  }
+
+  console.log();
+  console.log(`  ─────────────────────────────────────`);
+  console.log(`  ${configured} configured · ${skipped} skipped · ${notInstalled} not installed`);
+
+  if (configured > 0 && !dryRun) {
+    console.log();
+    console.log('  💡 Restart your IDE(s) for the new MCP config to take effect.');
+  }
+
+  console.log();
+}
+
+module.exports = { runSetup };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@createlex/figma-swiftui-mcp",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "CreateLex MCP runtime for Figma-to-SwiftUI generation and Xcode export",
   "bin": {
     "figma-swiftui-mcp": "bin/figma-swiftui-mcp.js"
@@ -13,6 +13,7 @@
     "companion/mcp-server.mjs",
     "companion/package.json",
     "companion/server.js",
+    "companion/setup.cjs",
     "companion/xcode-writer.cjs",
     "README.md"
   ],