@mobilenext/mobile-mcp 0.0.27 → 0.0.29

package/README.md

@@ -25,8 +25,11 @@ This server allows Agents and LLMs to interact with native iOS/Android applicati
 </h4>
 
 <h4 align="center">
+  <a href="https://github.com/mobile-next/mobile-mcp/wiki">
+    <img src="https://img.shields.io/badge/documentation-wiki-blue" alt="wiki" />
+  </a>
   <a href="http://mobilenexthq.com/join-slack">
-    <img src="https://img.shields.io/badge/join-Slack-blueviolet?logo=slack&style=flat" alt="Slack community channel" />
+    <img src="https://img.shields.io/badge/join-Slack-blueviolet?logo=slack&style=flat" alt="join on Slack" />
   </a>
 </h4>
 
@@ -102,6 +105,12 @@ Setup our MCP with Cline, Cursor, Claude, VS Code, Github Copilot:
 claude mcp add mobile -- npx -y @mobilenext/mobile-mcp@latest
 ```
 
+[Gemini CLI:](https://cloud.google.com/gemini/docs/codeassist/gemini-cli)
+
+```
+gemini mcp add mobile npx -y @mobilenext/mobile-mcp@latest
+```
+
 [Read more in our wiki](https://github.com/mobile-next/mobile-mcp/wiki)! 🚀
 
 

package/lib/android.js

@@ -336,122 +336,6 @@ class AndroidRobot {
         const rotation = this.adb("shell", "settings", "get", "system", "user_rotation").toString().trim();
         return rotation === "0" ? "portrait" : "landscape";
     }
-    async getDeviceLogs(options) {
-        const timeWindow = options?.timeWindow || "1m";
-        const filter = options?.filter;
-        const processFilter = options?.process;
-        let packageFilter = null;
-        let searchQuery = null;
-        let effectiveFilter = filter;
-        // For Android: if both process and filter are provided, combine them as "package:<process> <filter>"
-        if (processFilter && filter && !filter.includes("package:")) {
-            effectiveFilter = `package:${processFilter} ${filter}`;
-        }
-        else if (processFilter && !filter) {
-            effectiveFilter = `package:${processFilter}`;
-        }
-        // Handle Android package filtering syntax
-        if (effectiveFilter) {
-            if (effectiveFilter.startsWith("package:mine")) {
-                // Filter to user apps only
-                const query = effectiveFilter.replace("package:mine", "").trim();
-                searchQuery = query || null;
-                // Will filter user packages in post-processing
-            }
-            else if (effectiveFilter.includes("package:")) {
-                // Handle specific package filters like package:com.example.app search_term
-                const packageMatch = effectiveFilter.match(/package:([^\s]+)(?:\s+(.+))?/);
-                if (packageMatch) {
-                    packageFilter = packageMatch[1];
-                    searchQuery = packageMatch[2] || null;
-                }
-            }
-            else {
-                // Regular search filter
-                searchQuery = effectiveFilter;
-            }
-        }
-        const args = ["shell", "logcat"];
-        if (timeWindow) {
-            // Calculate timestamp for time-based filtering using -T
-            const timeInSeconds = this.parseTimeWindow(timeWindow);
-            const startTime = new Date(Date.now() - (timeInSeconds * 1000));
-            // Format as MM-dd HH:mm:ss.mmm
-            const month = String(startTime.getMonth() + 1).padStart(2, "0");
-            const day = String(startTime.getDate()).padStart(2, "0");
-            const hours = String(startTime.getHours()).padStart(2, "0");
-            const minutes = String(startTime.getMinutes()).padStart(2, "0");
-            const seconds = String(startTime.getSeconds()).padStart(2, "0");
-            const milliseconds = String(startTime.getMilliseconds()).padStart(3, "0");
-            const timeFormat = `${month}-${day} ${hours}:${minutes}:${seconds}.${milliseconds}`;
-            args.push("-T", timeFormat);
-        }
-        else {
-            args.push("-d");
-        }
-        // Add package filtering directly to logcat if we have a specific package
-        if (packageFilter && packageFilter !== "mine") {
-            // Use logcat's native package filtering with --pid
-            try {
-                // First get the PID(s) for this package
-                const pidOutput = this.adb("shell", "pidof", packageFilter).toString().trim();
-                if (pidOutput) {
-                    const pids = pidOutput.split(/\s+/);
-                    for (const pid of pids) {
-                        args.push("--pid", pid);
-                    }
-                }
-            }
-            catch (error) {
-                // If pidof fails, fall back to post-processing
-            }
-        }
-        const output = this.adb(...args).toString();
-        // Post-process filtering
-        const lines = output.split("\n").filter(line => line.trim());
-        let filteredLines = lines;
-        // Filter by specific package if provided (fallback if --pid didn't work)
-        if (packageFilter && packageFilter !== "mine") {
-            filteredLines = filteredLines.filter(line => {
-                return line.includes(packageFilter);
-            });
-        }
-        // Filter for user packages if package:mine
-        if (filter && filter.startsWith("package:mine")) {
-            filteredLines = filteredLines.filter(line => {
-                // Look for user app indicators - avoid system/Android logs
-                return !line.includes("com.android.") &&
-                    !line.includes("android.") &&
-                    !line.includes("system_") &&
-                    (line.includes("com.") || line.includes("io.") || line.includes("net.") || line.includes("app."));
-            });
-        }
-        // Apply text search if provided
-        if (searchQuery) {
-            filteredLines = filteredLines.filter(line => {
-                return line.toLowerCase().includes(searchQuery.toLowerCase());
-            });
-        }
-        return filteredLines.join("\n");
-    }
-    parseTimeWindow(timeWindow) {
-        const match = timeWindow.match(/^(\d+)([smh])$/);
-        if (!match) {
-            return 60;
-        }
-        const value = parseInt(match[1], 10);
-        const unit = match[2];
-        switch (unit) {
-            case "s":
-                return value;
-            case "m":
-                return value * 60;
-            case "h":
-                return value * 3600;
-            default:
-                return 60;
-        }
-    }
     async getUiAutomatorDump() {
         for (let tries = 0; tries < 10; tries++) {
             const dump = this.adb("exec-out", "uiautomator", "dump", "/dev/tty").toString();

package/lib/ios.js

@@ -145,42 +145,6 @@ class IosRobot {
         const wda = await this.wda();
         return await wda.getOrientation();
     }
-    async getDeviceLogs(options) {
-        await this.assertTunnelRunning();
-        const timeWindow = options?.timeWindow || "1m";
-        const filter = options?.filter;
-        const args = ["syslog"];
-        if (timeWindow) {
-            const timeInSeconds = this.parseTimeWindow(timeWindow);
-            args.push("--since");
-            args.push(`${timeInSeconds}s`);
-        }
-        let output = await this.ios(...args);
-        if (filter) {
-            const lines = output.split("\n");
-            const filteredLines = lines.filter(line => line.toLowerCase().includes(filter.toLowerCase()));
-            output = filteredLines.join("\n");
-        }
-        return output;
-    }
-    parseTimeWindow(timeWindow) {
-        const match = timeWindow.match(/^(\d+)([smh])$/);
-        if (!match) {
-            return 60;
-        }
-        const value = parseInt(match[1], 10);
-        const unit = match[2];
-        switch (unit) {
-            case "s":
-                return value;
-            case "m":
-                return value * 60;
-            case "h":
-                return value * 3600;
-            default:
-                return 60;
-        }
-    }
 }
 exports.IosRobot = IosRobot;
 class IosManager {

package/lib/iphone-simulator.js

@@ -124,64 +124,6 @@ class Simctl {
         const wda = await this.wda();
         return wda.getOrientation();
     }
-    async getDeviceLogs(options) {
-        const timeWindow = options?.timeWindow || "1m";
-        const filter = options?.filter;
-        const processFilter = options?.process;
-        const deviceUuid = this.simulatorUuid;
-        let predicate = "";
-        let currentApp = null;
-        // If a specific process is provided, use that
-        if (processFilter) {
-            currentApp = processFilter;
-            predicate = `subsystem == "${processFilter}"`;
-        }
-        else {
-            // Try to detect currently running user apps from installed apps
-            try {
-                const runningApps = await this.listApps();
-                // Filter to non-Apple user apps
-                const userApps = runningApps
-                    .map((app) => app.packageName)
-                    .filter((appId) => !appId.startsWith("com.apple.") && appId.includes("."));
-                if (userApps.length > 0) {
-                    // For now, just use the first user app found
-                    // In the future, we could try to detect which is actually running
-                    currentApp = userApps[0];
-                    predicate = `subsystem == "${currentApp}"`;
-                }
-            }
-            catch (error) {
-                // Failed to get apps, continue with fallback
-            }
-            // If no user app detected, use broader filter for non-Apple apps
-            if (!predicate) {
-                predicate = "subsystem CONTAINS \"com.\" AND NOT subsystem BEGINSWITH \"com.apple.\"";
-            }
-        }
-        if (filter) {
-            predicate += ` AND composedMessage CONTAINS[c] "${filter}"`;
-        }
-        const args = [
-            "spawn", deviceUuid, "log", "show",
-            "--last", timeWindow,
-            "--predicate", predicate,
-            "--info",
-            "--debug"
-        ];
-        try {
-            const logs = this.simctl(...args).toString();
-            const appInfo = currentApp ? ` (focused on: ${currentApp})` : " (all non-Apple apps)";
-            const debugInfo = `DEBUG: Using predicate: ${predicate}${appInfo}\n\n`;
-            return `${debugInfo}${logs}`;
-        }
-        catch (error) {
-            if (error instanceof Error && error.message.includes("No logging subsystem")) {
-                return "No logs found for the current running applications.";
-            }
-            throw error;
-        }
-    }
 }
 exports.Simctl = Simctl;
 class SimctlManager {

package/lib/server.js

@@ -111,44 +111,30 @@ const createMcpServer = () => {
         }
     };
     posthog("launch", {}).then();
-    let robot;
     const simulatorManager = new iphone_simulator_1.SimctlManager();
-    const requireRobot = () => {
-        if (!robot) {
-            throw new robot_1.ActionableError("No device selected. Use the mobile_use_device tool to select a device.");
-        }
-    };
-    tool("mobile_use_default_device", "Use the default device. This is a shortcut for mobile_use_device with deviceType=simulator and device=simulator_name", {
-        noParams
-    }, async () => {
+    const getRobotFromDevice = (device) => {
         const iosManager = new ios_1.IosManager();
         const androidManager = new android_1.AndroidDeviceManager();
         const simulators = simulatorManager.listBootedSimulators();
         const androidDevices = androidManager.getConnectedDevices();
         const iosDevices = iosManager.listDevices();
-        const sum = simulators.length + androidDevices.length + iosDevices.length;
-        if (sum === 0) {
-            throw new robot_1.ActionableError("No devices found. Please connect a device and try again.");
-        }
-        else if (sum >= 2) {
-            throw new robot_1.ActionableError("Multiple devices found. Please use the mobile_list_available_devices tool to list available devices and select one.");
-        }
-        // only one device connected, let's find it now
-        if (simulators.length === 1) {
-            robot = simulatorManager.getSimulator(simulators[0].name);
-            return `Selected default device: ${simulators[0].name}`;
+        // Check if it's a simulator
+        const simulator = simulators.find(s => s.name === device);
+        if (simulator) {
+            return simulatorManager.getSimulator(device);
         }
-        else if (androidDevices.length === 1) {
-            robot = new android_1.AndroidRobot(androidDevices[0].deviceId);
-            return `Selected default device: ${androidDevices[0].deviceId}`;
+        // Check if it's an Android device
+        const androidDevice = androidDevices.find(d => d.deviceId === device);
+        if (androidDevice) {
+            return new android_1.AndroidRobot(device);
         }
-        else if (iosDevices.length === 1) {
-            robot = new ios_1.IosRobot(iosDevices[0].deviceId);
-            return `Selected default device: ${iosDevices[0].deviceId}`;
+        // Check if it's an iOS device
+        const iosDevice = iosDevices.find(d => d.deviceId === device);
+        if (iosDevice) {
+            return new ios_1.IosRobot(device);
         }
-        // how did this happen?
-        throw new robot_1.ActionableError("No device selected. Please use the mobile_list_available_devices tool to list available devices and select one.");
-    });
+        throw new robot_1.ActionableError(`Device "${device}" not found. Use the mobile_list_available_devices tool to see available devices.`);
+    };
     tool("mobile_list_available_devices", "List all available devices. This includes both physical devices and simulators. If there is more than one device returned, you need to let the user select one of them.", {
         noParams
     }, async ({}) => {
@@ -176,71 +162,58 @@ const createMcpServer = () => {
         }
         return resp.join("\n");
     });
-    tool("mobile_use_device", "Select a device to use. This can be a simulator or an Android device. Use the list_available_devices tool to get a list of available devices.", {
-        device: zod_1.z.string().describe("The name of the device to select"),
-        deviceType: zod_1.z.enum(["simulator", "ios", "android"]).describe("The type of device to select"),
-    }, async ({ device, deviceType }) => {
-        switch (deviceType) {
-            case "simulator":
-                robot = simulatorManager.getSimulator(device);
-                break;
-            case "ios":
-                robot = new ios_1.IosRobot(device);
-                break;
-            case "android":
-                robot = new android_1.AndroidRobot(device);
-                break;
-        }
-        return `Selected device: ${device}`;
-    });
     tool("mobile_list_apps", "List all the installed apps on the device", {
-        noParams
-    }, async ({}) => {
-        requireRobot();
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you.")
+    }, async ({ device }) => {
+        const robot = getRobotFromDevice(device);
         const result = await robot.listApps();
         return `Found these apps on device: ${result.map(app => `${app.appName} (${app.packageName})`).join(", ")}`;
     });
     tool("mobile_launch_app", "Launch an app on mobile device. Use this to open a specific app. You can find the package name of the app by calling list_apps_on_device.", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         packageName: zod_1.z.string().describe("The package name of the app to launch"),
-    }, async ({ packageName }) => {
-        requireRobot();
+    }, async ({ device, packageName }) => {
+        const robot = getRobotFromDevice(device);
         await robot.launchApp(packageName);
         return `Launched app ${packageName}`;
     });
     tool("mobile_terminate_app", "Stop and terminate an app on mobile device", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         packageName: zod_1.z.string().describe("The package name of the app to terminate"),
-    }, async ({ packageName }) => {
-        requireRobot();
+    }, async ({ device, packageName }) => {
+        const robot = getRobotFromDevice(device);
         await robot.terminateApp(packageName);
         return `Terminated app ${packageName}`;
     });
     tool("mobile_get_screen_size", "Get the screen size of the mobile device in pixels", {
-        noParams
-    }, async ({}) => {
-        requireRobot();
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you.")
+    }, async ({ device }) => {
+        const robot = getRobotFromDevice(device);
         const screenSize = await robot.getScreenSize();
         return `Screen size is ${screenSize.width}x${screenSize.height} pixels`;
     });
     tool("mobile_click_on_screen_at_coordinates", "Click on the screen at given x,y coordinates. If clicking on an element, use the list_elements_on_screen tool to find the coordinates.", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         x: zod_1.z.number().describe("The x coordinate to click on the screen, in pixels"),
         y: zod_1.z.number().describe("The y coordinate to click on the screen, in pixels"),
-    }, async ({ x, y }) => {
-        requireRobot();
+    }, async ({ device, x, y }) => {
+        const robot = getRobotFromDevice(device);
         await robot.tap(x, y);
         return `Clicked on screen at coordinates: ${x}, ${y}`;
     });
     tool("mobile_long_press_on_screen_at_coordinates", "Long press on the screen at given x,y coordinates. If long pressing on an element, use the list_elements_on_screen tool to find the coordinates.", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         x: zod_1.z.number().describe("The x coordinate to long press on the screen, in pixels"),
         y: zod_1.z.number().describe("The y coordinate to long press on the screen, in pixels"),
-    }, async ({ x, y }) => {
-        requireRobot();
+    }, async ({ device, x, y }) => {
+        const robot = getRobotFromDevice(device);
         await robot.longPress(x, y);
         return `Long pressed on screen at coordinates: ${x}, ${y}`;
     });
     tool("mobile_list_elements_on_screen", "List elements on screen and their coordinates, with display text or accessibility label. Do not cache this result.", {
-        noParams
-    }, async ({}) => {
-        requireRobot();
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you.")
+    }, async ({ device }) => {
+        const robot = getRobotFromDevice(device);
         const elements = await robot.getElementsOnScreen();
         const result = elements.map(element => {
             const out = {
@@ -265,26 +238,29 @@ const createMcpServer = () => {
         return `Found these elements on screen: ${JSON.stringify(result)}`;
     });
     tool("mobile_press_button", "Press a button on device", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         button: zod_1.z.string().describe("The button to press. Supported buttons: BACK (android only), HOME, VOLUME_UP, VOLUME_DOWN, ENTER, DPAD_CENTER (android tv only), DPAD_UP (android tv only), DPAD_DOWN (android tv only), DPAD_LEFT (android tv only), DPAD_RIGHT (android tv only)"),
-    }, async ({ button }) => {
-        requireRobot();
+    }, async ({ device, button }) => {
+        const robot = getRobotFromDevice(device);
         await robot.pressButton(button);
         return `Pressed the button: ${button}`;
     });
     tool("mobile_open_url", "Open a URL in browser on device", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         url: zod_1.z.string().describe("The URL to open"),
-    }, async ({ url }) => {
-        requireRobot();
+    }, async ({ device, url }) => {
+        const robot = getRobotFromDevice(device);
         await robot.openUrl(url);
         return `Opened URL: ${url}`;
     });
-    tool("swipe_on_screen", "Swipe on the screen", {
+    tool("mobile_swipe_on_screen", "Swipe on the screen", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         direction: zod_1.z.enum(["up", "down", "left", "right"]).describe("The direction to swipe"),
         x: zod_1.z.number().optional().describe("The x coordinate to start the swipe from, in pixels. If not provided, uses center of screen"),
         y: zod_1.z.number().optional().describe("The y coordinate to start the swipe from, in pixels. If not provided, uses center of screen"),
         distance: zod_1.z.number().optional().describe("The distance to swipe in pixels. Defaults to 400 pixels for iOS or 30% of screen dimension for Android"),
-    }, async ({ direction, x, y, distance }) => {
-        requireRobot();
+    }, async ({ device, direction, x, y, distance }) => {
+        const robot = getRobotFromDevice(device);
         if (x !== undefined && y !== undefined) {
             // Use coordinate-based swipe
             await robot.swipeFromCoordinate(x, y, direction, distance);
@@ -298,10 +274,11 @@ const createMcpServer = () => {
         }
     });
     tool("mobile_type_keys", "Type text into the focused element", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         text: zod_1.z.string().describe("The text to type"),
         submit: zod_1.z.boolean().describe("Whether to submit the text. If true, the text will be submitted as if the user pressed the enter key."),
-    }, async ({ text, submit }) => {
-        requireRobot();
+    }, async ({ device, text, submit }) => {
+        const robot = getRobotFromDevice(device);
         await robot.sendKeys(text);
         if (submit) {
             await robot.pressButton("ENTER");
@@ -309,18 +286,19 @@ const createMcpServer = () => {
         return `Typed text: ${text}`;
     });
     tool("mobile_save_screenshot", "Save a screenshot of the mobile device to a file", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         saveTo: zod_1.z.string().describe("The path to save the screenshot to"),
-    }, async ({ saveTo }) => {
-        requireRobot();
+    }, async ({ device, saveTo }) => {
+        const robot = getRobotFromDevice(device);
         const screenshot = await robot.getScreenshot();
         node_fs_1.default.writeFileSync(saveTo, screenshot);
         return `Screenshot saved to: ${saveTo}`;
     });
     server.tool("mobile_take_screenshot", "Take a screenshot of the mobile device. Use this to understand what's on screen, if you need to press an element that is available through view hierarchy then you must list elements on screen instead. Do not cache this result.", {
-        noParams
-    }, async ({}) => {
-        requireRobot();
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you.")
+    }, async ({ device }) => {
         try {
+            const robot = getRobotFromDevice(device);
             const screenSize = await robot.getScreenSize();
             let screenshot = await robot.getScreenshot();
             let mimeType = "image/png";
@@ -356,38 +334,20 @@ const createMcpServer = () => {
         }
     });
     tool("mobile_set_orientation", "Change the screen orientation of the device", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         orientation: zod_1.z.enum(["portrait", "landscape"]).describe("The desired orientation"),
-    }, async ({ orientation }) => {
-        requireRobot();
+    }, async ({ device, orientation }) => {
+        const robot = getRobotFromDevice(device);
         await robot.setOrientation(orientation);
         return `Changed device orientation to ${orientation}`;
     });
     tool("mobile_get_orientation", "Get the current screen orientation of the device", {
-        noParams
-    }, async () => {
-        requireRobot();
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you.")
+    }, async ({ device }) => {
+        const robot = getRobotFromDevice(device);
         const orientation = await robot.getOrientation();
         return `Current device orientation is ${orientation}`;
     });
-    /*
-    tool(
-        "mobile_get_logs",
-        "Get device logs",
-        {
-            timeWindow: z.string().optional().describe("Time window to look back (e.g., '5m' for 5 minutes, '1h' for 1 hour). Defaults to '1m'"),
-            filter: z.string().optional().describe("Filter logs containing this query (case-insensitive). For Android: supports 'package:mine <query>' (user apps only), 'package:com.app.bundle <query>' (specific app), or '<query>' (text search). For iOS: simple text search only."),
-            process: z.string().optional().describe("Filter logs to a specific process/app bundle ID")
-        },
-        async ({ timeWindow, filter, process }) => {
-            requireRobot();
-            const logs = await robot!.getDeviceLogs({ timeWindow, filter, process });
-            const filterText = filter ? ` (filtered by: ${filter})` : "";
-            const processText = process ? ` (process: ${process})` : "";
-            const timeText = timeWindow ? ` from last ${timeWindow}` : "";
-            return `Device logs${timeText}${filterText}${processText}:\n${logs}`;
-        }
-    );
-    */
     // async check for latest agent version
     checkForLatestAgentVersion().then();
     return server;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mobilenext/mobile-mcp",
   "mcpName": "io.github.mobile-next/mobile-mcp",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "description": "Mobile MCP",
   "repository": {
     "type": "git",
@@ -24,11 +24,11 @@
     "lib"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.6.1",
-    "commander": "^14.0.0",
-    "express": "^5.1.0",
-    "fast-xml-parser": "^5.0.9",
-    "zod-to-json-schema": "^3.24.4"
+    "@modelcontextprotocol/sdk": "1.13.2",
+    "commander": "14.0.0",
+    "express": "5.1.0",
+    "fast-xml-parser": "5.2.5",
+    "zod-to-json-schema": "3.24.6"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",