@nbakka/mcp-appium 2.0.71 → 2.0.73

package/lib/server.js

@@ -613,7 +613,67 @@ tool(
 );
 
 tool(
-  "upload_png_to_openai",
+  "fetch_testcases_from_tcms",
+  "Fetch test cases from TCMS tool for a specific folder",
+  {
+    projectKey: zod_1.z.string().describe("The project key (e.g., SCRUM)"),
+    folderName: zod_1.z.string().describe("The folder name to filter test cases (e.g., PDP)")
+  },
+  async ({ projectKey, folderName }) => {
+    try {
+      // Load AIO token from Desktop/aio.json
+      const aioConfigPath = path.join(os.homedir(), "Desktop", "aio.json");
+      const configContent = await fs.readFile(aioConfigPath, "utf-8");
+      const { token } = JSON.parse(configContent);
+
+      if (!token) throw new Error("AIO token missing in aio.json");
+
+      // Make API request to TCMS
+      const response = await axios.get(
+        `https://tcms.aiojiraapps.com/aio-tcms/api/v1/project/${projectKey}/testcase`,
+        {
+          headers: {
+            "accept": "application/json;charset=utf-8",
+            "Authorization": `AioAuth ${token}`
+          }
+        }
+      );
+
+      const testCases = response.data.items || [];
+
+      // Filter test cases by folder name
+      const filteredTestCases = testCases.filter(testCase =>
+        testCase.folder && testCase.folder.name === folderName
+      );
+
+      if (filteredTestCases.length === 0) {
+        return `No test cases found in folder: ${folderName}`;
+      }
+
+      // Extract key, title, and folder name
+      const extractedTestCases = filteredTestCases.map(testCase => ({
+        key: testCase.key,
+        title: testCase.title,
+        folderName: testCase.folder.name
+      }));
+
+      return {
+        folderName: folderName,
+        totalCount: extractedTestCases.length,
+        testCases: extractedTestCases
+      };
+
+    } catch (err) {
+      if (err.response) {
+        return `❌ TCMS API Error: ${err.response.status} - ${err.response.data?.message || err.response.statusText}`;
+      }
+      return `❌ Error fetching test cases: ${err.message}`;
+    }
+  }
+);
+
+tool(
+  "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"),
@@ -621,6 +681,10 @@ tool(
   },
   async ({ jiraSummary, jiraDescription }) => {
     try {
+      // Clear the generated test cases file before starting
+      const testCasesFilePath = path.join(__dirname, 'generated-testcases.txt');
+      await fs.writeFile(testCasesFilePath, ''); // Clear the file
+
       // 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");
@@ -646,7 +710,8 @@ tool(
       const pngBuffer = await fs.readFile(pngPath);
       const base64Image = pngBuffer.toString('base64');
 
-      const completion = await client.chat.completions.create({
+      // Start OpenAI generation (this will run in background due to timeout)
+      client.chat.completions.create({
         model: "gpt-5", // Use GPT-5 model for image analysis
         messages: [{
           role: "user",
@@ -672,13 +737,51 @@ ${guidelines}`
           ]
         }],
         max_completion_tokens: 10000
+      }).then(async (completion) => {
+        // Save test cases to file when generation completes
+        const testCases = completion.choices[0].message.content;
+        await fs.writeFile(testCasesFilePath, testCases);
+      }).catch(async (error) => {
+        // Save error to file if generation fails
+        await fs.writeFile(testCasesFilePath, `Error generating test cases: ${error.message}`);
       });
 
-      const testCases = completion.choices[0].message.content;
+      return "✅ Test case generation started. Use 'check_testcases_status' tool to check if generation is complete.";
+    } catch (err) {
+      return `❌ Error starting test case generation: ${err.message}`;
+    }
+  }
+);
+
+tool(
+  "check_testcases_status",
+  "Check if test cases have been generated and saved to file",
+  {},
+  async () => {
+    try {
+      // Wait for 20 seconds before checking
+      await new Promise(resolve => setTimeout(resolve, 20000));
+
+      const testCasesFilePath = path.join(__dirname, 'generated-testcases.txt');
+
+      // Check if file exists and has content
+      try {
+        const fileContent = await fs.readFile(testCasesFilePath, 'utf-8');
 
-      return testCases;
+        if (fileContent.trim().length === 0) {
+          return "❌ Test cases are still being generated. Please wait and try again.";
+        }
+
+        if (fileContent.startsWith('Error generating test cases:')) {
+          return `❌ ${fileContent}`;
+        }
+
+        return `✅ Test cases generated successfully!\n\n${fileContent}`;
+      } catch (fileError) {
+        return "❌ Test cases file not found or still being created. Please wait and try again.";
+      }
     } catch (err) {
-      return `❌ Error generating test cases: ${err.message}`;
+      return `❌ Error checking test cases status: ${err.message}`;
     }
   }
 );

package/lib/testcases-generation-context.txt

@@ -1,5 +1,8 @@
 generate test cases using jira summary, description and figma image,
-don't take any extra user input,
+don't wait for extra user input,
+test cases scope should be only for the changes mentioned in jira summary and description,
+don't create test cases for other features visible in figma design because the design will also
+have other features which are not part of the jira ticket,
 final output should be test in following format
 "Verify pay on credit banner exits on PDP", "Existing"
 "Verify overview tab on PDP", "New"

package/package.json

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