@nbakka/mcp-appium 4.0.6 → 4.0.8

package/lib/android.js

@@ -249,11 +249,24 @@ class AndroidRobot {
         const elements = this.collectElements(hierarchy.node);
         return elements;
     }
+    parseBounds(bounds) {
+        if (!bounds) return { x: 0, y: 0 };
+        const match = bounds.match(/\[(\d+),(\d+)\]/);
+        if (!match) return { x: 0, y: 0 };
+        return { x: parseInt(match[1]), y: parseInt(match[2]) };
+    }
     async getSimplifiedElements() {
         const parsedXml = await this.getUiAutomatorXml();
         const hierarchy = parsedXml.hierarchy;
         const elements = this.collectSimplifiedElements(hierarchy.node);
-        return elements;
+        
+        // Sort by visual position: top-to-bottom, left-to-right
+        return elements.sort((a, b) => {
+            const rectA = this.parseBounds(a.bounds);
+            const rectB = this.parseBounds(b.bounds);
+            if (rectA.y !== rectB.y) return rectA.y - rectB.y;
+            return rectA.x - rectB.x;
+        });
     }
     async terminateApp(packageName) {
         this.adb("shell", "am", "force-stop", packageName);

package/lib/server.js

@@ -213,6 +213,12 @@ These are mandatory requirements - not suggestions.`;
   }
 );
 
+ tool("debug_dump_xml_structure", "DEBUG: Dump the raw parsed XML structure to see how fast-xml-parser creates the object", {}, async ({}) => {
+     requireRobot();
+     const structure = await robot.getXmlStructure();
+     return `Raw XML structure: ${JSON.stringify(structure, null, 2)}`;
+ });
+
  tool("mobile_list_elements_on_screen", "List elements on screen in a simplified, flattened structure. Returns only useful attributes: text, class, id (resource-id), accessibilityId (content-desc), and bounds. Do not cache this result.", {}, async ({}) => {
      requireRobot();
      const elements = await robot.getSimplifiedElements();

package/package.json

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