@nbakka/mcp-appium 2.0.25 → 2.0.26

package/lib/server.js

@@ -141,27 +141,72 @@ const createMcpServer = () => {
 
     tool(
       "mobile_learn_current_app_context",
-      "Follow this instructions strictly to navigate through the app. This should be the first step after launching the app and before performing any tests.",
-      {},
-      async () => {
+      "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.",
+      {
+        sheetName: {
+          type: "string",
+          description: "Exact name of the Google Sheets tab (sheet) to fetch locator data from.",
+          // required by zod or MCP implicitly if needed
+        },
+      },
+      async ({ sheetName }) => {
         try {
-          // Read file from config folder
-          const filePath = path.join(__dirname, '', 'app_context.txt');
-          const fileContent = await fs.readFile(filePath, 'utf-8');
+          // Read app context notes from file
+          const notesFilePath = path.join(__dirname, 'app_context.txt');
+          const fileContent = await fs.readFile(notesFilePath, 'utf-8');
 
-          // Assuming each note is separated by a newline
-          // Trim to remove empty lines, filter out blank lines
           const notes = fileContent
             .split('\n')
             .map(line => line.trim())
             .filter(line => line.length > 0);
 
-          const context = { notes };
+          // Initialize response object
+          const context = { notes, locatorData: null };
+
+          if (sheetName && sheetName.trim() !== '') {
+            // Load Google Sheets credentials
+            const keyFile = path.join(__dirname, 'secret.json');
+            const credentials = JSON.parse(await fs.readFile(keyFile, 'utf-8'));
+
+            const auth = new google.auth.GoogleAuth({
+              credentials,
+              scopes: ['https://www.googleapis.com/auth/spreadsheets.readonly'],
+            });
+
+            const authClient = await auth.getClient();
+            const sheets = google.sheets({ version: 'v4', auth: authClient });
+            const spreadsheetId = '1UapR81AxaztDUlPGDV-_EwHo2hWXkKCZXl8ALsvIyxA';
+
+            const range = `${sheetName}!A1:Z1000`;
+            const res = await sheets.spreadsheets.values.get({ spreadsheetId, range });
+            const rows = res.data.values;
+
+            if (!rows || rows.length === 0) {
+              return `Sheet "${sheetName}" is empty or does not exist. Notes loaded: ${JSON.stringify(notes)}`;
+            }
+
+            // Normalize headers
+            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 "locator name" and/or "android xpath" not found in sheet "${sheetName}". Notes loaded: ${JSON.stringify(notes)}`;
+            }
+
+            const locatorData = rows.slice(1)
+              .filter(row => row[locatorNameIdx] && row[androidLocatorIdx])
+              .map(row => ({
+                locatorName: row[locatorNameIdx],
+                androidLocator: row[androidLocatorIdx],
+              }));
+
+            context.locatorData = locatorData;
+          }
 
           return `App context learned: ${JSON.stringify(context)}`;
         } catch (error) {
-          // Handle file read errors gracefully
-          return `Error reading app context notes: ${error.message}`;
+          return `Error reading app context notes or fetching locator data: ${error.message}`;
         }
       }
     );
@@ -274,71 +319,6 @@ const createMcpServer = () => {
       }
     );
 
-    tool(
-      "fetch_google_sheet_locators",
-      "Follow this instructions strictly. MUST be invoked after mobile_learn_current_app_context tool. Provide the Google Sheet name to fetch locatorName and androidLocator from the specified sheet.",
-      {
-        sheetName: {
-          type: "string",
-          description: "Exact name of the Google Sheets tab (sheet) to fetch data from.",
-          required: true,
-        },
-      },
-      async ({ sheetName }) => {
-        if (!sheetName || sheetName.trim() === "") {
-          return "Error: sheetName is required and cannot be empty.";
-        }
-
-        try {
-          const fs = require('fs').promises;
-          const path = require('path');
-          const { google } = require('googleapis');
-
-          // Adjust path to your config folder as needed
-          const keyFile = path.join(__dirname, '', 'secret.json');
-          const credentials = JSON.parse(await fs.readFile(keyFile, 'utf-8'));
-
-          const auth = new google.auth.GoogleAuth({
-            credentials,
-            scopes: ['https://www.googleapis.com/auth/spreadsheets.readonly'],
-          });
-
-          const authClient = await auth.getClient();
-          const sheets = google.sheets({ version: 'v4', auth: authClient });
-          const spreadsheetId = '1UapR81AxaztDUlPGDV-_EwHo2hWXkKCZXl8ALsvIyxA';
-
-          const range = `${sheetName}!A1:Z1000`;
-          const res = await sheets.spreadsheets.values.get({ spreadsheetId, range });
-          const rows = res.data.values;
-
-          if (!rows || rows.length === 0) {
-            return `Sheet "${sheetName}" is empty or does not exist.`;
-          }
-
-          // 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 "locator name" and/or "android xpath" not found in sheet "${sheetName}".`;
-          }
-
-          const extracted = rows.slice(1)
-            .filter(row => row[locatorNameIdx] && row[androidLocatorIdx])
-            .map(row => ({
-              locatorName: row[locatorNameIdx],
-              androidLocator: row[androidLocatorIdx],
-            }));
-
-          return extracted;
-        } catch (error) {
-          return `Error fetching data from Google Sheets: ${error.message}`;
-        }
-      }
-    );
-
-
     return server;
 };
 

package/package.json

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