@mobilenext/mobile-mcp 0.0.17 → 0.0.18

package/README.md

@@ -3,25 +3,39 @@
 This is a [Model Context Protocol (MCP) server](https://github.com/modelcontextprotocol) that enables scalable mobile automation, development through a platform-agnostic interface, eliminating the need for distinct iOS or Android knowledge. You can run it on emulators, simulators, and physical devices (iOS and Android).
 This server allows Agents and LLMs to interact with native iOS/Android applications and devices through structured accessibility snapshots or coordinate-based taps based on screenshots. 
 
-https://github.com/user-attachments/assets/c4e89c4f-cc71-4424-8184-bdbc8c638fa1
-
-
-<p align="center">
+<h4 align="center">
+<a href="https://github.com/mobile-next/mobile-mcp">
+    <img src="https://img.shields.io/github/stars/mobile-next/mobile-mcp" alt="Mobile Next Stars" />
+  </a>  
+ <a href="https://github.com/mobile-next/mobile-mcp">
+    <img src="https://img.shields.io/github/contributors/mobile-next/mobile-mcp?color=green" alt="Mobile Next Downloads" />
+  </a>
   <a href="https://www.npmjs.com/package/@mobilenext/mobile-mcp">
-    <img src="https://img.shields.io/badge/npm-@mobilenext/mobile--mcp-red" alt="npm">
+    <img src="https://img.shields.io/npm/dm/@mobilenext/mobile-mcp?logo=npm&style=flat&color=red" alt="npm">
   </a>
-  <a href="https://github.com/mobile-next/mobile-mcp">
-    <img src="https://img.shields.io/badge/github-repo-black" alt="GitHub repo">
+<a href="https://github.com/mobile-next/mobile-mcp/releases">
+    <img src="https://img.shields.io/github/release/mobile-next/mobile-mcp">
   </a>
+<a href="https://github.com/mobile-next/mobile-mcp/blob/main/LICENSE">
+    <img src="https://img.shields.io/badge/license-Apache 2.0-blue.svg" alt="Mobile MCP is released under the Apache-2.0 License">
+  </a> 
+  
 </p>
 
+<h4 align="center">
+<a href="http://mobilenexthq.com/join-slack">
+    <img src="https://img.shields.io/badge/join-Slack-blueviolet?logo=slack&style=flat" alt="Slack community channel" />
+</a>	
+</p>
+
+https://github.com/user-attachments/assets/c4e89c4f-cc71-4424-8184-bdbc8c638fa1
+
 <p align="center">
     <a href="https://github.com/mobile-next/">
         <img alt="mobile-mcp" src="https://raw.githubusercontent.com/mobile-next/mobile-next-assets/refs/heads/main/mobile-mcp-banner.png" width="600">
     </a>
 </p>
 
-
 ### 🚀 Mobile MCP Roadmap: Building the Future of Mobile
 
 Join us on our journey as we continuously enhance Mobile MCP! 
@@ -64,7 +78,7 @@ More details in our [wiki page](https://github.com/mobile-next/mobile-mcp/wiki)
 
 ## Installation and configuration
 
-Setup our MCP with Cursor, Claude, VS Code, Github Copilot:
+Setup our MCP with Cline, Cursor, Claude, VS Code, Github Copilot:
 
 ```json
 {
@@ -77,11 +91,13 @@ Setup our MCP with Cursor, Claude, VS Code, Github Copilot:
 }
 
 ```
+[Cline:](https://docs.cline.bot/mcp/configuring-mcp-servers) To setup Cline, just add the json above to your MCP settings file. 
+[More in our wiki](https://github.com/mobile-next/mobile-mcp/wiki/Cline) 
 
 [Claude Code:](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)
 
 ```
-claude mcp add mobile -- npx -y @mobilenext/mobile-mcp@latest ⁠
+claude mcp add mobile -- npx -y @mobilenext/mobile-mcp@latest
 ```
 
 [Read more in our wiki](https://github.com/mobile-next/mobile-mcp/wiki)! 🚀
@@ -143,6 +159,7 @@ via Whatsapp/Telegram/Slack to contact "Lauren Trown", thumbs up their response.
 Open Zoom app, schedule a meeting titled "AI Hackathon" for tomorrow at 10 AM with a duration of 1 hour,
 copy the invitation link, and send it via Gmail to contacts "team@example.com".
 ```
+[More prompt examples can be found here.](https://github.com/mobile-next/mobile-mcp/wiki/Prompt-Example-repo-list)
 
 ## Prerequisites
 

package/lib/android.js

@@ -164,6 +164,10 @@ class AndroidRobot {
                 // only provide it if it's true, otherwise don't confuse llm
                 element.focused = true;
             }
+            const resourceId = node["resource-id"];
+            if (resourceId !== null && resourceId !== "") {
+                element.identifier = resourceId;
+            }
             if (element.rect.width > 0 && element.rect.height > 0) {
                 elements.push(element);
             }

package/lib/index.js

@@ -1,17 +1,60 @@
 #!/usr/bin/env node
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+const sse_js_1 = require("@modelcontextprotocol/sdk/server/sse.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const server_1 = require("./server");
 const logger_1 = require("./logger");
-async function main() {
-    const transport = new stdio_js_1.StdioServerTransport();
+const express_1 = __importDefault(require("express"));
+const commander_1 = require("commander");
+const startSseServer = async (port) => {
+    const app = (0, express_1.default)();
     const server = (0, server_1.createMcpServer)();
-    await server.connect(transport);
-    (0, logger_1.error)("mobile-mcp server running on stdio");
-}
-main().catch(err => {
-    console.error("Fatal error in main():", err);
-    (0, logger_1.error)("Fatal error in main(): " + JSON.stringify(err.stack));
-    process.exit(1);
-});
+    let transport = null;
+    app.post("/mcp", (req, res) => {
+        if (transport) {
+            transport.handlePostMessage(req, res);
+        }
+    });
+    app.get("/mcp", (req, res) => {
+        if (transport) {
+            transport.close();
+        }
+        transport = new sse_js_1.SSEServerTransport("/mcp", res);
+        server.connect(transport);
+    });
+    app.listen(port, () => {
+        (0, logger_1.error)(`mobile-mcp ${(0, server_1.getAgentVersion)()} sse server listening on http://localhost:${port}/mcp`);
+    });
+};
+const startStdioServer = async () => {
+    try {
+        const transport = new stdio_js_1.StdioServerTransport();
+        const server = (0, server_1.createMcpServer)();
+        await server.connect(transport);
+        (0, logger_1.error)("mobile-mcp server running on stdio");
+    }
+    catch (err) {
+        console.error("Fatal error in main():", err);
+        (0, logger_1.error)("Fatal error in main(): " + JSON.stringify(err.stack));
+        process.exit(1);
+    }
+};
+const main = async () => {
+    commander_1.program
+        .version((0, server_1.getAgentVersion)())
+        .option("--port <port>", "Start SSE server on this port")
+        .option("--stdio", "Start stdio server (default)")
+        .parse(process.argv);
+    const options = commander_1.program.opts();
+    if (options.port) {
+        await startSseServer(+options.port);
+    }
+    else {
+        await startStdioServer();
+    }
+};
+main().then();

package/lib/iphone-simulator.js

@@ -39,75 +39,13 @@ class Simctl {
     async terminateApp(packageName) {
         this.simctl("terminate", this.simulatorUuid, packageName);
     }
-    static parseIOSAppData(inputText) {
-        const result = [];
-        let ParseState;
-        (function (ParseState) {
-            ParseState[ParseState["LOOKING_FOR_APP"] = 0] = "LOOKING_FOR_APP";
-            ParseState[ParseState["IN_APP"] = 1] = "IN_APP";
-            ParseState[ParseState["IN_PROPERTY"] = 2] = "IN_PROPERTY";
-        })(ParseState || (ParseState = {}));
-        let state = ParseState.LOOKING_FOR_APP;
-        let currentApp = {};
-        let appIdentifier = "";
-        const lines = inputText.split("\n");
-        for (let line of lines) {
-            line = line.trim();
-            if (line === "") {
-                continue;
-            }
-            switch (state) {
-                case ParseState.LOOKING_FOR_APP:
-                    // look for app identifier pattern: "com.example.app" = {
-                    const appMatch = line.match(/^"?([^"=]+)"?\s*=\s*\{/);
-                    if (appMatch) {
-                        appIdentifier = appMatch[1].trim();
-                        currentApp = {
-                            CFBundleIdentifier: appIdentifier,
-                        };
-                        state = ParseState.IN_APP;
-                    }
-                    break;
-                case ParseState.IN_APP:
-                    if (line === "};") {
-                        result.push(currentApp);
-                        currentApp = {};
-                        state = ParseState.LOOKING_FOR_APP;
-                    }
-                    else {
-                        // look for property: PropertyName = Value;
-                        const propertyMatch = line.match(/^([^=]+)\s*=\s*(.+?);\s*$/);
-                        if (propertyMatch) {
-                            const propName = propertyMatch[1].trim();
-                            let propValue = propertyMatch[2].trim();
-                            // remove quotes if present (they're optional)
-                            if (propValue.startsWith('"') && propValue.endsWith('"')) {
-                                propValue = propValue.substring(1, propValue.length - 1);
-                            }
-                            // add property to current app
-                            currentApp[propName] = propValue;
-                        }
-                        else if (line.endsWith("{")) {
-                            // nested property like GroupContainers = {
-                            state = ParseState.IN_PROPERTY;
-                        }
-                    }
-                    break;
-                case ParseState.IN_PROPERTY:
-                    if (line === "};") {
-                        // end of nested property
-                        state = ParseState.IN_APP;
-                    }
-                    // skip content of nested properties, we don't care of those right now
-                    break;
-            }
-        }
-        return result;
-    }
     async listApps() {
         const text = this.simctl("listapps", this.simulatorUuid).toString();
-        const apps = Simctl.parseIOSAppData(text);
-        return apps.map(app => ({
+        const result = (0, child_process_1.execFileSync)("plutil", ["-convert", "json", "-o", "-", "-r", "-"], {
+            input: text,
+        });
+        const output = JSON.parse(result.toString());
+        return Object.values(output).map(app => ({
             packageName: app.CFBundleIdentifier,
             appName: app.CFBundleDisplayName,
         }));

package/lib/server.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMcpServer = void 0;
+exports.createMcpServer = exports.getAgentVersion = void 0;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const zod_1 = require("zod");
 const logger_1 = require("./logger");
@@ -14,6 +14,7 @@ const getAgentVersion = () => {
     const json = require("../package.json");
     return json.version;
 };
+exports.getAgentVersion = getAgentVersion;
 const getLatestAgentVersion = async () => {
     const response = await fetch("https://api.github.com/repos/mobile-next/mobile-mcp/tags?per_page=1");
     const json = await response.json();
@@ -22,7 +23,7 @@ const getLatestAgentVersion = async () => {
 const checkForLatestAgentVersion = async () => {
     try {
         const latestVersion = await getLatestAgentVersion();
-        const currentVersion = getAgentVersion();
+        const currentVersion = (0, exports.getAgentVersion)();
         if (latestVersion !== currentVersion) {
             (0, logger_1.trace)(`You are running an older version of the agent. Please update to the latest version: ${latestVersion}.`);
         }
@@ -34,7 +35,7 @@ const checkForLatestAgentVersion = async () => {
 const createMcpServer = () => {
     const server = new mcp_js_1.McpServer({
         name: "mobile-mcp",
-        version: getAgentVersion(),
+        version: (0, exports.getAgentVersion)(),
         capabilities: {
             resources: {},
             tools: {},
@@ -159,6 +160,7 @@ const createMcpServer = () => {
                 label: element.label,
                 name: element.name,
                 value: element.value,
+                identifier: element.identifier,
                 coordinates: {
                     x: element.rect.x,
                     y: element.rect.y,

package/lib/webdriver-agent.js

@@ -130,12 +130,13 @@ class WebDriverAgent {
         const acceptedTypes = ["TextField", "Button", "Switch", "Icon", "SearchField", "StaticText", "Image"];
         if (acceptedTypes.includes(source.type)) {
             if (source.isVisible === "1" && this.isVisible(source.rect)) {
-                if (source.label !== null || source.name !== null) {
+                if (source.label !== null || source.name !== null || source.rawIdentifier !== null) {
                     output.push({
                         type: source.type,
                         label: source.label,
                         name: source.name,
                         value: source.value,
+                        identifier: source.rawIdentifier,
                         rect: {
                             x: source.rect.x,
                             y: source.rect.y,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobilenext/mobile-mcp",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "description": "Mobile MCP",
   "repository": {
     "type": "git",
@@ -23,6 +23,10 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.6.1",
+    "@types/commander": "^2.12.0",
+    "@types/express": "^5.0.3",
+    "commander": "^14.0.0",
+    "express": "^5.1.0",
     "fast-xml-parser": "^5.0.9",
     "zod-to-json-schema": "^3.24.4"
   },
@@ -40,8 +44,8 @@
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-notice": "^1.0.0",
     "husky": "^9.1.7",
-    "nyc": "^17.1.0",
     "mocha": "^11.1.0",
+    "nyc": "^17.1.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.2"
   },