@nbakka/mcp-appium 2.0.36 → 2.0.38

package/lib/app_context.txt

@@ -1,4 +1,5 @@
-You have to first manually execute the steps till you reach the end goal by intelligently navigating through the app and then generate the code based on the elements you find. Follow these instructions carefully:
+******** START OF GUIDELINES ********
+You are an expert Appium test case generator. You will be given a set of instructions to follow to reach a certain goal in the app. You have to generate Appium code based on the elements you find on the screen while navigating through the app.
 When asked to open buy SRP, use deeplink to open https://housing.com/in/buy/mumbai/<locality name>. For example: if asked to open 'Mira Road East' buy SRP, then open this deeplink: https://housing.com/in/buy/mumbai/mira_road_east
 Homepage deeplink -> https://housing.com/in/buy/real-estate-mumbai
 Only use the locator data from the Google Sheet at the end while generating test cases, don't use to navigate through screens, always get current screen elements and navigate then at end use locator data to generate code, if xpath is already present in sheet then directly add xpath locatorName to code if not then add the required xpath in comments which will then be added to the sheet manually
@@ -7,19 +8,99 @@ Filters on the filter screen may initially be offscreen and require scrolling to
 Stop execution if any step fails.
 IMPORTANT: If the element you looking for is not present you can use swipe
 (Remember this properly - Very important) After the execution is successful/completed, do NOT analyze what you found or did; only generate Appium code.
-Print the Java/Appium code. In our framework, we use the following methods:
 - waitForElementToBeVisible("locator_key", Wait.SHORT); locator_key is locator key and wait can be SHORT, MEDIUM, or LONG.
--  w3CGestures.scrollUp(n);;  // n is the number of times to scroll. Up  and Down in scroll methods are direction of finger movement.
--  w3CGestures.scrollScreen("image_tour_navbar", ScrollDirection.MEDIUM_UP, 2); // image_tour_navbar is locator key, ScrollDirection can be SMALL_UP, MEDIUM_UP, LARGE_UP, SMALL_DOWN, MEDIUM_DOWN, LARGE_DOWN.
+-  w3CGestures.scrollUp(n);  // n is the number of times to scroll. Up  and Down in scroll methods are direction of finger movement.
+-  w3CGestures.scrollScreen("image_tour_navbar", ScrollDirection.MEDIUM_UP, 2); // image_tour_navbar is locator key, ScrollDirection can be SMALL_UP, MEDIUM_UP, LARGE_UP, SMALL_DOWN, MEDIUM_DOWN, LARGE_DOWN and 2 is max number of scrolls to perform, if not found in 2 scrolls then it will throw error. (DO NOT USE other methods except these two for scrolling)
 - navigateBack(); // for back action.
 - deepLink.OpenDeepLink("deeplink_key"); // deeplink_key is deeplink name.
 - getText("locator_key"); // to get text of element.
-Using the above, return code that looks like:
-deepLink.OpenDeepLink(deeplink); // deeplink -> https://housing.com
-waitForElementToBeVisible("view_on_map", Wait.LONG); // view_on_map=//android.widget.TextView[@text="View On Map"]; here xpath should be comments so it can be pasted in xpath sheet.
-When giving output, please remove escape characters before double quotes.
-Do similarly for click and sendKeys methods:
 - click("search_select", Wait.SHORT)
 - 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
