@nbakka/mcp-appium 2.0.52 → 2.0.53

package/lib/server.js

@@ -476,20 +476,33 @@ const createMcpServer = () => {
     }
 
 // ----------------------
-// Helper: Extract File ID
+// Helper: Extract File ID & Node ID
 // ----------------------
-function extractFileIdFromUrl(url) {
+function extractFileAndNodeId(url) {
   const patterns = [
     /figma\.com\/file\/([a-zA-Z0-9]+)/,
     /figma\.com\/design\/([a-zA-Z0-9]+)/,
     /figma\.com\/proto\/([a-zA-Z0-9]+)/
   ];
 
+  let fileId = null;
   for (const pattern of patterns) {
     const match = url.match(pattern);
-    if (match) return match[1];
+    if (match) {
+      fileId = match[1];
+      break;
+    }
+  }
+
+  // Extract node-id if present
+  const nodeMatch = url.match(/[?&]node-id=([^&]+)/);
+  let nodeId = null;
+  if (nodeMatch) {
+    // Replace dash with colon (Figma expects 13:5951 instead of 13-5951)
+    nodeId = decodeURIComponent(nodeMatch[1]).replace(/-/g, ":");
   }
-  return null;
+
+  return { fileId, nodeId };
 }
 
 // ----------------------
@@ -510,31 +523,38 @@ tool(
 
       if (!figmaToken) throw new Error("Figma API token missing in figma.json");
 
-      // Extract file ID from URL
-      const fileId = extractFileIdFromUrl(figmaUrl);
+      // Extract fileId and nodeId from URL
+      const { fileId, nodeId } = extractFileAndNodeId(figmaUrl);
       if (!fileId) throw new Error("Invalid Figma URL - cannot extract fileId");
 
-      // Get file structure to find frames
-      const fileResponse = await axios.get(
-        `https://api.figma.com/v1/files/${fileId}`,
-        { headers: { "X-Figma-Token": figmaToken } }
-      );
+      let idsToExport = [];
 
-      const frameIds = [];
-      fileResponse.data.document.children?.forEach(page => {
-        page.children?.forEach(child => {
-          if (child.type === "FRAME") frameIds.push(child.id);
+      if (nodeId) {
+        // Use node-id directly from URL
+        idsToExport = [nodeId];
+      } else {
+        // Fallback: scan file to collect all top-level frames
+        const fileResponse = await axios.get(
+          `https://api.figma.com/v1/files/${fileId}`,
+          { headers: { "X-Figma-Token": figmaToken } }
+        );
+
+        fileResponse.data.document.children?.forEach(page => {
+          page.children?.forEach(child => {
+            if (child.type === "FRAME") idsToExport.push(child.id);
+          });
         });
-      });
 
-      if (frameIds.length === 0) throw new Error("No frames found in Figma file");
+        if (idsToExport.length === 0)
+          throw new Error("No frames found in Figma file");
+      }
 
       // Request PDF export
       const exportResponse = await axios.get(
         `https://api.figma.com/v1/images/${fileId}`,
         {
           headers: { "X-Figma-Token": figmaToken },
-          params: { ids: frameIds.join(","), format: "pdf" }
+          params: { ids: idsToExport.join(","), format: "pdf" }
         }
       );
 
@@ -558,6 +578,7 @@ tool(
   }
 );
 
+
 // ----------------------
 // TOOL 2: Upload PDF to OpenAI with Jira Info
 // ----------------------

package/package.json

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