@mobilenext/mobile-mcp 0.0.24 → 0.0.25

package/README.md

@@ -1,38 +1,40 @@
-# Mobile Next - MCP server for Mobile Development and Automation  | iOS, Android, Simulator, Emulator, and physical devices
+# Mobile Next - MCP server for Mobile Development and Automation | iOS, Android, Simulator, Emulator, and Real Devices
 
-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 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 real 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.
 
 <h4 align="center">
-<a href="https://github.com/mobile-next/mobile-mcp">
+  <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">
+  <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/npm/dm/@mobilenext/mobile-mcp?logo=npm&style=flat&color=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/releases">
-    <img src="https://img.shields.io/github/release/mobile-next/mobile-mcp">
+  <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 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>
+  <a href="https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22mobile-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40mobilenext%2Fmobile-mcp%40latest%22%5D%7D">
+    <img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code" />
+  </a>
+</h4>
 
 <h4 align="center">
-<a href="http://mobilenexthq.com/join-slack">
+  <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>
+  </a>
+</h4>
 
 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">
+        <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>
 
@@ -49,7 +51,7 @@ Check out our detailed roadmap to see upcoming features, improvements, and miles
 How we help to scale mobile automation:
 
 - 📲 Native app automation (iOS and Android) for testing or data-entry scenarios.
-- 📝 Scripted flows and form interactions without manually controlling simulators/emulators or physical devices (iPhone, Samsung, Google Pixel etc)
+- 📝 Scripted flows and form interactions without manually controlling simulators/emulators or real devices (iPhone, Samsung, Google Pixel etc)
 - 🧭 Automating multi-step user journeys driven by an LLM
 - 👆 General-purpose mobile application interaction for agent-based frameworks
 - 🤖 Enables agent-to-agent communication for mobile automation usecases, data extraction
@@ -178,18 +180,18 @@ What you will need to connect MCP with your agent and mobile devices:
 - [node.js](https://nodejs.org/en/download/) v22+
 - [MCP](https://modelcontextprotocol.io/introduction) supported foundational models or agents, like [Claude MCP](https://modelcontextprotocol.io/quickstart/server), [OpenAI Agent SDK](https://openai.github.io/openai-agents-python/mcp/), [Copilot Studio](https://www.microsoft.com/en-us/microsoft-copilot/blog/copilot-studio/introducing-model-context-protocol-mcp-in-copilot-studio-simplified-integration-with-ai-apps-and-agents/)
 
-### Simulators, Emulators, and Physical Devices
+### Simulators, Emulators, and Real Devices
 
 When launched, Mobile MCP can connect to:
 - iOS Simulators on macOS/Linux
 - Android Emulators on Linux/Windows/macOS
-- Physical iOS or Android devices (requires proper platform tools and drivers)
+- iOS or Android real devices (requires proper platform tools and drivers)
 
 Make sure you have your mobile platform SDKs (Xcode, Android SDK) installed and configured properly before running Mobile Next Mobile MCP.
 
 ### Running in "headless" mode on Simulators/Emulators
 
-When you do not have a physical phone connected to your machine, you can run Mobile MCP with an emulator or simulator in the background.
+When you do not have a real device connected to your machine, you can run Mobile MCP with an emulator or simulator in the background.
 
 For example, on Android:
 1. Start an emulator (avdmanager / emulator command).

package/lib/android.js

@@ -39,14 +39,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AndroidDeviceManager = exports.AndroidRobot = void 0;
 const node_path_1 = __importDefault(require("node:path"));
 const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
 const xml = __importStar(require("fast-xml-parser"));
 const robot_1 = require("./robot");
 const getAdbPath = () => {
-    let executable = "adb";
     if (process.env.ANDROID_HOME) {
-        executable = node_path_1.default.join(process.env.ANDROID_HOME, "platform-tools", "adb");
+        return node_path_1.default.join(process.env.ANDROID_HOME, "platform-tools", "adb");
     }
-    return executable;
+    const defaultAndroidSdk = node_path_1.default.join(process.env.HOME || "", "Library", "Android", "sdk", "platform-tools", "adb");
+    if ((0, node_fs_1.existsSync)(defaultAndroidSdk)) {
+        return defaultAndroidSdk;
+    }
+    return "adb";
 };
 const BUTTON_MAP = {
     "BACK": "KEYCODE_BACK",
@@ -275,6 +279,10 @@ class AndroidRobot {
     isAscii(text) {
         return /^[\x00-\x7F]*$/.test(text);
     }
+    escapeShellText(text) {
+        // escape all shell special characters that could be used for injection
+        return text.replace(/[\\'"` \t\n\r|&;()<>{}[\]$*?]/g, "\\$&");
+    }
     async isDeviceKitInstalled() {
         const packages = await this.listPackages();
         return packages.includes("com.mobilenext.devicekit");
@@ -288,7 +296,7 @@ class AndroidRobot {
         if (this.isAscii(text)) {
             // adb shell input only supports ascii characters. and
             // some of the keys have to be escaped.
-            const _text = text.replace(/ /g, "\\ ");
+            const _text = this.escapeShellText(text);
             this.adb("shell", "input", "text", _text);
         }
         else if (await this.isDeviceKitInstalled()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobilenext/mobile-mcp",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "description": "Mobile MCP",
   "repository": {
     "type": "git",
@@ -13,6 +13,7 @@
   "scripts": {
     "build": "tsc && chmod +x lib/index.js",
     "lint": "eslint .",
+    "fixlint": "eslint . --fix",
     "test": "nyc mocha --require ts-node/register test/*.ts",
     "watch": "tsc --watch",
     "clean": "rm -rf lib",