@nbakka/mcp-appium 2.0.68 → 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,45 +626,73 @@ 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}`;
     }
   }
 );
 
+// Global state for tracking approval sessions
+let approvalSessions = new Map();
+
 tool(
     "review_testcases",
     "Open JSON test cases in browser for manual approval",
@@ -664,193 +706,264 @@ tool(
     async ({ testCases }) => {
         try {
             const express = require('express');
+            const sessionId = Date.now().toString();
+
+            // Initialize session state
+            approvalSessions.set(sessionId, {
+                status: 'pending',
+                testCases: testCases,
+                server: null,
+                startTime: Date.now()
+            });
 
-            return new Promise(async (resolve, reject) => {
-                const app = express();
-                const port = 3001;
-                let server;
-                let userApproved = false;
-
-                // Serve a simple HTML page with test cases
-                app.get("/", (req, res) => {
-                    let html = `
-                        <html>
-                        <head>
-                            <title>Test Case Approval</title>
-                            <style>
-                                body {
-                                    font-family: Arial, sans-serif;
-                                    margin: 20px;
-                                    background-color: #f5f5f5;
-                                }
-                                .container {
-                                    max-width: 1200px;
-                                    margin: 0 auto;
-                                    background: white;
-                                    padding: 20px;
-                                    border-radius: 8px;
-                                    box-shadow: 0 2px 10px rgba(0,0,0,0.1);
-                                }
-                                h1 {
-                                    color: #333;
-                                    text-align: center;
-                                    border-bottom: 2px solid #007cba;
-                                    padding-bottom: 10px;
-                                }
-                                .test-case {
-                                    margin: 15px 0;
-                                    padding: 15px;
-                                    border: 1px solid #ddd;
-                                    border-radius: 8px;
-                                    background: #fafafa;
-                                }
-                                .test-id {
-                                    font-weight: bold;
-                                    color: #007cba;
-                                    font-size: 16px;
-                                }
-                                .test-title {
-                                    font-weight: bold;
-                                    margin: 5px 0;
-                                    color: #333;
-                                }
-                                .test-description {
-                                    color: #666;
-                                    line-height: 1.4;
-                                }
-                                .button-container {
-                                    text-align: center;
-                                    margin-top: 30px;
-                                    padding-top: 20px;
-                                    border-top: 1px solid #ddd;
-                                }
-                                button {
-                                    padding: 15px 30px;
-                                    background: #28a745;
-                                    color: white;
-                                    border: none;
-                                    border-radius: 5px;
-                                    cursor: pointer;
-                                    font-size: 16px;
-                                    font-weight: bold;
-                                }
-                                button:hover {
-                                    background: #218838;
-                                }
-                                .status {
-                                    text-align: center;
-                                    margin-top: 20px;
-                                    font-weight: bold;
-                                    display: none;
-                                }
-                            </style>
-                        </head>
-                        <body>
-                        <div class="container">
-                            <h1>Review Test Cases</h1>
-                            <div id="test-cases">
-                    `;
-
-                    testCases.forEach(tc => {
-                        html += `
-                            <div class="test-case">
-                                <div class="test-id">${tc.id}</div>
-                                <div class="test-title">${tc.title}</div>
-                                <div class="test-description">${tc.description}</div>
-                            </div>
-                        `;
-                    });
-
+            const app = express();
+            const port = 3001;
+
+            // Serve a simple HTML page with test cases
+            app.get("/", (req, res) => {
+                let html = `
+                    <html>
+                    <head>
+                        <title>Test Case Approval</title>
+                        <style>
+                            body {
+                                font-family: Arial, sans-serif;
+                                margin: 20px;
+                                background-color: #f5f5f5;
+                            }
+                            .container {
+                                max-width: 1200px;
+                                margin: 0 auto;
+                                background: white;
+                                padding: 20px;
+                                border-radius: 8px;
+                                box-shadow: 0 2px 10px rgba(0,0,0,0.1);
+                            }
+                            h1 {
+                                color: #333;
+                                text-align: center;
+                                border-bottom: 2px solid #007cba;
+                                padding-bottom: 10px;
+                            }
+                            .test-case {
+                                margin: 15px 0;
+                                padding: 15px;
+                                border: 1px solid #ddd;
+                                border-radius: 8px;
+                                background: #fafafa;
+                            }
+                            .test-id {
+                                font-weight: bold;
+                                color: #007cba;
+                                font-size: 16px;
+                            }
+                            .test-title {
+                                font-weight: bold;
+                                margin: 5px 0;
+                                color: #333;
+                            }
+                            .test-description {
+                                color: #666;
+                                line-height: 1.4;
+                            }
+                            .button-container {
+                                text-align: center;
+                                margin-top: 30px;
+                                padding-top: 20px;
+                                border-top: 1px solid #ddd;
+                            }
+                            button {
+                                padding: 15px 30px;
+                                background: #28a745;
+                                color: white;
+                                border: none;
+                                border-radius: 5px;
+                                cursor: pointer;
+                                font-size: 16px;
+                                font-weight: bold;
+                            }
+                            button:hover {
+                                background: #218838;
+                            }
+                            .status {
+                                text-align: center;
+                                margin-top: 20px;
+                                font-weight: bold;
+                                display: none;
+                            }
+                        </style>
+                    </head>
+                    <body>
+                    <div class="container">
+                        <h1>Review Test Cases</h1>
+                        <div id="test-cases">
+                `;
+
+                testCases.forEach(tc => {
                     html += `
