@mobilenext/mobile-mcp 0.0.46 → 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/server.js

@@ -243,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", {
@@ -281,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);
@@ -290,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);
@@ -299,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;
@@ -354,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) {
@@ -463,7 +464,7 @@ const createMcpServer = () => {
     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."),
+        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)) {

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.46",
+  "version": "0.0.47",
   "description": "Mobile MCP",
   "repository": {
     "type": "git",