@mobilenext/mobile-mcp 0.0.44 → 0.0.46

package/lib/android.js

@@ -42,6 +42,7 @@ const node_child_process_1 = require("node:child_process");
 const node_fs_1 = require("node:fs");
 const xml = __importStar(require("fast-xml-parser"));
 const robot_1 = require("./robot");
+const utils_1 = require("./utils");
 const getAdbPath = () => {
     const exeName = process.env.platform === "win32" ? "adb.exe" : "adb";
     if (process.env.ANDROID_HOME) {
@@ -137,6 +138,7 @@ class AndroidRobot {
             .map(line => line.substring("package:".length));
     }
     async launchApp(packageName) {
+        (0, utils_1.validatePackageName)(packageName);
         try {
             this.silentAdb("shell", "monkey", "-p", packageName, "-c", "android.intent.category.LAUNCHER", "1");
         }
@@ -326,6 +328,7 @@ class AndroidRobot {
         return elements;
     }
     async terminateApp(packageName) {
+        (0, utils_1.validatePackageName)(packageName);
         this.adb("shell", "am", "force-stop", packageName);
     }
     async installApp(path) {
@@ -351,7 +354,7 @@ class AndroidRobot {
         }
     }
     async openUrl(url) {
-        this.adb("shell", "am", "start", "-a", "android.intent.action.VIEW", "-d", url);
+        this.adb("shell", "am", "start", "-a", "android.intent.action.VIEW", "-d", this.escapeShellText(url));
     }
     isAscii(text) {
         return /^[\x00-\x7F]*$/.test(text);

package/lib/ios.js

@@ -5,6 +5,7 @@ const node_net_1 = require("node:net");
 const node_child_process_1 = require("node:child_process");
 const webdriver_agent_1 = require("./webdriver-agent");
 const robot_1 = require("./robot");
+const utils_1 = require("./utils");
 const WDA_PORT = 8100;
 const IOS_TUNNEL_PORT = 60105;
 const getGoIosPath = () => {
@@ -94,10 +95,12 @@ class IosRobot {
         });
     }
     async launchApp(packageName) {
+        (0, utils_1.validatePackageName)(packageName);
         await this.assertTunnelRunning();
         await this.ios("launch", packageName);
     }
     async terminateApp(packageName) {
+        (0, utils_1.validatePackageName)(packageName);
         await this.assertTunnelRunning();
         await this.ios("kill", packageName);
     }

package/lib/iphone-simulator.js

@@ -8,6 +8,7 @@ const node_path_1 = require("node:path");
 const logger_1 = require("./logger");
 const webdriver_agent_1 = require("./webdriver-agent");
 const robot_1 = require("./robot");
+const utils_1 = require("./utils");
 const TIMEOUT = 30000;
 const WDA_PORT = 8100;
 const MAX_BUFFER_SIZE = 1024 * 1024 * 8;
@@ -71,9 +72,11 @@ class Simctl {
         // alternative: this.simctl("openurl", this.simulatorUuid, url);
     }
     async launchApp(packageName) {
+        (0, utils_1.validatePackageName)(packageName);
         this.simctl("launch", this.simulatorUuid, packageName);
     }
     async terminateApp(packageName) {
+        (0, utils_1.validatePackageName)(packageName);
         this.simctl("terminate", this.simulatorUuid, packageName);
     }
     findAppBundle(dir) {

package/lib/mobilecli.js

@@ -19,6 +19,12 @@ class Mobilecli {
         const path = this.getPath();
         return (0, node_child_process_1.execFileSync)(path, args, { encoding: "utf8" }).toString().trim();
     }
+    spawnCommand(args) {
+        const binaryPath = this.getPath();
+        return (0, node_child_process_1.spawn)(binaryPath, args, {
+            stdio: ["ignore", "ignore", "ignore"],
+        });
+    }
     executeCommandBuffer(args) {
         const path = this.getPath();
         return (0, node_child_process_1.execFileSync)(path, args, {

package/lib/server.js

@@ -8,6 +8,7 @@ const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const zod_1 = require("zod");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
 const node_crypto_1 = __importDefault(require("node:crypto"));
 const logger_1 = require("./logger");
 const android_1 = require("./android");
@@ -27,8 +28,6 @@ const createMcpServer = () => {
         name: "mobile-mcp",
         version: (0, exports.getAgentVersion)(),
     });
-    // an empty object to satisfy windsurf
-    const noParams = zod_1.z.object({});
     const getClientName = () => {
         try {
             const clientInfo = server.server.getClientVersion();
@@ -112,6 +111,7 @@ const createMcpServer = () => {
         }
     };
     const mobilecli = new mobilecli_1.Mobilecli();
+    const activeRecordings = new Map();
     posthog("launch", {}).then();
     const ensureMobilecliAvailable = () => {
         try {
@@ -156,9 +156,7 @@ const createMcpServer = () => {
         }
         throw new robot_1.ActionableError(`Device "${deviceId}" not found. Use the mobile_list_available_devices tool to see available devices.`);
     };
-    tool("mobile_list_available_devices", "List 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
-    }, { readOnlyHint: true }, async ({}) => {
+    tool("mobile_list_available_devices", "List Devices", "List all available devices. This includes both physical mobile devices and mobile simulators and emulators. It returns both Android and iOS devices.", {}, { readOnlyHint: true }, async ({}) => {
         // from today onward, we must have mobilecli working
         ensureMobilecliAvailable();
         const iosManager = new ios_1.IosManager();
@@ -215,9 +213,7 @@ const createMcpServer = () => {
         return JSON.stringify(out);
     });
     if (process.env.MOBILEFLEET_ENABLE === "1") {
-        tool("mobile_list_fleet_devices", "List Fleet Devices", "List devices available in the remote fleet", {
-            noParams
-        }, { readOnlyHint: true }, async ({}) => {
+        tool("mobile_list_fleet_devices", "List Fleet Devices", "List devices available in the remote fleet", {}, { readOnlyHint: true }, async ({}) => {
             ensureMobilecliAvailable();
             const result = mobilecli.fleetListDevices();
             return result;
@@ -464,6 +460,61 @@ const createMcpServer = () => {
         const orientation = await robot.getOrientation();
         return `Current device orientation is ${orientation}`;
     });
+    tool("mobile_start_screen_recording", "Start Screen Recording", "Start recording the screen of a mobile device. The recording runs in the background until stopped with mobile_stop_screen_recording. Returns the path where the recording will be saved.", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
+        output: zod_1.z.string().optional().describe("The file path to save the recording to. If not provided, a temporary path will be used."),
+        timeLimit: zod_1.z.number().optional().describe("Maximum recording duration in seconds. The recording will stop automatically after this time."),
+    }, { destructiveHint: true }, async ({ device, output, timeLimit }) => {
+        getRobotFromDevice(device);
+        if (activeRecordings.has(device)) {
+            throw new robot_1.ActionableError(`Device "${device}" is already being recorded. Stop the current recording first with mobile_stop_screen_recording.`);
+        }
+        const outputPath = output || node_path_1.default.join(node_os_1.default.tmpdir(), `screen-recording-${Date.now()}.mp4`);
+        const args = ["screenrecord", "--device", device, "--output", outputPath, "--silent"];
+        if (timeLimit !== undefined) {
+            args.push("--time-limit", String(timeLimit));
+        }
+        const child = mobilecli.spawnCommand(args);
+        const cleanup = () => {
+            activeRecordings.delete(device);
+        };
+        child.on("error", cleanup);
+        child.on("exit", cleanup);
+        activeRecordings.set(device, {
+            process: child,
+            outputPath,
+            startedAt: Date.now(),
+        });
+        return `Screen recording started. Output will be saved to: ${outputPath}`;
+    });
+    tool("mobile_stop_screen_recording", "Stop Screen Recording", "Stop an active screen recording on a mobile device. Returns the file path, size, and approximate duration of the recording.", {
+        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
+    }, { destructiveHint: true }, async ({ device }) => {
+        const recording = activeRecordings.get(device);
+        if (!recording) {
+            throw new robot_1.ActionableError(`No active recording found for device "${device}". Start a recording first with mobile_start_screen_recording.`);
+        }
+        const { process: child, outputPath, startedAt } = recording;
+        activeRecordings.delete(device);
+        child.kill("SIGINT");
+        await new Promise(resolve => {
+            const timeout = setTimeout(() => {
+                child.kill("SIGKILL");
+                resolve();
+            }, 5 * 60 * 1000);
+            child.on("close", () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+        });
+        const durationSeconds = Math.round((Date.now() - startedAt) / 1000);
+        if (!node_fs_1.default.existsSync(outputPath)) {
+            return `Recording stopped after ~${durationSeconds}s but the output file was not found at: ${outputPath}`;
+        }
+        const stats = node_fs_1.default.statSync(outputPath);
+        const fileSizeMB = (stats.size / (1024 * 1024)).toFixed(2);
+        return `Recording stopped. File: ${outputPath} (${fileSizeMB} MB, ~${durationSeconds}s)`;
+    });
     return server;
 };
 exports.createMcpServer = createMcpServer;

package/lib/utils.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePackageName = validatePackageName;
+const robot_1 = require("./robot");
+function validatePackageName(packageName) {
+    if (!/^[a-zA-Z0-9._]+$/.test(packageName)) {
+        throw new robot_1.ActionableError(`Invalid package name: "${packageName}"`);
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mobilenext/mobile-mcp",
   "mcpName": "io.github.mobile-next/mobile-mcp",
-  "version": "0.0.44",
+  "version": "0.0.46",
   "description": "Mobile MCP",
   "repository": {
     "type": "git",
@@ -28,13 +28,13 @@
     "ajv": "^8.18.0",
     "commander": "14.0.0",
     "express": "5.1.0",
-    "fast-xml-parser": "5.3.7",
+    "fast-xml-parser": "5.3.8",
     "qs": "^6.15.0",
     "zod": "^4.1.13",
     "zod-to-json-schema": "3.25.0"
   },
   "optionalDependencies": {
-    "@mobilenext/mobilecli": "0.1.59"
+    "@mobilenext/mobilecli": "0.1.60"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",