+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 **
+/**
+ * Test Method for Nearby Properties Verification on New Project Dedicated Page
+ * Verifies that clicking on nearby properties opens the correct detail page
+ */
+
+@Test(priority = 19, dataProvider = "test-data", dataProviderClass = TestDataProvider.class)
+@Description("Test Description: Verify nearby properties functionality on new project dedicated page")
+public void npNearbyPropertiesVerification(HashMap<String, String> testData) {
+    detailPage.npNearbyPropertiesVerification(testData.get("np_dedicated_deeplink"));
+}
+
+/**
+ * Method Definition for DetailPage.java
+ * Add this method to the DetailPage class
+ */
+
+public void npNearbyPropertiesVerification(String deeplink) {
+    deepLink.OpenDeepLink(deeplink);
+    if (waitForElementToBePresent("later_btn", Wait.SHORT)) {
+        click("later_btn");
+    }
+    waitForElementToBeVisible("project_name", Wait.LONG);
+    waitForElementToBeVisible("Overview", Wait.SHORT);
+    w3CGestures.scrollScreen("high_value_project_title", ScrollDirection.MEDIUM_UP, 2);
+    waitForElementToBeVisible("high_value_project_title", Wait.SHORT);
+    String nearbyProjectsTitle = getElement("high_value_project_title").getText();
+    Assert.assertTrue(nearbyProjectsTitle.contains("Premium projects nearby"),
+        "Expected nearby projects section title to contain 'Premium projects nearby' but found: " + nearbyProjectsTitle);
+    w3CGestures.scrollScreen("near_by_project_name1", ScrollDirection.MEDIUM_UP, 2);
+    waitForElementToBeVisible("near_by_project_name1", Wait.SHORT);
+    waitForElementToBeVisible("near_by_project_price1", Wait.SHORT);
+    String expectedPropertyName = getElement("near_by_project_name1").getText();
+    String expectedPropertyPrice = getElement("near_by_project_price1").getText();
+    System.out.println("Expected Property Name: " + expectedPropertyName);
+    System.out.println("Expected Property Price: " + expectedPropertyPrice);
+    click("nearby_high_value_project1");
+    waitForElementToBeVisible("project_name", Wait.LONG);
+    waitForElementToBeVisible("project_price", Wait.SHORT);
+    String actualPropertyName = getElement("project_name").getText();
+    String actualPropertyPrice = getElement("project_price").getText();
+    System.out.println("Actual Property Name: " + actualPropertyName);
+    System.out.println("Actual Property Price: " + actualPropertyPrice);
+    Assert.assertEquals(actualPropertyName, expectedPropertyName,
+        "Property name mismatch. Expected: " + expectedPropertyName + " but found: " + actualPropertyName);
+    Assert.assertEquals(actualPropertyPrice, expectedPropertyPrice,
+        "Property price mismatch. Expected: " + expectedPropertyPrice + " but found: " + actualPropertyPrice);
+    waitForElementToBeVisible("Overview", Wait.SHORT);
+    waitForElementToBeVisible("Highlights", Wait.SHORT);
+    waitForElementToBeVisible("Property Tour", Wait.SHORT);
+    System.out.println("✓ Nearby properties verification completed successfully");
+    System.out.println("✓ Property '" + expectedPropertyName + "' opened correctly with matching price: " + expectedPropertyPrice);
+}
+
+/**
+ * Additional Locators to be added to the locator sheet or properties file:
+ *
+ * # Nearby Projects Section Locators
+ * high_value_project_title=//android.widget.TextView[@text[contains(.,'Premium projects nearby')]]
+ * high_value_project_section=//android.view.View[@content-desc='high_value_project_section']
+ * near_by_project_name1=//android.widget.TextView[@content-desc='near_by_project_name1']
+ * near_by_project_price1=//android.widget.TextView[@content-desc='near_by_project_price1']
+ * near_by_project_name2=//android.widget.TextView[@content-desc='near_by_project_name2']
+ * near_by_project_price2=//android.widget.TextView[@content-desc='near_by_project_price2']
+ * near_by_project_name3=//android.widget.TextView[@content-desc='near_by_project_name3']
+ * near_by_project_price3=//android.widget.TextView[@content-desc='near_by_project_price3']
+ * near_by_project_name4=//android.widget.TextView[@content-desc='near_by_project_name4']
+ * near_by_project_price4=//android.widget.TextView[@content-desc='near_by_project_price4']
+ * nearby_high_value_project1=//android.view.View[@content-desc='nearby_high_value_project1']
+ * nearby_high_value_project2=//android.view.View[@content-desc='nearby_high_value_project2']
+ * nearby_high_value_project3=//android.view.View[@content-desc='nearby_high_value_project3']
+ * nearby_high_value_project4=//android.view.View[@content-desc='nearby_high_value_project4']
+ * project_name=//android.widget.TextView[@content-desc='project_name']
+ * project_price=//android.widget.TextView[@content-desc='project_price']
+ * project_address=//android.widget.TextView[@content-desc='project_address']
+ * project_config=//android.widget.TextView[@content-desc='project_config']
+ * later_btn=//android.widget.TextView[@text='Later']
+ * Overview=//android.widget.TextView[@text='Overview']
+ * Highlights=//android.widget.TextView[@text='Highlights']
+ * Property Tour=//android.widget.TextView[@text='Property Tour']
+ * Data Insights=//android.widget.TextView[@text='Data Insights']
+
+** END OF SAMPLE FILE **
+******** END OF GUIDELINES ********

package/lib/server.js

@@ -14,6 +14,7 @@ const ios_1 = require("./ios");
 const png_1 = require("./png");
 const image_utils_1 = require("./image-utils");
 const { google } = require('googleapis');
+const axios = require('axios');
 const getAgentVersion = () => {
     const json = require("../package.json");
     return json.version;
@@ -316,6 +317,133 @@ const createMcpServer = () => {
       }
     );
 
+    tool(
+      "mobile_fetch_jira_ticket",
+      "Fetch JIRA ticket information including summary, description, and extract Figma links from description",
+      {
+        ticketId: zod_1.z.string().describe("The JIRA ticket ID (e.g., HDA-434)"),
+      },
+      async ({ ticketId }) => {
+        try {
+          // Read JIRA credentials from desktop/jira.json file
+          const jiraConfigPath = path.join(os.homedir(), 'Desktop', 'jira.json');
+
+          let jiraConfig;
+          try {
+            const configContent = await fs.readFile(jiraConfigPath, 'utf-8');
+            jiraConfig = JSON.parse(configContent);
+          } catch (error) {
+            throw new Error(`Failed to read JIRA config from ${jiraConfigPath}: ${error.message}`);
+          }
+
+          // Extract all required values from JSON file
+          const { api: jiraApiToken, baseUrl: jiraBaseUrl, email: jiraEmail } = jiraConfig;
+
+          if (!jiraApiToken) {
+            throw new Error('JIRA API token not found in jira.json file. Please ensure the file contains "api" field.');
+          }
+
+          if (!jiraBaseUrl) {
+            throw new Error('JIRA base URL not found in jira.json file. Please ensure the file contains "baseUrl" field.');
+          }
+
+          if (!jiraEmail) {
+            throw new Error('JIRA email not found in jira.json file. Please ensure the file contains "email" field.');
+          }
+
+          // Create Basic Auth token
+          const auth = Buffer.from(`${jiraEmail}:${jiraApiToken}`).toString('base64');
+
+          // Fetch ticket from JIRA API
+          const response = await axios.get(
+            `${jiraBaseUrl}/rest/api/3/issue/${ticketId}`,
+            {
+              headers: {
+                'Authorization': `Basic ${auth}`,
+                'Accept': 'application/json',
+                'Content-Type': 'application/json'
+              }
+            }
+          );
+
+          const issue = response.data;
+
+          // Extract summary and description
+          const summary = issue.fields.summary || 'No summary available';
+          const description = issue.fields.description ?
+            extractTextFromADF(issue.fields.description) :
+            'No description available';
+
+          // Extract Figma links from description
+          const figmaLinks = extractFigmaLinks(description);
+
+          // Format response
+          const result = {
+            ticketId: ticketId,
+            summary: summary,
+            description: description,
+            figmaLinks: figmaLinks.length > 0 ? figmaLinks : ['No Figma links found']
+          };
+
+          return `JIRA Ticket Information:
+    Ticket ID: ${result.ticketId}
+    Summary: ${result.summary}
+    Description: ${result.description}
+    Figma Links: ${result.figmaLinks.join(', ')}`;
+
+        } catch (error) {
+          if (error.response && error.response.status === 404) {
+            return `Error: JIRA ticket ${ticketId} not found. Please check the ticket ID.`;
+          } else if (error.response && error.response.status === 401) {
+            return `Error: Authentication failed. Please check your JIRA credentials.`;
+          } else {
+            return `Error fetching JIRA ticket: ${error.message}`;
+          }
+        }
+      }
+    );
+
+    // Helper function to extract text from Atlassian Document Format (ADF)
+    function extractTextFromADF(adfContent) {
+      if (!adfContent || typeof adfContent !== 'object') {
+        return String(adfContent || '');
+      }
+
+      let text = '';
+
+      function traverse(node) {
+        if (node.type === 'text') {
+          text += node.text || '';
+        } else if (node.content && Array.isArray(node.content)) {
+          node.content.forEach(traverse);
+        }
+
+        // Add line breaks for paragraphs
+        if (node.type === 'paragraph') {
+          text += '\n';
+        }
+      }
+
+      if (adfContent.content) {
+        adfContent.content.forEach(traverse);
+      }
+
+      return text.trim();
+    }
+
+    // Helper function to extract Figma links from text
+    function extractFigmaLinks(text) {
+      if (!text || typeof text !== 'string') {
+        return [];
+      }
+
+      // Regular expression to match Figma URLs
+      const figmaRegex = /https?:\/\/(?:www\.)?figma\.com\/[^\s<>"{}|\\^`\[\]]+/gi;
+      const matches = text.match(figmaRegex);
+
+      return matches ? [...new Set(matches)] : []; // Remove duplicates
+    }
+
     return server;
 };
 

package/package.json

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