@nbakka/mcp-appium 1.0.23 → 1.0.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbakka/mcp-appium",
-  "version": "1.0.23",
+  "version": "1.0.24",
   "description": "Selenium WebDriver MCP Server",
   "type": "module",
   "main": "src/lib/server.js",

package/src/lib/server.js

@@ -142,6 +142,72 @@ server.tool(
   }
 );
 
+// Get visible text elements including duplicates
+server.tool(
+  "get_visible_text_elements",
+  "Get all visible texts from screen XML including duplicates",
+  {},
+  async () => {
+    if (!state.sessionId) return { content: [{ type: "text", text: "No active session" }] };
+    try {
+      const response = await axios.get(`${APPIUM_URL}/session/${state.sessionId}/source`);
+      const xml = response.data;
+
+      const parsed = await parseStringPromise(xml, { explicitArray: false, mergeAttrs: true });
+
+      function collectTexts(node, texts = []) {
+        if (!node) return texts;
+
+        if (Array.isArray(node)) {
+          node.forEach(child => collectTexts(child, texts));
+          return texts;
+        }
+
+        if (node.text && node.text.trim() !== "") {
+          texts.push(node.text.trim());
+        }
+
+        if (node.node) collectTexts(node.node, texts);
+        else if (node.child) collectTexts(node.child, texts);
+        else {
+          for (const key in node) {
+            if (typeof node[key] === "object") {
+              collectTexts(node[key], texts);
+            }
+          }
+        }
+        return texts;
+      }
+
+      const allTexts = collectTexts(parsed);
+      return { content: [{ type: "json", json: allTexts }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error fetching or parsing XML: ${e.message}` }] };
+    }
+  }
+);
+
+// Click element by text with optional index (default 0)
+server.tool(
+  "click_by_text",
+  "Click element by visible text with optional index",
+  {
+    text: z.string(),
+    index: z.number().optional().default(0),
+  },
+  async ({ text, index }) => {
+    if (!state.sessionId) return { content: [{ type: "text", text: "No active session" }] };
+    try {
+      const xpath = `(//*[normalize-space(@text)='${text}'])[${index + 1}]`;
+      const findResp = await axios.post(`${APPIUM_URL}/session/${state.sessionId}/element`, { using: "xpath", value: xpath });
+      const elementId = extractElementId(findResp.data.value);
+      await axios.post(`${APPIUM_URL}/session/${state.sessionId}/element/${elementId}/click`);
+      return { content: [{ type: "text", text: `Clicked element with text: "${text}" at index ${index}` }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error clicking element: ${e.message}` }] };
+    }
+  }
+);