-                            </div>
-                            <div class="button-container">
-                                <button onclick="approveTestCases()">✓ Approve Test Cases</button>
-                                <div id="status" class="status"></div>
-                            </div>
+                        <div class="test-case">
+                            <div class="test-id">${tc.id}</div>
+                            <div class="test-title">${tc.title}</div>
+                            <div class="test-description">${tc.description}</div>
                         </div>
-
-                        <script>
-                            function approveTestCases() {
-                                document.querySelector('button').disabled = true;
-                                document.querySelector('button').style.background = '#6c757d';
-                                document.querySelector('button').innerHTML = 'Processing...';
-
-                                const status = document.getElementById('status');
-                                status.style.display = 'block';
-                                status.style.color = '#28a745';
-                                status.innerHTML = 'Test cases approved! You can close this window.';
-
-                                fetch('/approve')
-                                    .then(response => response.text())
-                                    .then(data => {
-                                        status.innerHTML = data + ' You can close this window.';
-                                        setTimeout(() => {
-                                            window.close();
-                                        }, 2000);
-                                    })
-                                    .catch(error => {
-                                        status.style.color = '#dc3545';
-                                        status.innerHTML = 'Error: ' + error.message;
-                                    });
-                            }
-                        </script>
-                        </body>
-                        </html>
                     `;
-                    res.send(html);
                 });
 
-                // Approval endpoint
-                app.get("/approve", (req, res) => {
-                    userApproved = true;
-                    res.send("✓ Test cases approved successfully!");
-
-                    // Close server after a short delay
-                    setTimeout(() => {
-                        if (server) {
-                            server.close();
+                html += `
+                        </div>
+                        <div class="button-container">
+                            <button onclick="approveTestCases()">✓ Approve Test Cases</button>
+                            <div id="status" class="status"></div>
+                        </div>
+                    </div>
+
+                    <script>
+                        function approveTestCases() {
+                            document.querySelector('button').disabled = true;
+                            document.querySelector('button').style.background = '#6c757d';
+                            document.querySelector('button').innerHTML = 'Processing...';
+
+                            const status = document.getElementById('status');
+                            status.style.display = 'block';
+                            status.style.color = '#28a745';
+                            status.innerHTML = 'Test cases approved! You can close this window.';
+
+                            fetch('/approve/${sessionId}')
+                                .then(response => response.text())
+                                .then(data => {
+                                    status.innerHTML = data + ' You can close this window.';
+                                    setTimeout(() => {
+                                        window.close();
+                                    }, 2000);
+                                })
+                                .catch(error => {
+                                    status.style.color = '#dc3545';
+                                    status.innerHTML = 'Error: ' + error.message;
+                                });
                         }
-                        resolve("✓ Test cases have been approved by the user. Continuing with next operations...");
-                    }, 1000);
-                });
+                    </script>
+                    </body>
+                    </html>
+                `;
+                res.send(html);
+            });
 
-                // Start server
-                server = app.listen(port, async () => {
-                    console.log(`Test case review server started on http://localhost:${port}`);
-
-                    try {
-                        // Use dynamic import for the open package (ES module)
-                        const { default: open } = await import('open');
-                        await open(`http://localhost:${port}`);
-                        console.log('Browser opened successfully');
-                    } catch (openError) {
-                        console.log('Failed to open browser automatically:', openError.message);
-                        console.log(`Please manually open: http://localhost:${port}`);
-                    }
-                });
+            // Approval endpoint
+            app.get(`/approve/${sessionId}`, (req, res) => {
+                const session = approvalSessions.get(sessionId);
+                if (session) {
+                    session.status = 'approved';
+                    approvalSessions.set(sessionId, session);
+                }
+                res.send("✓ Test cases approved successfully!");
+            });
 
