@mobilenext/mobile-mcp 0.0.35 → 0.0.37

package/lib/server.js

@@ -27,10 +27,6 @@ const createMcpServer = () => {
     const server = new mcp_js_1.McpServer({
         name: "mobile-mcp",
         version: (0, exports.getAgentVersion)(),
-        capabilities: {
-            resources: {},
-            tools: {},
-        },
     });
     // an empty object to satisfy windsurf
     const noParams = zod_1.z.object({});
@@ -44,8 +40,12 @@ const createMcpServer = () => {
             return "unknown";
         }
     };
-    const tool = (name, description, paramsSchema, cb) => {
-        const wrappedCb = async (args) => {
+    const tool = (name, title, description, paramsSchema, cb) => {
+        server.registerTool(name, {
+            title,
+            description,
+            inputSchema: paramsSchema,
+        }, (async (args, _extra) => {
             try {
                 (0, logger_1.trace)(`Invoking ${name} with args: ${JSON.stringify(args)}`);
                 const response = await cb(args);
@@ -71,8 +71,7 @@ const createMcpServer = () => {
                     };
                 }
             }
-        };
-        server.tool(name, description, paramsSchema, args => wrappedCb(args));
+        }));
     };
     const posthog = async (event, properties) => {
         try {
@@ -154,7 +153,7 @@ const createMcpServer = () => {
         }
         throw new robot_1.ActionableError(`Device "${device}" not found. Use the mobile_list_available_devices tool to see available devices.`);
     };
-    tool("mobile_list_available_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.", {
+    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 ({}) => {
         const iosManager = new ios_1.IosManager();
@@ -210,14 +209,14 @@ const createMcpServer = () => {
         }
         return resp.join("\n");
     });
-    tool("mobile_list_apps", "List all the installed apps on the device", {
+    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 }) => {
         const robot = getRobotFromDevice(device);
         const result = await robot.listApps();
         return `Found these apps on device: ${result.map(app => `${app.appName} (${app.packageName})`).join(", ")}`;
     });
-    tool("mobile_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.", {
+    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 }) => {
@@ -225,7 +224,7 @@ const createMcpServer = () => {
         await robot.launchApp(packageName);
         return `Launched app ${packageName}`;
     });
-    tool("mobile_terminate_app", "Stop and terminate an app on mobile device", {
+    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 }) => {
@@ -233,7 +232,7 @@ const createMcpServer = () => {
         await robot.terminateApp(packageName);
         return `Terminated app ${packageName}`;
     });
-    tool("mobile_install_app", "Install an app on mobile device", {
+    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 }) => {
@@ -241,7 +240,7 @@ const createMcpServer = () => {
         await robot.installApp(path);
         return `Installed app from ${path}`;
     });
-    tool("mobile_uninstall_app", "Uninstall an app from mobile device", {
+    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 }) => {
@@ -249,14 +248,14 @@ const createMcpServer = () => {
         await robot.uninstallApp(bundle_id);
         return `Uninstalled app ${bundle_id}`;
     });
-    tool("mobile_get_screen_size", "Get the screen size of the mobile device in pixels", {
+    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 }) => {
         const robot = getRobotFromDevice(device);
         const screenSize = await robot.getScreenSize();
         return `Screen size is ${screenSize.width}x${screenSize.height} pixels`;
     });
