@mobilenext/mobile-mcp 0.0.45 → 0.0.47

package/lib/android.js

@@ -137,8 +137,17 @@ class AndroidRobot {
             .filter(line => line.startsWith("package:"))
             .map(line => line.substring("package:".length));
     }
-    async launchApp(packageName) {
+    async launchApp(packageName, locale) {
         (0, utils_1.validatePackageName)(packageName);
+        if (locale) {
+            (0, utils_1.validateLocale)(locale);
+            try {
+                this.silentAdb("shell", "cmd", "locale", "set-app-locales", packageName, "--locales", locale);
+            }
+            catch (error) {
+                // set-app-locales requires Android 13+ (API 33), silently ignore on older versions
+            }
+        }
         try {
             this.silentAdb("shell", "monkey", "-p", packageName, "-c", "android.intent.category.LAUNCHER", "1");
         }

package/lib/ios.js

@@ -94,10 +94,17 @@ class IosRobot {
             };
         });
     }
-    async launchApp(packageName) {
+    async launchApp(packageName, locale) {
         (0, utils_1.validatePackageName)(packageName);
         await this.assertTunnelRunning();
-        await this.ios("launch", packageName);
+        const args = ["launch", packageName];
+        if (locale) {
+            (0, utils_1.validateLocale)(locale);
+            const locales = locale.split(",").map(l => l.trim());
+            args.push("-AppleLanguages", `(${locales.join(", ")})`);
+            args.push("-AppleLocale", locales[0]);
+        }
+        await this.ios(...args);
     }
     async terminateApp(packageName) {
         (0, utils_1.validatePackageName)(packageName);

package/lib/iphone-simulator.js

@@ -71,9 +71,16 @@ class Simctl {
         await wda.openUrl(url);
         // alternative: this.simctl("openurl", this.simulatorUuid, url);
     }
-    async launchApp(packageName) {
+    async launchApp(packageName, locale) {
         (0, utils_1.validatePackageName)(packageName);
-        this.simctl("launch", this.simulatorUuid, packageName);
+        const args = ["launch", this.simulatorUuid, packageName];
+        if (locale) {
+            (0, utils_1.validateLocale)(locale);
+            const locales = locale.split(",").map(l => l.trim());
+            args.push("-AppleLanguages", `(${locales.join(", ")})`);
+            args.push("-AppleLocale", locales[0]);
+        }
+        this.simctl(...args);
     }
     async terminateApp(packageName) {
         (0, utils_1.validatePackageName)(packageName);

package/lib/mobile-device.js

@@ -80,8 +80,12 @@ class MobileDevice {
             packageName: app.packageName,
         }));
     }
-    async launchApp(packageName) {
-        this.runCommand(["apps", "launch", packageName]);
+    async launchApp(packageName, locale) {
+        const args = ["apps", "launch", packageName];
+        if (locale) {
+            args.push("--locale", locale);
+        }
+        this.runCommand(args);
     }
     async terminateApp(packageName) {
         this.runCommand(["apps", "terminate", packageName]);

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");
@@ -110,6 +111,7 @@ const createMcpServer = () => {
         }
     };
     const mobilecli = new mobilecli_1.Mobilecli();
+    const activeRecordings = new Map();
     posthog("launch", {}).then();
     const ensureMobilecliAvailable = () => {
         try {
@@ -154,7 +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.", {}, { 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();
@@ -241,9 +243,10 @@ const createMcpServer = () => {
     tool("mobile_launch_app", "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"),
-    }, { destructiveHint: true }, async ({ device, packageName }) => {
+        locale: zod_1.z.string().optional().describe("Comma-separated BCP 47 locale tags to launch the app with (e.g., fr-FR,en-GB)"),
+    }, { destructiveHint: true }, async ({ device, packageName, locale }) => {
         const robot = getRobotFromDevice(device);
-        await robot.launchApp(packageName);
+        await robot.launchApp(packageName, locale);
         return `Launched app ${packageName}`;
     });
     tool("mobile_terminate_app", "Terminate App", "Stop and terminate an app on mobile device", {
@@ -279,8 +282,8 @@ const createMcpServer = () => {
     });
     tool("mobile_click_on_screen_at_coordinates", "Click Screen", "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"),
+        x: zod_1.z.coerce.number().describe("The x coordinate to click on the screen, in pixels"),
+        y: zod_1.z.coerce.number().describe("The y coordinate to click on the screen, in pixels"),
     }, { destructiveHint: true }, async ({ device, x, y }) => {
         const robot = getRobotFromDevice(device);
         await robot.tap(x, y);
@@ -288,8 +291,8 @@ const createMcpServer = () => {
     });
     tool("mobile_double_tap_on_screen", "Double Tap Screen", "Double-tap on the screen at given x,y 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 double-tap, in pixels"),
-        y: zod_1.z.number().describe("The y coordinate to double-tap, in pixels"),
+        x: zod_1.z.coerce.number().describe("The x coordinate to double-tap, in pixels"),
+        y: zod_1.z.coerce.number().describe("The y coordinate to double-tap, in pixels"),
     }, { destructiveHint: true }, async ({ device, x, y }) => {
         const robot = getRobotFromDevice(device);
         await robot.doubleTap(x, y);
@@ -297,9 +300,9 @@ const createMcpServer = () => {
     });
     tool("mobile_long_press_on_screen_at_coordinates", "Long Press Screen", "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"),
-        duration: zod_1.z.number().min(1).max(10000).optional().describe("Duration of the long press in milliseconds. Defaults to 500ms."),
+        x: zod_1.z.coerce.number().describe("The x coordinate to long press on the screen, in pixels"),
+        y: zod_1.z.coerce.number().describe("The y coordinate to long press on the screen, in pixels"),
+        duration: zod_1.z.coerce.number().min(1).max(10000).optional().describe("Duration of the long press in milliseconds. Defaults to 500ms."),
     }, { destructiveHint: true }, async ({ device, x, y, duration }) => {
         const robot = getRobotFromDevice(device);
         const pressDuration = duration ?? 500;
@@ -352,9 +355,9 @@ const createMcpServer = () => {
     tool("mobile_swipe_on_screen", "Swipe 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"),
+        x: zod_1.z.coerce.number().optional().describe("The x coordinate to start the swipe from, in pixels. If not provided, uses center of screen"),
+        y: zod_1.z.coerce.number().optional().describe("The y coordinate to start the swipe from, in pixels. If not provided, uses center of screen"),
+        distance: zod_1.z.coerce.number().optional().describe("The distance to swipe in pixels. Defaults to 400 pixels for iOS or 30% of screen dimension for Android"),
     }, { destructiveHint: true }, async ({ device, direction, x, y, distance }) => {
         const robot = getRobotFromDevice(device);
         if (x !== undefined && y !== undefined) {
@@ -458,6 +461,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.coerce.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

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mobilenext/mobile-mcp",
   "mcpName": "io.github.mobile-next/mobile-mcp",
-  "version": "0.0.45",
+  "version": "0.0.47",
   "description": "Mobile MCP",
   "repository": {
     "type": "git",
@@ -34,7 +34,7 @@
     "zod-to-json-schema": "3.25.0"
   },
   "optionalDependencies": {
-    "@mobilenext/mobilecli": "0.1.59"
+    "@mobilenext/mobilecli": "0.1.60"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",