@nbakka/mcp-appium 2.0.21 → 2.0.23

package/lib/app_context.txt

@@ -0,0 +1,21 @@
+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
+Project dedicated page deeplink -> https://housing.com/in/buy/projects/page/319874-sunteck-sky-park-by-sunteck-realty-limited-in-mira-road-east
+Filters on the filter screen may initially be offscreen and require scrolling to view.
+Stop execution if any step fails.
+(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.
+- scrollDown(n);  // n is the number of times to scroll.
+- 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")
+- sendKeys("locator_key", "string_to_be_passed", Wait.LONG)
+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

package/lib/secret.json

@@ -0,0 +1,13 @@
+{
+  "type": "service_account",
+  "project_id": "gen-lang-client-0998595520",
+  "private_key_id": "99b60e861b2815a0b7e4946fa0697d70f157b4a6",
+  "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCylqcylIgnlYFv\nSDSNA5w54FBTGKqwhg55bUYZoO3PYvXywgUDUO/q7jSLIYOLzQb+yiSKOBbJKTrs\ng/HP8Qr/vGoLJBXmEmhheh2YEip2uDERTeIaC9ilyWoDgRa8bWnj2DKUVlEAKK29\nK2cl7k3sejS9QNXW7b38ov3qb4uQK4tBy28rlUs2SpElNsMbO+RJOWxSuRqlWXER\nFD2alSmWB8ZB6ugHeOXsx5kKkNzDlS2wDKQJqZNWqga8LpSl+9lENrdi59qKuRgq\n053N5M/WLGJWyg8W2BWXMhZGCak1NcgPanQ/vFLO2mIljowb8mxtNML6rZfLawKp\nbFre03cZAgMBAAECggEAAJTwD4CfXu2kQc4M6cawvBmIeXTTnYaaRnf+Kfg1vh62\n6WcLaCLb3TqQbkGaMZrl4m+bJd4f6ODbAck+QOyqmgGtoMKp1ZmKwIKK1SN+Auv/\nsOw9h9MxDf01fLRvdAaxOR5Lr+MGGYeIZVzeVafMljAhutoauDwHCesoA5sAa+RP\nBzIa7+N6EmGt/FvAdKAvSuuZZsMUHLoOiHeB3knwjqoKJCHVMNWqpeMyqclIjR+O\nIv37jhlj2z7pbR0n6hfjYQLmGRfSRGvmw1hrDV1ije4RXeNs5/13gUokNf4kBhqn\nQ+t4eI6UEa82lgLS7Msmbcyyh2h2TfFG1Ygx6nYZHwKBgQDhUzdMjCtADBvQnSQw\nV+qWPzOJFdYzURgg1zMXUGnPws8vuUMjuCNEu3AUrtjvc5RVdePAIyN6o/j5HLAV\nt6qksoQkUas/daCzuRG9IWFw2eI0rhs+paMJVIUJQWXt60afgv61rsvLfIC/MBi9\ntl62xI8FNDWzPgSVWTXukIhOzwKBgQDK5p/3dr/S+oSk6E/y1bwejNm8b0VgqvwO\nP9OO2kmDEXTGSlXX5Mn1qW7Wg1n+z5NrDkA3IyRtEbILyylUELooGXVKiKPkiJpE\n+Qi+wsVqmThvqO6cYl8FW64/0UH88ZcvDjyDLfUsei4lY0hRjafTshaoqk0SOyq9\n4UOs3ioVlwKBgHYYtHoVWTHHZuivA+Gmopg+5dbqsArTbQ8BW5DTn7G5y/eaZRsa\njrmed/8PKTpPXKZyFH2GrTjBKmP+ajfnvLN3sRSMDXJER4cK78Yt8bFBMXMk8bii\n/dGND/Eq6q6JSsmd0bwNslijl6MdJUqBhCDM4pz6oU6hqatRR5gS/q43AoGBAIsp\nNGwQyS4V3mYQY80kpNq7NhdUpdvQSgIn6pzewG6hyVq63zes1oukQr3j5xSqH+zc\nIFTwyGn6KgiGtfjPZC5ej6CoKOh0fIJz33ies7ISFrAWyFj/6zYMlG12w3CN7mg6\ntmwuWCrCPeYsuwwcQRAj5ACYlTW82OrUlor48RpPAoGALtMf3SEALRuKvpSqDxpe\nw/XkD098Lq4g+uFbFfN0aL1gyuWvwQ4KtIkmMpENWYC/zFVH79AAWSA7gvEEWE0C\n3FP2lI29GgXPhG+EDS3/dvjY4UPcqDVMFYAen4Z4X0FnKa8Yr5rGPuYtZCsglGmh\nigkENMmOUL6T62YvJATeFd8=\n-----END PRIVATE KEY-----\n",
+  "client_email": "mcp-sheet-access@gen-lang-client-0998595520.iam.gserviceaccount.com",
+  "client_id": "104386077369721430122",
+  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
+  "token_uri": "https://oauth2.googleapis.com/token",
+  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
+  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/mcp-sheet-access%40gen-lang-client-0998595520.iam.gserviceaccount.com",
+  "universe_domain": "googleapis.com"
+}

package/lib/server.js

@@ -17,9 +17,6 @@ const getAgentVersion = () => {
     const json = require("../package.json");
     return json.version;
 };
-const selectedSheetContext = {
-  sheetName: null,
-};
 
 const createMcpServer = () => {
     const server = new mcp_js_1.McpServer({
@@ -149,7 +146,7 @@ const createMcpServer = () => {
       async () => {
         try {
           // Read file from config folder
-          const filePath = path.join(__dirname, 'config', 'app_context.txt');
+          const filePath = path.join(__dirname, 'lib', 'app_context.txt');
           const fileContent = await fs.readFile(filePath, 'utf-8');
 
           // Assuming each note is separated by a newline
@@ -278,29 +275,18 @@ const createMcpServer = () => {
     );
 
     tool(
-      "select_google_sheet",
-      "MUST be called after mobile_learn_current_app_context to set the Google Sheet name to be used by fetch_google_sheet_locators.",
+      "fetch_google_sheet_locators",
+      "MUST be invoked before mobile_learn_current_app_context. Provide the Google Sheet name to fetch locatorName and androidLocator from the specified sheet.",
       {
-        sheetName: { type: "string", description: "Name of the sheet/tab to fetch from" }
+        sheetName: {
+          type: "string",
+          description: "Exact name of the Google Sheets tab (sheet) to fetch data from.",
+          required: true,
+        },
       },
       async ({ sheetName }) => {
-        if (!sheetName) {
-          return "Error: sheetName is required.";
-        }
-        selectedSheetContext.sheetName = sheetName.trim();
-        return `Sheet name "${selectedSheetContext.sheetName}" saved. Now call fetch_google_sheet_locators to fetch data.`;
-      }
-    );
-
-    // Tool 2: fetch locator data using previously selected sheet name
-    tool(
-      "fetch_google_sheet_locators",
-      "MUST be called after select_google_sheet. Fetch locatorName and androidLocator from the sheet set by select_google_sheet. Please call select_google_sheet first.",
-      {},
-      async () => {
-        const sheetName = selectedSheetContext.sheetName;
-        if (!sheetName) {
-          return "Error: Sheet name not set. Please call select_google_sheet first.";
+        if (!sheetName || sheetName.trim() === "") {
+          return "Error: sheetName is required and cannot be empty.";
         }
 
         try {
@@ -308,7 +294,7 @@ const createMcpServer = () => {
           const path = require('path');
           const { google } = require('googleapis');
 
-          // Load credentials
+          // Adjust path to your config folder as needed
           const keyFile = path.join(__dirname, 'config', 'secret.json');
           const credentials = JSON.parse(await fs.readFile(keyFile, 'utf-8'));
 
@@ -329,12 +315,13 @@ const createMcpServer = () => {
             return `Sheet "${sheetName}" is empty or does not exist.`;
           }
 
-          const header = rows[0].map(h => h.toString().toLowerCase());
-          const locatorNameIdx = header.indexOf('locatorName');
-          const androidLocatorIdx = header.findIndex(h => h === 'android xpath' || h === 'androidLocator');
+          // Normalize header keys for safe case-insensitive lookup
+          const header = rows[0].map(h => h.toString().toLowerCase().trim());
+          const locatorNameIdx = header.indexOf('locator name');
+          const androidLocatorIdx = header.findIndex(h => h === 'android xpath' || h === 'android locator');
 
           if (locatorNameIdx === -1 || androidLocatorIdx === -1) {
-            return `Required columns "locatorName" and/or "androidXpath" not found in sheet "${sheetName}".`;
+            return `Required columns "locator name" and/or "android xpath" not found in sheet "${sheetName}".`;
           }
 
           const extracted = rows.slice(1)
@@ -351,6 +338,7 @@ const createMcpServer = () => {
       }
     );
 
+
     return server;
 };
 

package/package.json

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