-    tool("mobile_click_on_screen_at_coordinates", "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.", {
+    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"),
@@ -265,7 +264,7 @@ const createMcpServer = () => {
         await robot.tap(x, y);
         return `Clicked on screen at coordinates: ${x}, ${y}`;
     });
-    tool("mobile_double_tap_on_screen", "Double-tap on the screen at given x,y coordinates.", {
+    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"),
@@ -274,7 +273,7 @@ const createMcpServer = () => {
         await robot.doubleTap(x, y);
         return `Double-tapped on screen at coordinates: ${x}, ${y}`;
     });
-    tool("mobile_long_press_on_screen_at_coordinates", "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.", {
+    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"),
@@ -283,7 +282,7 @@ const createMcpServer = () => {
         await robot.longPress(x, y);
         return `Long pressed on screen at coordinates: ${x}, ${y}`;
     });
-    tool("mobile_list_elements_on_screen", "List elements on screen and their coordinates, with display text or accessibility label. Do not cache this result.", {
+    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 }) => {
         const robot = getRobotFromDevice(device);
@@ -310,7 +309,7 @@ const createMcpServer = () => {
         });
         return `Found these elements on screen: ${JSON.stringify(result)}`;
     });
-    tool("mobile_press_button", "Press a button on device", {
+    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 }) => {
@@ -318,7 +317,7 @@ const createMcpServer = () => {
         await robot.pressButton(button);
         return `Pressed the button: ${button}`;
     });
-    tool("mobile_open_url", "Open a URL in browser on device", {
+    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 }) => {
@@ -326,7 +325,7 @@ const createMcpServer = () => {
         await robot.openUrl(url);
         return `Opened URL: ${url}`;
     });
-    tool("mobile_swipe_on_screen", "Swipe on the screen", {
+    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"),
@@ -346,7 +345,7 @@ const createMcpServer = () => {
             return `Swiped ${direction} on screen`;
         }
     });
-    tool("mobile_type_keys", "Type text into the focused element", {
+    tool("mobile_type_keys", "Type Text", "Type text into the focused element", {
         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."),
@@ -358,7 +357,7 @@ const createMcpServer = () => {
         }
         return `Typed text: ${text}`;
     });
-    tool("mobile_save_screenshot", "Save a screenshot of the mobile device to a file", {
+    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 }) => {
@@ -367,8 +366,12 @@ const createMcpServer = () => {
         node_fs_1.default.writeFileSync(saveTo, screenshot);
         return `Screenshot saved to: ${saveTo}`;
     });
-    server.tool("mobile_take_screenshot", "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.", {
-        device: zod_1.z.string().describe("The device identifier to use. Use mobile_list_available_devices to find which devices are available to you.")
+    server.registerTool("mobile_take_screenshot", {
+        title: "Take Screenshot",
+        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.")
+        }
     }, async ({ device }) => {
         try {
             const robot = getRobotFromDevice(device);
@@ -413,7 +416,7 @@ const createMcpServer = () => {
             };
         }
     });
-    tool("mobile_set_orientation", "Change the screen orientation of the device", {
+    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 }) => {
@@ -421,7 +424,7 @@ const createMcpServer = () => {
         await robot.setOrientation(orientation);
         return `Changed device orientation to ${orientation}`;
     });
-    tool("mobile_get_orientation", "Get the current screen orientation of the device", {
+    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 }) => {
         const robot = getRobotFromDevice(device);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mobilenext/mobile-mcp",
   "mcpName": "io.github.mobile-next/mobile-mcp",
-  "version": "0.0.35",
+  "version": "0.0.37",
   "description": "Mobile MCP",
   "repository": {
     "type": "git",
@@ -24,14 +24,15 @@
     "lib"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.13.2",
+    "@modelcontextprotocol/sdk": "1.24.2",
     "commander": "14.0.0",
     "express": "5.1.0",
     "fast-xml-parser": "5.2.5",
-    "zod-to-json-schema": "3.24.6"
+    "zod": "^4.1.13",
+    "zod-to-json-schema": "3.25.0"
   },
   "optionalDependencies": {
-    "@mobilenext/mobilecli": "0.0.33"
+    "@mobilenext/mobilecli": "0.0.38"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",
@@ -52,7 +53,7 @@
     "mocha": "^11.1.0",
     "nyc": "^17.1.0",
     "ts-node": "^10.9.2",
-    "typescript": "^5.8.2"
+    "typescript": "5.8.2"
   },
   "main": "index.js",
   "bin": {