@mobilenext/mobile-mcp 0.0.28 → 0.0.30-beta

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/mobilecli.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMobilecliPath = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const getMobilecliPath = () => {
+    if (process.env.MOBILECLI_PATH) {
+        return process.env.MOBILECLI_PATH;
+    }
+    const platform = process.platform;
+    let binaryName = "mobilecli";
+    switch (platform) {
+        case "darwin":
+            binaryName += "-darwin";
+            break;
+        case "linux":
+            const arch = process.arch;
+            if (arch === "arm64") {
+                binaryName += "-linux-arm64";
+            }
+            else {
+                binaryName += "-linux-amd64";
+            }
+            break;
+        case "win32":
+            binaryName += "-windows-amd64.exe";
+            break;
+        default:
+            throw new Error(`Unsupported platform: ${platform}`);
+    }
+    // Check if mobile-mcp is installed as a package
+    const currentPath = __filename;
+    const pathParts = currentPath.split(node_path_1.sep);
+    const lastNodeModulesIndex = pathParts.lastIndexOf("node_modules");
+    if (lastNodeModulesIndex !== -1) {
+        // We're inside node_modules, go to the last node_modules in the path
+        const nodeModulesParts = pathParts.slice(0, lastNodeModulesIndex + 1);
+        const lastNodeModulesPath = nodeModulesParts.join(node_path_1.sep);
+        const mobilecliPath = (0, node_path_1.join)(lastNodeModulesPath, "@mobilenext", "mobilecli", "bin", binaryName);
+        if ((0, node_fs_1.existsSync)(mobilecliPath)) {
+            return mobilecliPath;
+        }
+    }
+    // Not in node_modules, look one directory up from current script
+    const scriptDir = (0, node_path_1.dirname)(__filename);
+    const parentDir = (0, node_path_1.dirname)(scriptDir);
+    const mobilecliPath = (0, node_path_1.join)(parentDir, "node_modules", "@mobilenext", "mobilecli", "bin", binaryName);
+    if ((0, node_fs_1.existsSync)(mobilecliPath)) {
+        return mobilecliPath;
+    }
+    throw new Error(`Could not find mobilecli binary for platform: ${platform}`);
+};
+exports.getMobilecliPath = getMobilecliPath;

package/lib/server.js

@@ -9,6 +9,7 @@ const zod_1 = require("zod");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_os_1 = __importDefault(require("node:os"));
 const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_child_process_1 = require("node:child_process");
 const logger_1 = require("./logger");
 const android_1 = require("./android");
 const robot_1 = require("./robot");
@@ -16,28 +17,12 @@ const iphone_simulator_1 = require("./iphone-simulator");
 const ios_1 = require("./ios");
 const png_1 = require("./png");
 const image_utils_1 = require("./image-utils");
+const mobilecli_1 = require("./mobilecli");
 const getAgentVersion = () => {
     const json = require("../package.json");
     return json.version;
 };
 exports.getAgentVersion = getAgentVersion;
-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();
-    return json[0].name;
-};
-const checkForLatestAgentVersion = async () => {
-    try {
-        const latestVersion = await getLatestAgentVersion();
-        const currentVersion = (0, exports.getAgentVersion)();
-        if (latestVersion !== currentVersion) {
-            (0, logger_1.trace)(`You are running an older version of the agent. Please update to the latest version: ${latestVersion}.`);
-        }
-    }
-    catch (error) {
-        // ignore
-    }
-};
 const createMcpServer = () => {
     const server = new mcp_js_1.McpServer({
         name: "mobile-mcp",
@@ -49,6 +34,8 @@ const createMcpServer = () => {
     });
     // an empty object to satisfy windsurf
     const noParams = zod_1.z.object({});
+    // will be replaced later by 'initialize' jsonrpc request
+    let clientName = "unknown";
     const tool = (name, description, paramsSchema, cb) => {
         const wrappedCb = async (args) => {
             try {
@@ -89,6 +76,7 @@ const createMcpServer = () => {
                 Product: "mobile-mcp",
                 Version: (0, exports.getAgentVersion)(),
                 NodeVersion: process.version,
+                AgentName: clientName,
             };
             await fetch(url, {
                 method: "POST",
@@ -110,6 +98,19 @@ const createMcpServer = () => {
             // ignore
         }
     };
+    const reportMobilecliVersion = async () => {
+        try {
+            const path = (0, mobilecli_1.getMobilecliPath)();
+            const output = (0, node_child_process_1.execFileSync)(path, ["--version"], { encoding: "utf8" }).toString().trim();
+            const version = output.startsWith("mobilecli version ")
+                ? output.split(" ").pop()
+                : output;
+            await posthog("mobilecli_check", { MobilecliVersion: version || output });
+        }
+        catch (error) {
+            await posthog("mobilecli_check", { MobilecliVersion: "failed" });
+        }
+    };
     posthog("launch", {}).then();
     const simulatorManager = new iphone_simulator_1.SimctlManager();
     const getRobotFromDevice = (device) => {
@@ -253,7 +254,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,27 +349,21 @@ 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();
+    // async report mobilecli version
+    reportMobilecliVersion().then();
+    const hook = server.connect;
+    server.connect = (transport) => {
+        transport.onmessage = (message) => {
+            if ("method" in message) {
+                const request = message;
+                if (request.method === "initialize") {
+                    const initialize = request;
+                    clientName = initialize.params.clientInfo.name || "unknown";
+                }
+            }
+        };
+        return hook.apply(server, [transport]);
+    };
     return server;
 };
 exports.createMcpServer = createMcpServer;

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.30-beta",
   "description": "Mobile MCP",
   "repository": {
     "type": "git",
@@ -24,11 +24,12 @@
     "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",
+    "@mobilenext/mobilecli": "0.0.25"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",