@nbakka/mcp-appium 2.0.0 → 2.0.2

package/lib/server.js

@@ -14,6 +14,7 @@ const getAgentVersion = () => {
     const json = require("../package.json");
     return json.version;
 };
+
 const getLatestAgentVersion = async () => {
     const response = await fetch("https://api.github.com/repos/mobile-next/mobile-mcp/tags?per_page=1");
     const json = await response.json();
@@ -146,11 +147,10 @@ tool("mobile_click_on_element_by_text", "Click on the screen element identified
 }, async ({ text }) => {
     requireRobot();
     const xpath = `//*[@text="${text}"]`;
-    const element = await robot.findElementByXPath(xpath);
+    const element = await robot.clickByXPath(xpath);
     if (!element) {
         throw new Error(`Element with text "${text}" not found`);
     }
-    await element.click();
     // Wait for 2 seconds after click
     await new Promise(resolve => setTimeout(resolve, 2000));
     return `Clicked on element with text: "${text}"`;
@@ -219,8 +219,89 @@ await new Promise(resolve => setTimeout(resolve, 5000));
         const orientation = await robot.getOrientation();
         return `Current device orientation is ${orientation}`;
     });
+tool(
+  "mobile_create_session",
+  "create a mobile session once so that session id can be used in other tools where it is needed",
+  {},
+  async () => {
+    const capabilities = {
+      platformName: "Android",
+      "appium:udid": "emulator-5554",
+      "appium:automationName": "UiAutomator2",
+      "appium:noReset": true,
+      "appium:appPackage": "com.locon.housing",
+      "appium:appActivity": "com.locon.housing.presentation.MainActivity",
+    };
+
+    const payload = {
+      capabilities: {
+        firstMatch: [{}],
+        alwaysMatch: capabilities,
+      },
+    };
+
+    const response = await fetch("http://localhost:4723/session", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload),
+    });
+
+    if (!response.ok) {
+      throw new Error(`Failed to create session: ${response.statusText}`);
+    }
+
+    const json = await response.json();
+    return `Session created with sessionId: ${json.sessionId}`;
+  }
+);
+
+
+tool(
+  "mobile_click_using_xpath",
+  "Click an element identified by text using path",
+  {
+    sessionId: zod_1.z.string().describe("Appium session ID"),
+    text: zod_1.z.string().describe("Visible text of the element to click"),
+  },
+  async ({ sessionId, text }) => {
+    const xpath = `//*[@text="${text}"]`;
+    const clickUrl = `http://localhost:4723/session/${sessionId}/element`;
+
+    // Find element
+    const findResponse = await fetch(clickUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ using: "xpath", value: xpath }),
+    });
+
+    if (!findResponse.ok) {
+      throw new Error(`Failed to find element: ${findResponse.statusText}`);
+    }
+
+    const findJson = await findResponse.json();
+    if (!findJson.value || !findJson.value.elementId) {
+      throw new Error(`Element with text "${text}" not found`);
+    }
+
+    const elementId = findJson.value.elementId;
+
+    // Click element
+    const clickElementUrl = `http://localhost:4723/session/${sessionId}/element/${elementId}/click`;
+    const clickResponse = await fetch(clickElementUrl, { method: "POST" });
+
+    if (!clickResponse.ok) {
+      throw new Error(`Failed to click element: ${clickResponse.statusText}`);
+    }
+
+    // Optional wait after click
+    await new Promise((resolve) => setTimeout(resolve, 2000));
+
+    return `Clicked on element with text: "${text}" in session: ${sessionId}`;
+  }
+);
     // async check for latest agent version
     checkForLatestAgentVersion().then();
     return server;
 };
+
 exports.createMcpServer = createMcpServer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbakka/mcp-appium",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Appium MCP",
   "engines": {
     "node": ">=18"
@@ -43,7 +43,7 @@
   },
   "main": "index.js",
   "bin": {
-    "mcp-server-mobile": "lib/index.js"
+    "mcp-appium": "lib/index.js"
   },
   "directories": {
     "lib": "lib"