@nbakka/mcp-appium 3.0.21 → 3.0.23

package/lib/app_context.txt

@@ -2,8 +2,9 @@
 Use mobile-mcp.
 Navigate and explore the Housing app using the provided deeplink to validate, refine, and update the existing rough test scenarios.
 If the app cannot be navigated for a certain scenario (e.g., UI element not reachable, deeplink not loading, or navigation gets stuck), then generate the test cases based on the partial understanding achieved + standard expected Housing app behavior.
-
-Rewrite every rough test case into clean, modernized test cases using this structure:
+Don't generate new test cases beyond the provided rough scenarios.
+Only modify test scenarios if there are discrepancies found during exploration.
+Each test case should be detailed and structured as per the format below.
 
 /**
  * TEST CASE <number>:
@@ -22,16 +23,6 @@ Rewrite every rough test case into clean, modernized test cases using this struc
  *   - <expected result 2>
  */
 
-Rules:
-- Clean up, merge, and modernize outdated or rough test cases.
-- Explore using mobile-mcp to verify flows and correct missing details.
-- Always specify the exact order of UI elements (icons, tabs, instant links, buttons).
-- When describing interactions, mention expected user-visible behavior (UI change, navigation, toggles, dialogs).
-- If navigation is not fully possible, infer expected behavior and generate the most accurate test cases.
-- Output only the test case blocks in the above format.
-- Final output must be suitable for aicode.txt.
-
-
 ==========================
 EXAMPLE (follow EXACT style)
 ==========================

package/lib/server.js

@@ -215,6 +215,127 @@ const createMcpServer = () => {
 //   }
 // );
 
+// Tool 1: Fetch incomplete test case
+tool(
+  "mobile_fetch_incomplete_testcase",
+  "Fetches the first test case from a Google Sheet that has blank test steps but has a value in 'UT v/s Automation' column. Returns the test scenario and row number for later update.",
+  {
+    sheetName: zod_1.z.string().describe("The name of the Google Sheet tab to fetch test case data from").default("TestCases"),
+  },
+  async ({ sheetName }) => {
+    try {
+      // Load Google Sheets credentials
+      const keyFile = path.join(os.homedir(), 'Desktop', 'secret.json');
+
+      const auth = new google.auth.GoogleAuth({
+        keyFile,
+        scopes: ['https://www.googleapis.com/auth/spreadsheets.readonly'],
+      });
+
+      const authClient = await auth.getClient();
+      const sheets = google.sheets({ version: 'v4', auth: authClient });
+      const spreadsheetId = '1jAilVUeQW99JUYj1KL4jovoxeWGUnsIcY_nMJR5H6dc';
+
+      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.`;
+      }
+
+      // Map headers (trimmed, case-sensitive)
+      const header = rows[0].map(h => h.toString().trim());
+
+      // Find required column indices
+      const testCasesIdx = header.indexOf('Testcases');
+      const testStepsIdx = header.indexOf('Test Steps');
+      const utVsAutomationIdx = header.indexOf('UT v/s Automation');
+
+      if (testCasesIdx === -1 || testStepsIdx === -1 || utVsAutomationIdx === -1) {
+        return `Required columns "Testcases", "Test Steps", and/or "UT v/s Automation" not found in sheet "${sheetName}". Available columns: ${header.join(', ')}`;
+      }
+
+      // Find first row with empty test steps and non-empty UT v/s Automation
+      for (let i = 1; i < rows.length; i++) {
+        const row = rows[i];
+        const testSteps = row[testStepsIdx] ? row[testStepsIdx].toString().trim() : '';
+        const utVsAutomation = row[utVsAutomationIdx] ? row[utVsAutomationIdx].toString().trim() : '';
+        const testScenario = row[testCasesIdx] ? row[testCasesIdx].toString().trim() : '';
+
+        // Check if test steps are empty, UT v/s Automation is not empty, and test scenario exists
+        if (!testSteps && utVsAutomation && testScenario) {
+          // Convert column index to letter (A, B, C, etc.)
+          const columnLetter = String.fromCharCode(65 + testStepsIdx);
+          const rowNumber = i + 1; // +1 because spreadsheet rows are 1-indexed
+
+          return JSON.stringify({
+            testScenario: testScenario,
+            sheetName: sheetName,
+            rowNumber: rowNumber,
+            columnLetter: columnLetter,
+            cellReference: `${columnLetter}${rowNumber}`
+          });
+        }
+      }
+
+      return `No test cases found with blank test steps and non-empty "UT v/s Automation" in sheet "${sheetName}".`;
+
+    } catch (error) {
+      return `Error fetching incomplete test case: ${error.message}`;
+    }
+  }
+);
+
+// Tool 2: Update Test Steps
+tool(
+  "mobile_update_test_steps",
+  "Updates the Test Steps cell in Google Sheet for a specific test case. Use the sheetName, rowNumber, and columnLetter obtained from mobile_fetch_incomplete_testcase tool.",
+  {
+    sheetName: zod_1.z.string().describe("The name of the Google Sheet tab"),
+    rowNumber: zod_1.z.number().describe("The row number to update (from fetch tool)"),
+    columnLetter: zod_1.z.string().describe("The column letter for Test Steps (from fetch tool)"),
+    testSteps: zod_1.z.string().describe("The test steps content to write into the cell"),
+  },
+  async ({ sheetName, rowNumber, columnLetter, testSteps }) => {
+    try {
+      // Load Google Sheets credentials with write permissions
+      const keyFile = path.join(os.homedir(), 'Desktop', 'secret.json');
+
+      const auth = new google.auth.GoogleAuth({
+        keyFile,
+        scopes: ['https://www.googleapis.com/auth/spreadsheets'], // Full read/write access
+      });
+
+      const authClient = await auth.getClient();
+      const sheets = google.sheets({ version: 'v4', auth: authClient });
+      const spreadsheetId = '1jAilVUeQW99JUYj1KL4jovoxeWGUnsIcY_nMJR5H6dc';
+
+      // Construct the cell reference (e.g., "TestCases!C5")
+      const cellReference = `${sheetName}!${columnLetter}${rowNumber}`;
+
+      // Update the cell
+      const updateRes = await sheets.spreadsheets.values.update({
+        spreadsheetId,
+        range: cellReference,
+        valueInputOption: 'RAW',
+        resource: {
+          values: [[testSteps]]
+        }
+      });
+
+      if (updateRes.status === 200) {
+        return `Successfully updated Test Steps at ${cellReference} with content: "${testSteps.substring(0, 100)}${testSteps.length > 100 ? '...' : ''}"`;
+      } else {
+        return `Failed to update Test Steps. Status: ${updateRes.status}`;
+      }
+
+    } catch (error) {
+      return `Error updating test steps: ${error.message}`;
+    }
+  }
+);
+
  tool(
    "mobile_learn_testcases_generation_context",
    "Reads previously saved app context notes and returns them so they can be used to validate or update test cases. This should be executed before generating manual test cases.",

package/package.json

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