@nbakka/mcp-appium 1.0.28 → 2.0.1

package/src/lib/server.js

@@ -1,237 +0,0 @@
-#!/usr/bin/env node
-
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-import axios from "axios";
-import { exec } from "child_process";
-import { parseStringPromise } from "xml2js";
-
-
-const APPIUM_URL = "http://127.0.0.1:4723";  // Corrected endpoint for Appium 2.x
-
-const server = new McpServer({ name: "MCP Appium JSONWire", version: "1.0.0" });
-const state = { sessionId: null };
-
-// Helper to extract element ID
-function extractElementId(element) {
-  return element.ELEMENT || element["element-6066-11e4-a52e-4f735466cecf"];
-}
-
-function delay(ms) {
-  return new Promise(resolve => setTimeout(resolve, ms));
-}
-
-// Start Session tool
-server.tool(
-  "start_session",
-  "Start Appium session with capabilities",
-  {
-    capabilities: z.object({
-      platformName: z.string(),
-      udid: z.string(),
-      automationName: z.string(),
-      app: z.string().optional(),
-    }),
-  },
-  async ({ capabilities }) => {
-    try {
-      // Construct capabilities strictly with prefixes
-      const alwaysMatch = {
-        platformName: capabilities.platformName,
-        "appium:udid": capabilities.udid,
-        "appium:automationName": capabilities.automationName,
-      };
-      if (capabilities.app) {
-        alwaysMatch["appium:app"] = capabilities.app;
-      }
-
-      const payload = {
-        capabilities: {
-          firstMatch: [{}],
-          alwaysMatch,
-        },
-      };
-
-      const response = await axios.post(`${APPIUM_URL}/session`, payload);
-      state.sessionId = response.data.value.sessionId;
-      state.deviceId = capabilities.udid;
-      await delay(10000);
-      return { content: [{ type: "text", text: `Session started: ${state.sessionId}` }] };
-    } catch (e) {
-      return { content: [{ type: "text", text: `Error starting session: ${e.message}` }] };
-    }
-  }
-);
-
-
-// Tap tool
-server.tool(
-  "tap",
-  "Tap element by locator",
-  {
-    by: z.enum(["id", "accessibility id", "xpath", "class name", "name"]),
-    value: z.string(),
-  },
-  async ({ by, value }) => {
-    if (!state.sessionId) return { content: [{ type: "text", text: "No active session" }] };
-    try {
-      const findResp = await axios.post(`${APPIUM_URL}/session/${state.sessionId}/element`, { using: by, value });
-      const elementId = extractElementId(findResp.data.value);
-      await axios.post(`${APPIUM_URL}/session/${state.sessionId}/element/${elementId}/click`);
-      return { content: [{ type: "text", text: "Element tapped" }] };
-    } catch (e) {
-      return { content: [{ type: "text", text: `Error tapping element: ${e.message}` }] };
-    }
-  }
-);
-
-// Swipe tool
-server.tool(
-  "swipe",
-  "Swipe from start to end coordinates",
-  {
-    startX: z.number(),
-    startY: z.number(),
-    endX: z.number(),
-    endY: z.number(),
-    duration: z.number().optional(),
-  },
-  async ({ startX, startY, endX, endY, duration = 800 }) => {
-    if (!state.sessionId) return { content: [{ type: "text", text: "No active session" }] };
-    try {
-      const actions = [
-        { action: "press", options: { x: startX, y: startY } },
-        { action: "wait", options: { ms: duration } },
-        { action: "moveTo", options: { x: endX, y: endY } },
-        { action: "release", options: {} },
-      ];
-      await axios.post(`${APPIUM_URL}/session/${state.sessionId}/touch/perform`, { actions });
-      return { content: [{ type: "text", text: `Swiped from (${startX},${startY}) to (${endX},${endY})` }] };
-    } catch (e) {
-      return { content: [{ type: "text", text: `Error swiping: ${e.message}` }] };
-    }
-  }
-);
-
-// Open Deep Link
-server.tool(
-  "open_deep_link_adb",
-  "Open deep link on device via ADB shell",
-  {
-    deepLink: z.string(),
-  },
-  async ({ deepLink }) => {
-    if (!state.deviceId) {
-      return { content: [{ type: "text", text: "No connected device found" }] };
-    }
-
-    const command = `adb -s ${state.deviceId} shell am start -a android.intent.action.VIEW -d "${deepLink}"`;
-
-    return new Promise((resolve) => {
-      exec(command, (error, stdout, stderr) => {
-        if (error) {
-          resolve({ content: [{ type: "text", text: `Error executing ADB command: ${error.message}` }] });
-          return;
-        }
-        if (stderr) {
-          resolve({ content: [{ type: "text", text: `ADB stderr: ${stderr}` }] });
-          return;
-        }
-        resolve({ content: [{ type: "text", text: `Deep link opened via ADB: ${deepLink}` }] });
-      });
-    });
-  }
-);
-
-// Get visible text elements including duplicates
-server.tool(
-  "get_visible_text_elements",
-  "Get all visible texts from screen XML source 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;
-	console.log(response.data);
-      const parsed = await parseStringPromise(xml, { explicitArray: false, mergeAttrs: true });
-
-      function collectTextsFromXml(node, texts = []) {
-        if (!node) return texts;
-
-        // If array, recurse each element
-        if (Array.isArray(node)) {
-          node.forEach(child => collectTextsFromXml(child, texts));
-          return texts;
-        }
-
-        // If node has 'text' attribute with non-empty value, collect it
-        if (node.text && node.text.trim() !== "") {
-          texts.push(node.text.trim());
-        }
-
-        // Recurse into all children nodes
-        for (const key in node) {
-          if (key !== "text" && typeof node[key] === "object") {
-            collectTextsFromXml(node[key], texts);
-          }
-        }
-        return texts;
-      }
-
-      const allTexts = collectTextsFromXml(parsed);
-      return { content: [{ type: "json", json: allTexts }] };
-    } catch (e) {
-      return { content: [{ type: "text", text: `Error fetching or parsing source 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}` }] };
-    }
-  }
-);
-
-
-
-
-
-// Close Session tool
-server.tool(
-  "close_session",
-  "Close the current Appium session",
-  {},
-  async () => {
-    if (!state.sessionId) return { content: [{ type: "text", text: "No active session" }] };
-    try {
-      await axios.delete(`${APPIUM_URL}/session/${state.sessionId}`);
-      const oldSession = state.sessionId;
-      state.sessionId = null;
-      return { content: [{ type: "text", text: `Session ${oldSession} closed` }] };
-    } catch (e) {
-      return { content: [{ type: "text", text: `Error closing session: ${e.message}` }] };
-    }
-  }
-);
-
-// Connect MCP server to stdio
-const transport = new StdioServerTransport();
-await server.connect(transport);