@mobilenext/mobile-mcp 0.0.28 → 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

@@ -253,7 +253,7 @@ const createMcpServer = () => {
         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"),
@@ -348,25 +348,6 @@ const createMcpServer = () => {
         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.28",
+  "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",