@nbakka/mcp-appium 2.0.69 → 2.0.70

package/lib/server.js

@@ -509,13 +509,13 @@ function extractFileAndNodeId(url) {
 }
 
 // ----------------------
-// TOOL 1: Export Figma to PDF
+// TOOL 1: Export Figma to PNG
 // ----------------------
 tool(
-  "mobile_export_figma_pdf",
-  "Export Figma file as PDF",
+  "mobile_export_figma_png",
+  "Export Figma file as PNG",
   {
-    figmaUrl: zod_1.z.string().describe("The Figma file URL to export as PDF")
+    figmaUrl: zod_1.z.string().describe("The Figma file URL to export as PNG")
   },
   async ({ figmaUrl }) => {
     try {
@@ -552,24 +552,22 @@ tool(
           throw new Error("No frames found in Figma file");
       }
 
-      // Request PDF export
+      // Request PNG export with higher scale for better quality
       const exportResponse = await axios.get(
         `https://api.figma.com/v1/images/${fileId}`,
         {
           headers: { "X-Figma-Token": figmaToken },
-          params: { ids: idsToExport.join(","), format: "pdf" }
+          params: {
+            ids: idsToExport.join(","),
+            format: "png",
+            scale: "2" // 2x scale for better quality
+          }
         }
       );
 
-      const pdfUrl = Object.values(exportResponse.data.images)[0];
-      if (!pdfUrl) throw new Error("No PDF export URL returned from Figma");
-
-      // Download PDF
-      const pdfResponse = await axios.get(pdfUrl, { responseType: "arraybuffer" });
-
       const exportPath = path.join(os.homedir(), "Desktop", "figma");
 
-      // Clear the folder before creating new PDF
+      // Clear the folder before creating new PNGs
       try {
         // Check if folder exists
         await fs.access(exportPath);
@@ -588,19 +586,35 @@ tool(
       await fs.mkdir(exportPath, { recursive: true });
 
       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 `✅ PDF Export Complete: ${pdfPath}`;
+      // Download all PNG images
+      const downloadPromises = Object.entries(exportResponse.data.images).map(
+        async ([nodeId, pngUrl], index) => {
+          if (!pngUrl) throw new Error(`No PNG export URL returned for node ${nodeId}`);
+
+          const pngResponse = await axios.get(pngUrl, { responseType: "arraybuffer" });
+          const filename = idsToExport.length > 1
+            ? `figma-export-${timestamp}-${index + 1}.png`
+            : `figma-export-${timestamp}.png`;
+          const pngPath = path.join(exportPath, filename);
+
+          await fs.writeFile(pngPath, pngResponse.data);
+          return pngPath;
+        }
+      );
+
+      const savedPaths = await Promise.all(downloadPromises);
+
+      return `✅ PNG Export Complete: ${savedPaths.length} file(s) saved to ${exportPath}`;
     } catch (err) {
-      return `❌ Error exporting Figma PDF: ${err.message}`;
+      return `❌ Error exporting Figma PNG: ${err.message}`;
     }
   }
 );
 
 tool(
-  "upload_pdf_to_openai",
-  "Generate manual test cases by analyzing PDF design with JIRA requirements",
+  "generate_testcases_from_ticket_data",
+  "Generate manual test cases by analyzing PNG design with JIRA requirements",
   {
     jiraSummary: zod_1.z.string().describe("Jira issue summary"),
     jiraDescription: zod_1.z.string().describe("Jira issue description")
@@ -612,41 +626,66 @@ tool(
       const configContent = await fs.readFile(openaiConfigPath, "utf-8");
       const { apiKey } = JSON.parse(configContent);
 
+      // Load test case generation guidelines
+      const guidelinesPath = path.join(__dirname, 'testcases-generation-context.txt');
+      const guidelines = await fs.readFile(guidelinesPath, "utf-8");
+
       const figmaDir = path.join(os.homedir(), "Desktop", "figma");
       const files = await fs.readdir(figmaDir);
-      const pdfFiles = files.filter(file => file.toLowerCase().endsWith('.pdf'));
+      const pngFiles = files.filter(file => file.toLowerCase().endsWith('.png'));
 
-      if (pdfFiles.length === 0) throw new Error("No PDF files found in figma folder");
+      if (pngFiles.length === 0) throw new Error("No PNG files found in figma folder");
 
-      const latestPdf = pdfFiles.sort((a, b) => b.localeCompare(a))[0];
-      const pdfPath = path.join(figmaDir, latestPdf);
+      // Get the latest PNG file
+      const latestPng = pngFiles.sort((a, b) => b.localeCompare(a))[0];
+      const pngPath = path.join(figmaDir, latestPng);
 
       const client = new OpenAI({ apiKey });
 
-      const file = await client.files.create({
-        file: fsSync.createReadStream(pdfPath),
-        purpose: "user_data",
-      });
+      // Convert PNG to base64 for vision API
+      const pngBuffer = await fs.readFile(pngPath);
+      const base64Image = pngBuffer.toString('base64');
 
       const completion = await client.chat.completions.create({
-        model: "gpt-5",
+        model: "gpt-5", // Use vision model for image analysis
         messages: [{
           role: "user",
-          content: [{
-            type: "file",
-            file: { file_id: file.id }
-          }, {
-            type: "text",
-            text: `For the attached pdf, OCR the page return a JSON with text, bounding boxes. Line-level boxes, Normalized [0–1] coordinates, origin top-left, Include readingOrder and no confidence, Keep all occurrences as they appear NOTE: Dont ask anymore questions, just give me output. I wont be able to answer`
-          }]
-        }]
+          content: [
+            {
+              type: "text",
+              text: `Generate comprehensive manual test cases based on the following:
+
+JIRA Summary: ${jiraSummary}
+
+JIRA Description: ${jiraDescription}
+
+Test Case Generation Guidelines:
+${guidelines}
+
+Please analyze the provided Figma design (PNG image) and create detailed manual test cases that cover all the functionality described in the JIRA requirements. Focus on UI/UX changes, user interactions, navigation flows, and edge cases.`
+            },
+            {
+              type: "image_url",
+              image_url: {
+                url: `data:image/png;base64,${base64Image}`,
+                detail: "high"
+              }
+            }
+          ]
+        }],
+        max_tokens: 10000
       });
 
       const testCases = completion.choices[0].message.content;
 
-      return testCases;
+      // Save the generated test cases to a file for reference
+      const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, -5);
+      const testCasesPath = path.join(figmaDir, `test-cases-${timestamp}.txt`);
+      await fs.writeFile(testCasesPath, testCases);
+
+      return `✅ Test cases generated successfully!\n\nSaved to: ${testCasesPath}\n\n${testCases}`;
     } catch (err) {
-      return `Error: ${err.message}`;
+      return `❌ Error generating test cases: ${err.message}`;
     }
   }
 );

package/lib/testcases-generation-context.txt

@@ -0,0 +1,11 @@
+generate test cases using jira summary, description and figma image,
+don't take any extra user input,
+final output should be test in following format
+"Verify pay on credit banner exits on PDP", "Existing"
+"Verify overview tab on PDP", "New"
+"Verify financial services are displayed under financial tab", "Remove"
+"Verify xyz is moved to sja ", "Modify"
+here existing means the test case is already present in the repo
+new means the test case is not present in the repo and needs to be added
+remove means the test case is present in the repo but is not required and needs to be removed
+modify means the test case is present in the repo but needs some modification

package/package.json

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