-                // Handle server errors
-                server.on('error', (err) => {
-                    reject(`Server error: ${err.message}`);
-                });
+            // Start server
+            const server = app.listen(port, async () => {
+                console.log(`Test case review server started on http://localhost:${port}`);
+
+                try {
+                    // Use dynamic import for the open package (ES module)
+                    const { default: open } = await import('open');
+                    await open(`http://localhost:${port}`);
+                    console.log('Browser opened successfully');
+                } catch (openError) {
+                    console.log('Failed to open browser automatically:', openError.message);
+                    console.log(`Please manually open: http://localhost:${port}`);
+                }
+            });
 
-                // Timeout after 10 minutes if user doesn't approve
-                setTimeout(() => {
-                    if (!userApproved && server) {
-                        server.close();
-                        reject("⚠️ Review session timed out after 10 minutes. Test cases were not approved.");
+            // Store server reference in session
+            const session = approvalSessions.get(sessionId);
+            session.server = server;
+            approvalSessions.set(sessionId, session);
+
+            // Auto cleanup after 5 minutes
+            setTimeout(() => {
+                const session = approvalSessions.get(sessionId);
+                if (session && session.status === 'pending') {
+                    session.status = 'timeout';
+                    if (session.server) {
+                        session.server.close();
                     }
-                }, 600000); // 10 minutes
+                    approvalSessions.set(sessionId, session);
+                }
+            }, 300000); // 5 minutes
+
+            return JSON.stringify({
+                status: "review_started",
+                sessionId: sessionId,
+                message: "Test case review interface opened in browser. Use check_approval_status tool to poll for approval.",
+                testCasesCount: testCases.length,
+                browserUrl: `http://localhost:${port}`,
+                instructions: "Poll every 10 seconds using check_approval_status tool until approved or timeout (5 minutes)"
             });
 
         } catch (err) {
-            return `❌ Error setting up review interface: ${err.message}`;
+            return JSON.stringify({
+                status: "error",
+                message: `Error setting up review interface: ${err.message}`
+            });
         }
     }
 );
 
+tool(
+    "check_approval_status",
+    "Check the approval status of test cases review session",
+    {
+        sessionId: zod_1.z.string().describe("The session ID returned from review_testcases tool")
+    },
+    async ({ sessionId }) => {
+        const session = approvalSessions.get(sessionId);
 
+        if (!session) {
+            return JSON.stringify({
+                status: "error",
+                message: "Session not found. Invalid session ID."
+            });
+        }
+
+        const currentTime = Date.now();
+        const elapsedTime = Math.floor((currentTime - session.startTime) / 1000);
+
+        if (session.status === 'approved') {
+            // Clean up session and close server
+            if (session.server) {
+                session.server.close();
+            }
+            approvalSessions.delete(sessionId);
 
+            return JSON.stringify({
+                status: "approved",
+                message: "Test cases have been approved by the user. Continuing with next operations...",
+                testCasesCount: session.testCases.length,
+                elapsedTime: elapsedTime
+            });
+        } else if (session.status === 'timeout' || elapsedTime > 300) { // 5 minutes
+            // Clean up session and close server
+            if (session.server) {
+                session.server.close();
+            }
+            approvalSessions.delete(sessionId);
+
+            return JSON.stringify({
+                status: "timeout",
+                message: "Review session timed out after 5 minutes. Test cases were not approved.",
+                testCasesCount: session.testCases.length,
+                elapsedTime: elapsedTime
+            });
+        } else {
+            return JSON.stringify({
+                status: "pending",
+                message: "Test cases are still pending approval. Continue polling.",
+                testCasesCount: session.testCases.length,
+                elapsedTime: elapsedTime,
+                remainingTime: Math.max(0, 300 - elapsedTime)
+            });
+        }
+    }
+);
     return server;
 };
 

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.68",
+  "version": "2.0.70",
   "description": "Appium MCP",
   "engines": {
     "node": ">=18"