@createlex/figma-swiftui-mcp 1.1.0 → 1.2.2

package/companion/bridge-server.cjs

@@ -230,6 +230,55 @@ function startBridgeServer(options = {}) {
     });
   });
 
+  // GET /design-context — returns current selection's design context as JSON.
+  // Lets any AI tool (Windsurf, a script, a browser) fetch the live Figma context
+  // via a simple HTTP GET without needing MCP protocol or copy-paste.
+  // Usage: GET http://localhost:7765/design-context?maxDepth=4
+  app.get('/design-context', async (req, res) => {
+    if (!pluginBridgeClient || pluginBridgeClient.readyState !== WebSocket.OPEN) {
+      return res.status(503).json({
+        ok: false,
+        error: 'No Figma plugin is connected to the bridge. Open the plugin in Figma first.',
+        hint: 'npx @createlex/figma-swiftui-mcp start --project ./MyApp',
+      });
+    }
+
+    const maxDepth = Math.min(parseInt(req.query.maxDepth, 10) || 4, 8);
+    const requestId = `http-ctx-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+
+    const response = await new Promise((resolve) => {
+      const timeout = setTimeout(() => {
+        pendingBridgeRequests.delete(requestId);
+        resolve({ ok: false, error: 'Timed out waiting for design context from plugin' });
+      }, 20000);
+
+      pendingBridgeRequests.set(requestId, {
+        origin: null,
+        action: 'get_design_context',
+        resolveCallback: (msg) => {
+          clearTimeout(timeout);
+          resolve(msg);
+        },
+      });
+
+      sendBridgeMessage(pluginBridgeClient, {
+        type: 'bridge-request',
+        requestId,
+        action: 'get_design_context',
+        params: { maxDepth, includeScreenshot: false },
+        protocolVersion: BRIDGE_PROTOCOL_VERSION,
+        timestamp: new Date().toISOString(),
+      });
+      broadcastBridgeStatus();
+    });
+
+    if (!response.ok) {
+      return res.status(502).json({ ok: false, error: response.error || 'Plugin returned an error' });
+    }
+
+    res.json({ ok: true, ...(response.data || {}) });
+  });
+
   function sendBridgeMessage(ws, payload) {
     if (!ws || ws.readyState !== WebSocket.OPEN) {
       return false;
@@ -497,11 +546,15 @@ function startBridgeServer(options = {}) {
         }
 
         pendingBridgeRequests.delete(message.requestId);
-        sendBridgeMessage(pending.origin, {
-          ...message,
-          protocolVersion: BRIDGE_PROTOCOL_VERSION,
-          timestamp: new Date().toISOString(),
-        });
+        if (typeof pending.resolveCallback === 'function') {
+          pending.resolveCallback(message);
+        } else {
+          sendBridgeMessage(pending.origin, {
+            ...message,
+            protocolVersion: BRIDGE_PROTOCOL_VERSION,
+            timestamp: new Date().toISOString(),
+          });
+        }
         broadcastBridgeStatus();
         return;
       }

package/companion/mcp-server.mjs

@@ -706,7 +706,7 @@ server.registerTool('analyze_generation', {
 });
 
 server.registerTool('write_generated_swiftui_to_xcode', {
-  description: 'Write generated SwiftUI code and optional exported images directly into the configured Xcode project. Supports writing multiple files: use additionalFiles for DesignTokens.swift (dir: "shared"), reusable components (dir: "components"), or extra screen files (dir: "screens"). AI tools generating code with their own model should call this after generating SwiftUI from get_design_context or get_swiftui_generation_prompt.',
+  description: 'Write generated SwiftUI code into the configured Xcode project. Images are automatically exported from the current Figma selection and written to Assets.xcassets — you do not need to provide them manually. Supports multiple files: use additionalFiles for DesignTokens.swift (dir: "shared"), reusable components (dir: "components"), or extra screen files (dir: "screens"). AI tools generating code with their own model should call this after generating SwiftUI from get_design_context or the /design-context URL.',
   inputSchema: {
     code: z.string().describe('SwiftUI source code for the primary view'),
     structName: z.string().optional().describe('Optional Swift struct name; if omitted it will be inferred from the code'),
@@ -725,11 +725,31 @@ server.registerTool('write_generated_swiftui_to_xcode', {
 }, async ({ code, structName, projectPath, images, selectionNames, additionalFiles }) => {
   const targetDir = resolveTargetProjectPath(projectPath);
   const effectiveStructName = inferStructName({ structName, code, selectionNames });
+
+  // Auto-fetch images from the current Figma selection when none were provided.
+  // This ensures Assets.xcassets is always populated even when the AI supplied
+  // its own SwiftUI code (e.g. from get_design_context / the /design-context URL).
+  let effectiveImages = Array.isArray(images) && images.length > 0 ? images : [];
+  if (effectiveImages.length === 0) {
+    try {
+      const generated = await callBridge('generate_swiftui', {
+        includeImages: true,
+        generationMode: 'editable',
+        includeOverflow: false,
+      });
+      if (Array.isArray(generated.images) && generated.images.length > 0) {
+        effectiveImages = generated.images;
+      }
+    } catch {
+      // Non-fatal: bridge may not be connected or selection may have no images.
+    }
+  }
+
   const result = writeSwiftUIScreen({
     targetDir,
     code,
     structName: effectiveStructName,
-    images,
+    images: effectiveImages,
     additionalFiles,
   });
 
@@ -740,6 +760,7 @@ server.registerTool('write_generated_swiftui_to_xcode', {
   return jsonResult({
     ...stripImageData(result),
     structName: effectiveStructName,
+    imagesWritten: effectiveImages.length,
   });
 });
 
@@ -940,8 +961,16 @@ function buildRefinementInstructions({ diagnostics, rasterNodes, analysisHints,
 
   // Raster replacements
   if (rasterNodes.length > 0) {
+    const rasterNames = rasterNodes
+      .map((d) => d.assetName || d.nodeName || d.name)
+      .filter(Boolean)
+      .slice(0, 8)
+      .join(', ');
     instructions.push(
-      `${rasterNodes.length} element(s) were exported as raster images because Figma could not map them to native SwiftUI. Review these and replace obvious UI controls (buttons, text fields, toggles, tab bars) with native SwiftUI equivalents. Keep actual images/illustrations as Image assets.`
+      `IMPORTANT: ${rasterNodes.length} element(s) were rasterized and written to Assets.xcassets as PNG files${rasterNames ? ` (${rasterNames})` : ''}. ` +
+      `The generated code already references them with Image("name") calls — DO NOT remove or replace these Image() calls. ` +
+      `Only replace Image() calls if the asset name clearly identifies a native UI control (button, toggle, tab bar, text field). ` +
+      `Photos, illustrations, 3D renders, icons, and decorative graphics MUST stay as Image("name") — do not attempt to reconstruct them with SwiftUI shapes or colors.`
     );
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@createlex/figma-swiftui-mcp",
-  "version": "1.1.0",
+  "version": "1.2.2",
   "description": "CreateLex MCP runtime for Figma-to-SwiftUI generation and Xcode export",
   "bin": {
     "figma-swiftui-mcp": "bin/figma-swiftui-mcp.js"
@@ -41,8 +41,7 @@
     "zod": "^4.3.6"
   },
   "optionalDependencies": {
-    "@anthropic-ai/sdk": "^0.52.0",
-    "openai": "^4.100.0"
+    "@anthropic-ai/sdk": "^0.52.0"
   },
   "devDependencies": {
     "@figma/plugin-typings": "*",