@nbakka/mcp-appium 2.0.45 → 2.0.47

package/lib/server.js

@@ -476,12 +476,11 @@ const createMcpServer = () => {
 
 tool(
   "mobile_export_figma_images",
-  "Export only main parent frames from Figma file as PNG images",
+  "Export Figma file as PDF",
   {
-    figmaUrl: zod_1.z.string().describe("The Figma file URL to export frames from"),
-    nodeId: zod_1.z.string().optional().describe("Specific node ID from URL (e.g., 13223-1724)")
+    figmaUrl: zod_1.z.string().describe("The Figma file URL to export as PDF")
   },
-  async ({ figmaUrl, nodeId }) => {
+  async ({ figmaUrl }) => {
     try {
       // Read Figma credentials from desktop/figma.json file
       const figmaConfigPath = path.join(os.homedir(), 'Desktop', 'figma.json');
@@ -501,36 +500,30 @@ tool(
         throw new Error('Figma API token not found in figma.json file. Please ensure the file contains "token" field.');
       }
 
-      // Extract file ID and node ID from Figma URL
+      // Extract file ID from Figma URL
       const fileId = extractFileIdFromUrl(figmaUrl);
       if (!fileId) {
         throw new Error('Invalid Figma URL. Unable to extract file ID.');
       }
 
-      // Extract node ID from URL if not provided separately
-      let targetNodeId = nodeId;
-      if (!targetNodeId) {
-        targetNodeId = extractNodeIdFromUrl(figmaUrl);
-      }
-
       // 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
+      // Clear existing PDF files in the directory
       try {
         const existingFiles = await fs.readdir(exportPath);
-        const pngFiles = existingFiles.filter(file => file.endsWith('.png'));
-        for (const file of pngFiles) {
+        const pdfFiles = existingFiles.filter(file => file.endsWith('.pdf'));
+        for (const file of pdfFiles) {
           await fs.unlink(path.join(exportPath, file));
         }
       } catch (cleanupError) {
         // Continue if cleanup fails
       }
 
-      // Get file information
+      // First, get the file structure to find all top-level frames
       const fileResponse = await axios.get(
         `https://api.figma.com/v1/files/${fileId}`,
         {
@@ -542,97 +535,98 @@ tool(
 
       const fileData = fileResponse.data;
 
-      let framesToExport = [];
-
-      if (targetNodeId) {
-        // If specific node ID provided, find that node and export it
-        const specificNode = findNodeById(fileData.document, targetNodeId);
-        if (specificNode && specificNode.type === 'FRAME') {
-          framesToExport = [specificNode.id];
-        } else {
-          return `Node ID ${targetNodeId} not found or is not a frame.`;
-        }
-      } else {
-        // Get only top-level frames (direct children of pages)
-        framesToExport = extractMainFrames(fileData.document);
+      // Extract all top-level frame IDs
+      const frameIds = [];
+      if (fileData.document.children && Array.isArray(fileData.document.children)) {
+        fileData.document.children.forEach(page => {
+          if (page.children && Array.isArray(page.children)) {
+            page.children.forEach(child => {
+              if (child.type === 'FRAME') {
+                frameIds.push(child.id);
+              }
+            });
+          }
+        });
       }
 
-      if (framesToExport.length === 0) {
-        return `No main frames found in Figma file.`;
+      if (frameIds.length === 0) {
+        throw new Error('No frames found in the Figma file');
       }
 
-      // Limit to reasonable number to avoid API issues
-      const limitedFrameIds = framesToExport.slice(0, 10);
+      console.log(`Found ${frameIds.length} top-level frames:`, frameIds.slice(0, 5));
 
-      let successCount = 0;
-      const batchSize = 5; // Smaller batches for main frames
+      // Request PDF export with specific frame IDs
+      const exportResponse = await axios.get(
+        `https://api.figma.com/v1/images/${fileId}`,
+        {
+          headers: {
+            'X-Figma-Token': figmaToken
+          },
+          params: {
+            ids: frameIds.join(','),
+            format: 'pdf',
+            use_absolute_bounds: false
+          }
+        }
+      );
 
-      // 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);
+      console.log('Export response:', exportResponse.data);
 
-        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
-              }
-            }
-          );
+      // For PDF export, the response structure might be different
+      let pdfUrl = null;
+      if (exportResponse.data.images) {
+        // Try to get PDF URL - might be under file ID or first frame ID
+        pdfUrl = exportResponse.data.images[fileId] ||
+                 exportResponse.data.images[frameIds[0]] ||
+                 Object.values(exportResponse.data.images)[0];
+      }
 
-          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
-        }
+      if (!pdfUrl) {
+        throw new Error('Failed to get PDF export URL from Figma');
       }
 
-      return `Figma Export Complete!
-Export Path: ${exportPath}
-Total main frames found: ${framesToExport.length}
-Exported: ${successCount} main frames as PNG files
-Files: ${Array.from({length: successCount}, (_, i) => `${i + 1}.png`).join(', ')}`;
+      // Download PDF
+      const pdfResponse = await axios.get(pdfUrl, {
+        responseType: 'arraybuffer'
+      });
+
+      // Save PDF to file with timestamp
+      const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5);
+      const pdfPath = path.join(exportPath, `figma-export-${timestamp}.pdf`);
+      await fs.writeFile(pdfPath, pdfResponse.data);
+
+      return `Figma PDF Export Complete!
+Export Path: ${pdfPath}
+File: figma-export-${timestamp}.pdf`;
 
     } 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}`;
+      // Enhanced error logging
+      let errorMessage = error.message;
+
+      if (error.response) {
+        const status = error.response.status;
+        const responseData = error.response.data;
+
+        console.error('Figma API Error:', {
+          status,
+          statusText: error.response.statusText,
+          data: responseData,
+          url: error.config?.url,
+          params: error.config?.params
+        });
+
+        if (status === 400) {
+          errorMessage = `Bad Request (400): ${responseData?.message || responseData?.err || 'Invalid request parameters'}. This might be due to PDF export limitations or invalid frame IDs.`;
+        } else if (status === 403) {
+          return `Error: Access denied. Please check your Figma API token and file permissions.`;
+        } else if (status === 404) {
+          return `Error: Figma file not found. Please check the URL and ensure the file is accessible.`;
+        } else {
+          errorMessage = `HTTP ${status}: ${responseData?.message || responseData?.err || error.response.statusText}`;
+        }
       }
+
+      return `Error exporting from Figma: ${errorMessage}`;
     }
   }
 );
@@ -653,64 +647,6 @@ function extractFileIdFromUrl(url) {
   }
   return null;
 }
-
-// Helper function to extract node ID from Figma URL
-function extractNodeIdFromUrl(url) {
-  const match = url.match(/node-id=([^&]+)/);
-  if (match) {
-    return match[1];
-  }
-  return null;
-}
-
-// Helper function to find a specific node by ID
-function findNodeById(document, nodeId) {
-  let foundNode = null;
-
-  function traverse(node) {
-    if (node.id === nodeId) {
-      foundNode = node;
-      return;
-    }
-
-    if (node.children && Array.isArray(node.children)) {
-      node.children.forEach(traverse);
-    }
-  }
-
-  if (document.children && Array.isArray(document.children)) {
-    document.children.forEach(page => {
-      if (page.children && Array.isArray(page.children)) {
-        page.children.forEach(traverse);
-      }
-    });
-  }
-
-  return foundNode;
-}
-
-// Simple function to extract only top-level frames (direct children of pages)
-function extractMainFrames(document) {
-  const topLevelFrames = [];
-
-  // Only get direct children of pages - no traversing deeper
-  if (document.children && Array.isArray(document.children)) {
-    document.children.forEach(page => {
-      if (page.children && Array.isArray(page.children)) {
-        // Only look at direct children of the page
-        page.children.forEach(child => {
-          if (child.type === 'FRAME') {
-            topLevelFrames.push(child.id);
-          }
-        });
-      }
-    });
-  }
-
-  return topLevelFrames;
-}
-
-
     return server;
 };
 

package/package.json

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