@nbakka/mcp-appium 2.0.40 → 2.0.42

package/lib/server.js

@@ -474,6 +474,196 @@ const createMcpServer = () => {
       return [...new Set(figmaLinks)];
     }
 
+    tool(
+      "mobile_export_figma_images",
+      "Export all frames from Figma file as PNG images with sequential naming",
+      {
+        figmaUrl: zod_1.z.string().describe("The Figma file URL to export frames from")
+      },
+      async ({ figmaUrl }) => {
+        try {
+          // Read Figma credentials from desktop/figma.json file
+          const figmaConfigPath = path.join(os.homedir(), 'Desktop', 'figma.json');
+
+          let figmaConfig;
+          try {
+            const configContent = await fs.readFile(figmaConfigPath, 'utf-8');
+            figmaConfig = JSON.parse(configContent);
+          } catch (error) {
+            throw new Error(`Failed to read Figma config from ${figmaConfigPath}: ${error.message}`);
+          }
+
+          // Extract API token from config
+          const { token: figmaToken } = figmaConfig;
+
+          if (!figmaToken) {
+            throw new Error('Figma API token not found in figma.json file. Please ensure the file contains "token" field.');
+          }
+
+          // Extract file ID from Figma URL
+          const fileId = extractFileIdFromUrl(figmaUrl);
+          if (!fileId) {
+            throw new Error('Invalid Figma URL. Unable to extract file ID.');
+          }
+
+          // Set up export directory
+          const exportPath = path.join(os.homedir(), 'Desktop', 'figma');
+
+          // Create export directory if it doesn't exist
+          await fs.mkdir(exportPath, { recursive: true });
+
+          // Clear existing PNG files in the directory
+          try {
+            const existingFiles = await fs.readdir(exportPath);
+            const pngFiles = existingFiles.filter(file => file.endsWith('.png'));
+            for (const file of pngFiles) {
+              await fs.unlink(path.join(exportPath, file));
+            }
+          } catch (cleanupError) {
+            // Continue if cleanup fails
+          }
+
+          // Get file information
+          // Get file information
+          const fileResponse = await axios.get(
+            `https://api.figma.com/v1/files/${fileId}`,
+            {
+              headers: {
+                'X-Figma-Token': figmaToken
+              }
+            }
+          );
+
+          const fileData = fileResponse.data;
+
+          // Extract only frame node IDs
+          const frameIds = extractFrameNodes(fileData.document);
+
+          if (frameIds.length === 0) {
+            return `No frames found in Figma file.`;
+          }
+
+          // Limit to first 50 frames to avoid URI too long error
+          const limitedFrameIds = frameIds.slice(0, 50);
+
+          let successCount = 0;
+          const batchSize = 20; // Process in smaller batches to avoid 414 error
+
+          // Process frames in batches
+          for (let batchStart = 0; batchStart < limitedFrameIds.length; batchStart += batchSize) {
+            const batchEnd = Math.min(batchStart + batchSize, limitedFrameIds.length);
+            const batchIds = limitedFrameIds.slice(batchStart, batchEnd);
+
+            try {
+              // Request image exports for current batch
+              const exportResponse = await axios.get(
+                `https://api.figma.com/v1/images/${fileId}`,
+                {
+                  headers: {
+                    'X-Figma-Token': figmaToken
+                  },
+                  params: {
+                    ids: batchIds.join(','),
+                    format: 'png',
+                    scale: 2
+                  }
+                }
+              );
+
+              const imageUrls = exportResponse.data.images;
+
+              // Download and save each image in the batch
+              for (let i = 0; i < batchIds.length; i++) {
+                const nodeId = batchIds[i];
+                const imageUrl = imageUrls[nodeId];
+
+                if (imageUrl) {
+                  try {
+                    const frameNumber = batchStart + i + 1;
+                    const filename = `${frameNumber}.png`;
+                    const filepath = path.join(exportPath, filename);
+
+                    // Download image
+                    const imageResponse = await axios.get(imageUrl, {
+                      responseType: 'arraybuffer'
+                    });
+
+                    // Save image to file
+                    await fs.writeFile(filepath, imageResponse.data);
+                    successCount++;
+                  } catch (downloadError) {
+                    // Continue with next image if one fails
+                  }
+                }
+              }
+            } catch (batchError) {
+              // Continue with next batch if one fails
+            }
+          }
+
+          return `Figma Export Complete!
+    Export Path: ${exportPath}
+    Total frames in file: ${frameIds.length}
+    Exported first: ${successCount} frames as PNG files (limited to 50 max)
+    Files: ${Array.from({length: successCount}, (_, i) => `${i + 1}.png`).join(', ')}`;
+
+        } catch (error) {
+          if (error.response && error.response.status === 403) {
+            return `Error: Access denied. Please check your Figma API token and file permissions.`;
+          } else if (error.response && error.response.status === 404) {
+            return `Error: Figma file not found. Please check the URL and ensure the file is accessible.`;
+          } else {
+            return `Error exporting from Figma: ${error.message}`;
+          }
+        }
+      }
+    );
+
+    // Helper function to extract file ID from Figma URL
+    function extractFileIdFromUrl(url) {
+      const patterns = [
+        /figma\.com\/file\/([a-zA-Z0-9]+)/,
+        /figma\.com\/design\/([a-zA-Z0-9]+)/,
+        /figma\.com\/proto\/([a-zA-Z0-9]+)/
+      ];
+
+      for (const pattern of patterns) {
+        const match = url.match(pattern);
+        if (match) {
+          return match[1];
+        }
+      }
+      return null;
+    }
+
+    // Helper function to extract only frame node IDs
+    function extractFrameNodes(document) {
+      const frameIds = [];
+
+      function traverse(node) {
+        // Only collect frames, not components
+        if (node.type === 'FRAME') {
+          frameIds.push(node.id);
+        }
+
+        // Continue traversing children
+        if (node.children && Array.isArray(node.children)) {
+          node.children.forEach(traverse);
+        }
+      }
+
+      // Start traversal from document children (pages)
+      if (document.children && Array.isArray(document.children)) {
+        document.children.forEach(page => {
+          if (page.children && Array.isArray(page.children)) {
+            page.children.forEach(traverse);
+          }
+        });
+      }
+
+      return frameIds;
+    }
+
     return server;
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbakka/mcp-appium",
-  "version": "2.0.40",
+  "version": "2.0.42",
   "description": "Appium MCP",
   "engines": {
     "node": ">=18"