@nbakka/mcp-appium 2.0.55 → 2.0.57

package/lib/server.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMcpServer = void 0;
 const fs = require('fs').promises;
 const os = require('os');
+const fsSync = require('fs');
 const path = require('path');
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const zod_1 = require("zod");
@@ -565,6 +566,25 @@ tool(
       const pdfResponse = await axios.get(pdfUrl, { responseType: "arraybuffer" });
 
       const exportPath = path.join(os.homedir(), "Desktop", "figma");
+
+      // Clear the folder before creating new PDF
+      try {
+        // Check if folder exists
+        await fs.access(exportPath);
+        // If folder exists, remove all contents
+        const files = await fs.readdir(exportPath);
+        await Promise.all(
+          files.map(file => fs.unlink(path.join(exportPath, file)))
+        );
+        console.log("Cleared existing files in figma folder");
+      } catch (err) {
+        // Folder doesn't exist or is empty, no need to clear
+        if (err.code !== 'ENOENT') {
+          console.log("⚠️ Warning: Could not clear folder:", err.message);
+        }
+      }
+
+      // Ensure directory exists
       await fs.mkdir(exportPath, { recursive: true });
 
       const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, -5);
@@ -578,251 +598,60 @@ tool(
   }
 );
 
-
-// ----------------------
-// FIXED TOOL: Generate Manual Test Cases from PDF + JIRA
-// ----------------------
 tool(
   "upload_pdf_to_openai",
   "Generate manual test cases by analyzing PDF design with JIRA requirements",
   {
     jiraSummary: zod_1.z.string().describe("Jira issue summary"),
-    jiraDescription: zod_1.z.string().describe("Jira issue description"),
-    pdfPath: zod_1.z.string().describe("Path to PDF file from tool 1")
+    jiraDescription: zod_1.z.string().describe("Jira issue description")
   },
-  async ({ jiraSummary, jiraDescription, pdfPath }) => {
+  async ({ jiraSummary, jiraDescription }) => {
     try {
-      // Load OpenAI API key
+      // Load OpenAI API key from Desktop/openai.json
       const openaiConfigPath = path.join(os.homedir(), "Desktop", "openai.json");
       const configContent = await fs.readFile(openaiConfigPath, "utf-8");
-      const { apiKey: openaiKey } = JSON.parse(configContent);
-
-      if (!openaiKey) throw new Error("OpenAI API key missing in openai.json");
+      const { apiKey } = JSON.parse(configContent);
 
-      const client = new OpenAI({ apiKey: openaiKey });
-
-      // Validate file exists
-      try {
-        await fs.access(pdfPath);
-      } catch (error) {
-        throw new Error(`PDF file not found at path: ${pdfPath}`);
-      }
+      const figmaDir = path.join(os.homedir(), "Desktop", "figma");
+      const files = await fs.readdir(figmaDir);
+      const pdfFiles = files.filter(file => file.toLowerCase().endsWith('.pdf'));
 
-      const stats = await fs.stat(pdfPath);
-      const fileName = path.basename(pdfPath);
+      if (pdfFiles.length === 0) throw new Error("No PDF files found in figma folder");
 
-      console.log(`📄 Processing ${fileName} for test case generation...`);
+      const latestPdf = pdfFiles.sort((a, b) => b.localeCompare(a))[0];
+      const pdfPath = path.join(figmaDir, latestPdf);
 
-      // Use the require() fs for createReadStream (CommonJS style)
-      const fsSync = require('fs');
+      const client = new OpenAI({ apiKey });
 
-      // Upload PDF to OpenAI
-      const fileUpload = await client.files.create({
-        file: fsSync.createReadStream(pdfPath), // Use fsSync.createReadStream
-        purpose: "assistants"
+      const file = await client.files.create({
+        file: fsSync.createReadStream(pdfPath),
+        purpose: "user_data",
       });
 
-      console.log(`✅ PDF uploaded: ${fileUpload.id}`);
-
-      // Create specialized assistant for test case generation
-      const assistant = await client.beta.assistants.create({
-        name: "Manual Test Case Generator",
-        instructions: `You are an expert QA engineer specializing in creating comprehensive manual test cases.
-        You analyze design documents and requirements to generate detailed, actionable test cases that cover:
-        - Functional testing scenarios
-        - UI/UX validation tests
-        - Edge cases and negative scenarios
-        - Cross-browser/device compatibility tests
-        - Accessibility testing scenarios`,
+      const completion = await client.chat.completions.create({
         model: "gpt-4o",
-        tools: [{ type: "file_search" }],
-        tool_resources: {
-          file_search: {
-            vector_stores: [{
-              file_ids: [fileUpload.id]
-            }]
-          }
-        }
-      });
-
-      // Create comprehensive test case generation prompt
-      const testCasePrompt = `
-**JIRA REQUIREMENTS:**
-**Summary:** ${jiraSummary}
-**Description:** ${jiraDescription}
-
-**TASK:** Generate comprehensive manual test cases based on the attached PDF design and above JIRA requirements.
-
-**OUTPUT FORMAT REQUIRED:**
-Please structure your response as follows:
-
-## MANUAL TEST CASES
-
-### 1. FUNCTIONAL TEST CASES
-**TC-F-001: [Test Case Title]**
-- **Objective:** What this test validates
-- **Preconditions:** Setup required before testing
-- **Test Steps:**
-  1. Step 1 action
-  2. Step 2 action
-  3. Step 3 action
-- **Expected Result:** What should happen
-- **Priority:** High/Medium/Low
-
-### 2. UI/UX TEST CASES
-**TC-UI-001: [Test Case Title]**
-[Same format as above]
-
-### 3. EDGE CASE & NEGATIVE TEST CASES
-**TC-E-001: [Test Case Title]**
-[Same format as above]
-
-### 4. COMPATIBILITY TEST CASES
-**TC-C-001: [Test Case Title]**
-[Same format as above]
-
-### 5. ACCESSIBILITY TEST CASES
-**TC-A-001: [Test Case Title]**
-[Same format as above]
-
-**IMPORTANT GUIDELINES:**
-1. Create 15-20 test cases total covering all aspects
-2. Reference specific UI elements from the PDF design
-3. Include both positive and negative test scenarios
-4. Consider different user roles if applicable
-5. Include performance and usability aspects
-6. Make test steps specific and actionable
-7. Consider mobile/responsive design if shown in PDF
-8. Include data validation test cases
-9. Cover error handling scenarios
-10. Include integration testing if multiple components interact
-
-Generate detailed test cases now based on the PDF design and JIRA requirements.
-`;
-
-      // Create thread and run analysis
-      const thread = await client.beta.threads.create({
-        messages: [
-          {
-            role: "user",
-            content: testCasePrompt
-          }
-        ]
-      });
-
-      console.log(`🔄 Generating test cases...`);
-
-      const run = await client.beta.threads.runs.create(thread.id, {
-        assistant_id: assistant.id,
+        messages: [{
+          role: "user",
+          content: [{
+            type: "file",
+            file: { file_id: file.id }
+          }, {
+            type: "text",
+            text: `Generate test cases based on this PDF design and JIRA requirements:
+
+Summary: ${jiraSummary}
+Description: ${jiraDescription}`
+          }]
+        }]
       });
 
-      // Wait for completion with progress tracking
-      let runStatus = await client.beta.threads.runs.retrieve(thread.id, run.id);
-      let attempts = 0;
-      const maxAttempts = 60;
-
-      while (runStatus.status !== 'completed' && attempts < maxAttempts) {
-        if (runStatus.status === 'failed') {
-          throw new Error(`Test case generation failed: ${runStatus.last_error?.message}`);
-        }
+      const testCases = completion.choices[0].message.content;
 
-        if (attempts % 5 === 0) {
-          console.log(`⏳ Still generating... (${attempts}s elapsed)`);
-        }
-
-        await new Promise(resolve => setTimeout(resolve, 1000));
-        runStatus = await client.beta.threads.runs.retrieve(thread.id, run.id);
-        attempts++;
-      }
-
-      if (runStatus.status !== 'completed') {
-        throw new Error('Test case generation timed out after 60 seconds');
-      }
-
-      // Get the generated test cases
-      const messages = await client.beta.threads.messages.list(thread.id);
-      const testCases = messages.data
-        .filter(msg => msg.role === 'assistant')
-        .map(msg => msg.content[0]?.text?.value)
-        .join('\n\n');
-
-      // Parse test case count
-      const testCaseCount = (testCases.match(/\*\*TC-/g) || []).length;
-
-      // Clean up assistant
-      try {
-        await client.beta.assistants.del(assistant.id);
-      } catch (cleanupError) {
-        console.warn('⚠️ Assistant cleanup failed:', cleanupError.message);
-      }
-
-      // Save test cases to file
-      const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-      const outputFileName = `test_cases_${timestamp.substring(0, 19)}.md`;
-      const outputPath = path.join(path.dirname(pdfPath), outputFileName);
-
-      const fileContent = `# Manual Test Cases
-Generated on: ${new Date().toLocaleString()}
-
-## Source Information
-- **JIRA Summary:** ${jiraSummary}
-- **JIRA Description:** ${jiraDescription}
-- **Design File:** ${fileName}
-- **Total Test Cases:** ${testCaseCount}
-
----
-
-${testCases}
-
----
-
-## Test Execution Notes
-- Execute test cases in the order listed
-- Log defects with screenshots when issues found
-- Update test results in your test management tool
-- Verify on multiple browsers/devices for compatibility tests
-`;
-
-      await fs.writeFile(outputPath, fileContent, 'utf-8');
-
-      console.log(`✅ Test cases generated and saved!`);
-
-      // CRITICAL: Return only a STRING, not an object
-      // The MCP wrapper will handle the proper formatting
-      return `✅ Successfully generated ${testCaseCount} manual test cases!
-
-📁 Test cases saved to: ${outputFileName}
-📂 Full path: ${outputPath}
-
-📊 Generation Summary:
-- Total Test Cases: ${testCaseCount}
-- Categories: Functional, UI/UX, Edge Cases, Compatibility, Accessibility
-- Source File: ${fileName} (${(stats.size / 1024).toFixed(2)} KB)
-- Processing Time: ${attempts} seconds
-- Model Used: gpt-4o
-
-🎯 Test Case Preview:
-${testCases.substring(0, 1000)}...
-
-[Complete test cases saved to markdown file for easy reference and sharing]`;
+      await client.files.del(file.id);
 
+      return testCases;
     } catch (err) {
-      console.error("❌ Test Case Generation Error:", err);
-
-      // Return only error string, not object
-      let errorMessage = `❌ Failed to generate test cases: ${err.message}`;
-
-      if (err.message?.includes('quota')) {
-        errorMessage += "\n\n💡 Troubleshooting: OpenAI quota exceeded. Check your billing at platform.openai.com";
-      } else if (err.message?.includes('timeout')) {
-        errorMessage += "\n\n💡 Troubleshooting: Generation took too long. Try with a smaller PDF file.";
-      } else if (err.message?.includes('file')) {
-        errorMessage += "\n\n💡 Troubleshooting: PDF processing error. Check file format and accessibility.";
-      } else if (err.message?.includes('API key')) {
-        errorMessage += "\n\n💡 Troubleshooting: Invalid OpenAI API key. Check ~/Desktop/openai.json file.";
-      }
-
-      return errorMessage;
+      return `Error: ${err.message}`;
     }
   }
 );

package/package.json

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