@mobilenext/mobile-mcp 0.0.45 → 0.0.46

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();
@@ -458,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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mobilenext/mobile-mcp",
   "mcpName": "io.github.mobile-next/mobile-mcp",
-  "version": "0.0.45",
+  "version": "0.0.46",
   "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",