@nbakka/mcp-appium 3.0.11 → 3.0.13

package/lib/app_context.txt

@@ -18,9 +18,9 @@ IMPORTANT: If the element you looking for is not present you can use swipe
 - sendKeys("locator_key", "string_to_be_passed", Wait.SHORT)
 Figure out dynamic paths like //android.widget.TextView[@text="View 180 Properties"] here 180 is not constant so create a xpath like //android.widget.TextView[contains(@text,"View") and contains(@text,"Properties")]
 For repeating logic, create loops
-Generated code should be pasted in aicode.txt as mentioned below, clear the existing contents of it before copying new code.
-No need to add comments in code and only mention locators that are new and not present in the locator sheet in comments at end of aicode.txt file as shown in sample code below.
-** SAMPLE FILE aicode.txt **
+No need to add comments in code and only mention locators that are new and not present in the locator sheet in comments at end of file as shown in sample code below.
+Automation code has to be generated only for approved test cases
+** SAMPLE TESTCASES Automation code has to be generated only for approved test cases**
 /**
  * Test Method for Nearby Properties Verification on New Project Dedicated Page
  * Verifies that clicking on nearby properties opens the correct detail page

package/lib/server.js

@@ -149,9 +149,9 @@ const createMcpServer = () => {
 
  tool(
    "mobile_learn_current_app_context",
-   "Follow these instructions strictly to navigate through the app. This should be the first step after launching the app and before performing any tests. Provide the Google Sheet name to fetch locatorName and androidLocator from the specified sheet. NOTE: Only use the locator data from the Google Sheet at the end while generating test cases, don't use to navigate through screens",
+   "Follow these instructions strictly to navigate through the app. This should be the first step after launching the app and before performing any tests. Google Sheet name to fetch locatorName and androidLocator from the specified sheet. NOTE: Only use the locator data from the Google Sheet at the end while generating test cases, don't use to navigate through screens",
    {
-     sheetName: zod_1.z.string().describe("The name of the Google Sheet to fetch locator data from"),
+     sheetName: zod_1.z.string().describe("The name of the Google Sheet to fetch locator data from").default("PDP"),
    },
    async ({ sheetName }) => {
      try {
@@ -1568,6 +1568,105 @@ tool(
   }
 );
 
+tool(
+  "update_testcases_to_tcms",
+  "Create new test cases in TCMS from approved test cases. Only processes test cases with 'New' status, ignores Modify and Remove cases since APIs are not available.",
+  {
+    testCases: zod_1.z.array(zod_1.z.array(zod_1.z.string())).describe("Array of test case arrays from approved test cases")
+  },
+  async ({ testCases }) => {
+    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");
+
+      // Filter test cases to extract only "New" test cases
+      const newTestCases = [];
+
+      for (const testCase of testCases) {
+        if (Array.isArray(testCase) && testCase.length >= 2) {
+          // Check if the last element or second-to-last element is "New"
+          const status = testCase.length === 2 ? testCase[1] : testCase[testCase.length - 2];
+
+          if (status && status.toLowerCase() === 'new') {
+            const title = testCase[0]; // First element is always the title
+            if (title && title.trim().length > 0) {
+              newTestCases.push(title.trim());
+            }
+          }
+        }
+      }
+
+      if (newTestCases.length === 0) {
+        return "No new test cases found to create in TCMS. Only test cases marked as '(New)' are processed.";
+      }
+
+      // Hard-coded values as requested
+      const projectKey = "SCRUM";
+      const folderId = 1;
+      const ownerId = "712020:37085ff2-5a05-47eb-8977-50a485355755";
+
+      // Create test cases in TCMS one by one
+      for (let i = 0; i < newTestCases.length; i++) {
+        const title = newTestCases[i];
+
+        try {
+          const requestBody = {
+            title: title,
+            ownedByID: ownerId,
+            folder: {
+              ID: folderId
+            },
+            status: {
+              name: "Published",
+              description: "The test is ready for execution",
+              ID: 1
+            }
+          };
+
+          (0, logger_1.trace)(`Creating test case ${i + 1}/${newTestCases.length}: ${title}`);
+
+          const response = await axios.post(
+            `https://tcms.aiojiraapps.com/aio-tcms/api/v1/project/${projectKey}/testcase`,
+            requestBody,
+            {
+              headers: {
+                "accept": "application/json;charset=utf-8",
+                "Authorization": `AioAuth ${token}`,
+                "Content-Type": "application/json"
+              }
+            }
+          );
+
+          if (response.status === 200 || response.status === 201) {
+            const testCaseKey = response.data.key || `${projectKey}-TC-${response.data.ID}`;
+            (0, logger_1.trace)(`Successfully created test case: ${testCaseKey} - ${title}`);
+          }
+
+          // Add a small delay between requests to avoid rate limiting
+          await new Promise(resolve => setTimeout(resolve, 500));
+
+        } catch (error) {
+          (0, logger_1.trace)(`Failed to create test case: ${title} - ${error.message}`);
+          throw new Error(`Failed to create test case "${title}": ${error.message}`);
+        }
+      }
+
+      return "All test cases have been updated to TCMS";
+
+    } catch (error) {
+      console.error('TCMS update error:', error);
+      if (error.response) {
+        return `❌ TCMS API Error: ${error.response.status} - ${error.response.data?.message || error.response.statusText}`;
+      }
+      return `❌ Error updating test cases to TCMS: ${error.message}`;
+    }
+  }
+);
+
     return server;
 };
 

package/lib/testcases-generation-context.txt

@@ -1,3 +1,11 @@
+When asked to generate automation test cases for a jira ticket, the flow is as follows (Should not ask for user input till the last step):
+by using mcp tools
+1. Read the jira summary and description to understand the changes made in the feature.
+2. Look at the figma design link provided in the jira ticket to understand the UI changes
+3. Based on the changes mentioned in the jira summary and description, and the figma design, generate test cases
+4. Approval from user is needed for the generated test cases
+5. Once the test cases are approved by user, learn mobile app context
+6. Generate automation code for the approved test cases or modify existing for linked test files
 generate test cases using jira summary, description and figma image,
 don't wait for extra user input,
 test cases scope should be only for the changes mentioned in jira summary and description,
@@ -16,9 +24,10 @@ should contains before test case from tcms and after testcase that is generated,
 existing in TCMS and if change is to be done to it should be marked as Modify
 "SCRUM-TC-2" - id of existing test case in TCMS, only for Remove and Modify test cases
 if any new test case is to be created then don't mention any id against it
-for review_testcases test cases tool data should be in this format, strictly follow this format espcially for Modify test cases
+for review_testcases and update_testcases_to_tcms tool data should be in this format, strictly follow this format espcially for Modify test cases
 {"testCases":[["Verify that brochure section is visible under overview tab","Verify brochure section is removed from property tour tab","Modify","SCRUM-TC-1"],
 ["Verify similar properties section is visible under over tab in pdp section","Remove","SCRUM-TC-2"],
 ["Verify Project Brochure section appears above the 'Explore on map' section in Overview tab","New"]]}
-
-NOTE: keep polling continously for 10 times max till the test cases are approved by user
+for update_testcases_to_tcms tool, send only test cases approved by user
+NOTE: keep polling continously for 10 times max till the test cases are approved by user, don't wait for user input
+Automation code has to be generated only for approved test cases

package/package.json

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