@mobilenext/mobile-mcp 0.0.38 → 0.0.40

package/README.md

@@ -28,7 +28,7 @@ This server allows Agents and LLMs to interact with native iOS/Android applicati
   <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">
+  <a href="https://mobilenexthq.com/join-slack">
     <img src="https://img.shields.io/badge/join-Slack-blueviolet?logo=slack&style=flat" alt="join on Slack" />
   </a>
 </h4>

package/lib/android.js

@@ -399,9 +399,9 @@ class AndroidRobot {
     async tap(x, y) {
         this.adb("shell", "input", "tap", `${x}`, `${y}`);
     }
-    async longPress(x, y) {
+    async longPress(x, y, duration) {
         // a long press is a swipe with no movement and a long duration
-        this.adb("shell", "input", "swipe", `${x}`, `${y}`, `${x}`, `${y}`, "500");
+        this.adb("shell", "input", "swipe", `${x}`, `${y}`, `${x}`, `${y}`, `${duration}`);
     }
     async doubleTap(x, y) {
         await this.tap(x, y);

package/lib/ios.js

@@ -145,9 +145,9 @@ class IosRobot {
         const wda = await this.wda();
         await wda.doubleTap(x, y);
     }
-    async longPress(x, y) {
+    async longPress(x, y, duration) {
         const wda = await this.wda();
-        await wda.longPress(x, y);
+        await wda.longPress(x, y, duration);
     }
     async getElementsOnScreen() {
         const wda = await this.wda();

package/lib/iphone-simulator.js

@@ -192,9 +192,9 @@ class Simctl {
         const wda = await this.wda();
         await wda.doubleTap(x, y);
     }
-    async longPress(x, y) {
+    async longPress(x, y, duration) {
         const wda = await this.wda();
-        return wda.longPress(x, y);
+        return wda.longPress(x, y, duration);
     }
     async pressButton(button) {
         const wda = await this.wda();

package/lib/mobile-device.js

@@ -109,8 +109,8 @@ class MobileDevice {
         await this.tap(x, y);
         await this.tap(x, y);
     }
-    async longPress(x, y) {
-        this.runCommand(["io", "longpress", `${x},${y}`]);
+    async longPress(x, y, duration) {
+        this.runCommand(["io", "longpress", `${x},${y}`, "--duration", `${duration}`]);
     }
     async getElementsOnScreen() {
         const response = JSON.parse(this.runCommand(["dump", "ui"]));

package/lib/server.js

@@ -39,11 +39,12 @@ const createMcpServer = () => {
             return "unknown";
         }
     };
-    const tool = (name, title, description, paramsSchema, cb) => {
+    const tool = (name, title, description, paramsSchema, annotations, cb) => {
         server.registerTool(name, {
             title,
             description,
             inputSchema: paramsSchema,
+            annotations,
         }, (async (args, _extra) => {
             try {
                 (0, logger_1.trace)(`Invoking ${name} with args: ${JSON.stringify(args)}`);
@@ -157,7 +158,7 @@ const createMcpServer = () => {
     };
     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
-    }, async ({}) => {
+    }, { readOnlyHint: true }, async ({}) => {
         // from today onward, we must have mobilecli working
         ensureMobilecliAvailable();
         const iosManager = new ios_1.IosManager();
@@ -215,7 +216,7 @@ const createMcpServer = () => {
     });
     tool("mobile_list_apps", "List Apps", "List all the installed apps on the 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.")
-    }, async ({ device }) => {
+    }, { readOnlyHint: true }, async ({ device }) => {
         const robot = getRobotFromDevice(device);
         const result = await robot.listApps();
         return `Found these apps on device: ${result.map(app => `${app.appName} (${app.packageName})`).join(", ")}`;
@@ -223,7 +224,7 @@ 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"),
-    }, async ({ device, packageName }) => {
+    }, { destructiveHint: true }, async ({ device, packageName }) => {
         const robot = getRobotFromDevice(device);
         await robot.launchApp(packageName);
         return `Launched app ${packageName}`;
@@ -231,7 +232,7 @@ const createMcpServer = () => {
     tool("mobile_terminate_app", "Terminate App", "Stop and terminate an app on mobile 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 terminate"),
-    }, async ({ device, packageName }) => {
+    }, { destructiveHint: true }, async ({ device, packageName }) => {
         const robot = getRobotFromDevice(device);
         await robot.terminateApp(packageName);
         return `Terminated app ${packageName}`;
@@ -239,7 +240,7 @@ const createMcpServer = () => {
     tool("mobile_install_app", "Install App", "Install an app on mobile 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."),
         path: zod_1.z.string().describe("The path to the app file to install. For iOS simulators, provide a .zip file or a .app directory. For Android provide an .apk file. For iOS real devices provide an .ipa file"),
-    }, async ({ device, path }) => {
+    }, { destructiveHint: true }, async ({ device, path }) => {
         const robot = getRobotFromDevice(device);
         await robot.installApp(path);
         return `Installed app from ${path}`;
@@ -247,14 +248,14 @@ const createMcpServer = () => {
     tool("mobile_uninstall_app", "Uninstall App", "Uninstall an app from mobile 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."),
         bundle_id: zod_1.z.string().describe("Bundle identifier (iOS) or package name (Android) of the app to be uninstalled"),
-    }, async ({ device, bundle_id }) => {
+    }, { destructiveHint: true }, async ({ device, bundle_id }) => {
         const robot = getRobotFromDevice(device);
         await robot.uninstallApp(bundle_id);
         return `Uninstalled app ${bundle_id}`;
     });
     tool("mobile_get_screen_size", "Get Screen Size", "Get the screen size of the mobile device in pixels", {
         device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you.")
-    }, async ({ device }) => {
+    }, { readOnlyHint: true }, async ({ device }) => {
         const robot = getRobotFromDevice(device);
         const screenSize = await robot.getScreenSize();
         return `Screen size is ${screenSize.width}x${screenSize.height} pixels`;
@@ -263,7 +264,7 @@ const createMcpServer = () => {
         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"),
-    }, async ({ device, x, y }) => {
+    }, { destructiveHint: true }, async ({ device, x, y }) => {
         const robot = getRobotFromDevice(device);
         await robot.tap(x, y);
         return `Clicked on screen at coordinates: ${x}, ${y}`;
@@ -272,7 +273,7 @@ const createMcpServer = () => {
         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"),
-    }, async ({ device, x, y }) => {
+    }, { destructiveHint: true }, async ({ device, x, y }) => {
         const robot = getRobotFromDevice(device);
         await robot.doubleTap(x, y);
         return `Double-tapped on screen at coordinates: ${x}, ${y}`;
@@ -281,14 +282,16 @@ const createMcpServer = () => {
         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"),
-    }, async ({ device, x, y }) => {
+        duration: zod_1.z.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);
-        await robot.longPress(x, y);
-        return `Long pressed on screen at coordinates: ${x}, ${y}`;
+        const pressDuration = duration ?? 500;
+        await robot.longPress(x, y, pressDuration);
+        return `Long pressed on screen at coordinates: ${x}, ${y} for ${pressDuration}ms`;
     });
     tool("mobile_list_elements_on_screen", "List Screen Elements", "List elements on screen and their coordinates, with display text or accessibility label. Do not cache this result.", {
         device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you.")
-    }, async ({ device }) => {
+    }, { readOnlyHint: true }, async ({ device }) => {
         const robot = getRobotFromDevice(device);
         const elements = await robot.getElementsOnScreen();
         const result = elements.map(element => {
@@ -316,7 +319,7 @@ const createMcpServer = () => {
     tool("mobile_press_button", "Press Button", "Press a button 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."),
         button: zod_1.z.string().describe("The button to press. Supported buttons: BACK (android only), HOME, VOLUME_UP, VOLUME_DOWN, ENTER, DPAD_CENTER (android tv only), DPAD_UP (android tv only), DPAD_DOWN (android tv only), DPAD_LEFT (android tv only), DPAD_RIGHT (android tv only)"),
-    }, async ({ device, button }) => {
+    }, { destructiveHint: true }, async ({ device, button }) => {
         const robot = getRobotFromDevice(device);
         await robot.pressButton(button);
         return `Pressed the button: ${button}`;
@@ -324,7 +327,7 @@ const createMcpServer = () => {
     tool("mobile_open_url", "Open URL", "Open a URL in browser 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."),
         url: zod_1.z.string().describe("The URL to open"),
-    }, async ({ device, url }) => {
+    }, { destructiveHint: true }, async ({ device, url }) => {
         const robot = getRobotFromDevice(device);
         await robot.openUrl(url);
         return `Opened URL: ${url}`;
@@ -335,7 +338,7 @@ const createMcpServer = () => {
         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"),
-    }, async ({ device, direction, x, y, distance }) => {
+    }, { destructiveHint: true }, async ({ device, direction, x, y, distance }) => {
         const robot = getRobotFromDevice(device);
         if (x !== undefined && y !== undefined) {
             // Use coordinate-based swipe
@@ -353,7 +356,7 @@ const createMcpServer = () => {
         device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         text: zod_1.z.string().describe("The text to type"),
         submit: zod_1.z.boolean().describe("Whether to submit the text. If true, the text will be submitted as if the user pressed the enter key."),
-    }, async ({ device, text, submit }) => {
+    }, { destructiveHint: true }, async ({ device, text, submit }) => {
         const robot = getRobotFromDevice(device);
         await robot.sendKeys(text);
         if (submit) {
@@ -364,7 +367,7 @@ const createMcpServer = () => {
     tool("mobile_save_screenshot", "Save Screenshot", "Save a screenshot of the mobile device to a file", {
         device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you."),
         saveTo: zod_1.z.string().describe("The path to save the screenshot to"),
-    }, async ({ device, saveTo }) => {
+    }, { destructiveHint: true }, async ({ device, saveTo }) => {
         const robot = getRobotFromDevice(device);
         const screenshot = await robot.getScreenshot();
         node_fs_1.default.writeFileSync(saveTo, screenshot);
@@ -375,7 +378,10 @@ const createMcpServer = () => {
         description: "Take a screenshot of the mobile device. Use this to understand what's on screen, if you need to press an element that is available through view hierarchy then you must list elements on screen instead. Do not cache this result.",
         inputSchema: {
             device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you.")
-        }
+        },
+        annotations: {
+            readOnlyHint: true,
+        },
     }, async ({ device }) => {
         try {
             const robot = getRobotFromDevice(device);
@@ -423,14 +429,14 @@ const createMcpServer = () => {
     tool("mobile_set_orientation", "Set Orientation", "Change the screen orientation of the 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."),
         orientation: zod_1.z.enum(["portrait", "landscape"]).describe("The desired orientation"),
-    }, async ({ device, orientation }) => {
+    }, { destructiveHint: true }, async ({ device, orientation }) => {
         const robot = getRobotFromDevice(device);
         await robot.setOrientation(orientation);
         return `Changed device orientation to ${orientation}`;
     });
     tool("mobile_get_orientation", "Get Orientation", "Get the current screen orientation of the 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.")
-    }, async ({ device }) => {
+    }, { readOnlyHint: true }, async ({ device }) => {
         const robot = getRobotFromDevice(device);
         const orientation = await robot.getOrientation();
         return `Current device orientation is ${orientation}`;

package/lib/webdriver-agent.js

@@ -172,7 +172,7 @@ class WebDriverAgent {
             });
         });
     }
-    async longPress(x, y) {
+    async longPress(x, y, duration) {
         await this.withinSession(async (sessionUrl) => {
             const url = `${sessionUrl}/actions`;
             await fetch(url, {
@@ -189,7 +189,7 @@ class WebDriverAgent {
                             actions: [
                                 { type: "pointerMove", duration: 0, x, y },
                                 { type: "pointerDown", button: 0 },
-                                { type: "pause", duration: 500 },
+                                { type: "pause", duration },
                                 { type: "pointerUp", button: 0 }
                             ]
                         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mobilenext/mobile-mcp",
   "mcpName": "io.github.mobile-next/mobile-mcp",
-  "version": "0.0.38",
+  "version": "0.0.40",
   "description": "Mobile MCP",
   "repository": {
     "type": "git",
@@ -24,7 +24,7 @@
     "lib"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.24.2",
+    "@modelcontextprotocol/sdk": "1.25.2",
     "commander": "14.0.0",
     "express": "5.1.0",
     "fast-xml-parser": "5.2.5",
@@ -32,7 +32,7 @@
     "zod-to-json-schema": "3.25.0"
   },
   "optionalDependencies": {
-    "@mobilenext/mobilecli": "0.0.46"
+    "@mobilenext/mobilecli": "0.0.49"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",