@mobilenext/mobile-mcp 0.0.34 → 0.0.36

package/README.md

@@ -67,6 +67,47 @@ How we help to scale mobile automation:
 - 📊 **Deterministic tool application**: Reduces ambiguity found in purely screenshot-based approaches by relying on structured data whenever possible.
 - 📺 **Extract structured data**: Enables you to extract structred data from anything visible on screen.
 
+## 🔧 Available MCP Tools
+
+<details>
+<summary>📱 <strong>Click to expand tool list</strong> - List of Mobile MCP tools for automation and development</summary>
+
+> For detailed implementation and parameter specifications, see [`src/server.ts`](src/server.ts)
+
+### Device Management
+- **`mobile_list_available_devices`** - List all available devices (simulators, emulators, and real devices)
+- **`mobile_get_screen_size`** - Get the screen size of the mobile device in pixels
+- **`mobile_get_orientation`** - Get the current screen orientation of the device
+- **`mobile_set_orientation`** - Change the screen orientation (portrait/landscape)
+
+### App Management
+- **`mobile_list_apps`** - List all installed apps on the device
+- **`mobile_launch_app`** - Launch an app using its package name
+- **`mobile_terminate_app`** - Stop and terminate a running app
+- **`mobile_install_app`** - Install an app from file (.apk, .ipa, .app, .zip)
+- **`mobile_uninstall_app`** - Uninstall an app using bundle ID or package name
+
+### Screen Interaction
+- **`mobile_take_screenshot`** - Take a screenshot to understand what's on screen
+- **`mobile_save_screenshot`** - Save a screenshot to a file
+- **`mobile_list_elements_on_screen`** - List UI elements with their coordinates and properties
+- **`mobile_click_on_screen_at_coordinates`** - Click at specific x,y coordinates
+- **`mobile_double_tap_on_screen`** - Double-tap at specific coordinates
+- **`mobile_long_press_on_screen_at_coordinates`** - Long press at specific coordinates
+- **`mobile_swipe_on_screen`** - Swipe in any direction (up, down, left, right)
+
+### Input & Navigation
+- **`mobile_type_keys`** - Type text into focused elements with optional submit
+- **`mobile_press_button`** - Press device buttons (HOME, BACK, VOLUME_UP/DOWN, ENTER, etc.)
+- **`mobile_open_url`** - Open URLs in the device browser
+
+### Platform Support
+- **iOS**: Simulators and real devices via native accessibility and WebDriverAgent
+- **Android**: Emulators and real devices via ADB and UI Automator
+- **Cross-platform**: Unified API works across both iOS and Android
+
+</details>
+
 ## 🏗️ Mobile MCP Architecture
 
 <p align="center">

package/lib/android.js

@@ -43,8 +43,9 @@ const node_fs_1 = require("node:fs");
 const xml = __importStar(require("fast-xml-parser"));
 const robot_1 = require("./robot");
 const getAdbPath = () => {
+    const exeName = process.env.platform === "win32" ? "adb.exe" : "adb";
     if (process.env.ANDROID_HOME) {
-        return node_path_1.default.join(process.env.ANDROID_HOME, "platform-tools", "adb");
+        return node_path_1.default.join(process.env.ANDROID_HOME, "platform-tools", exeName);
     }
     if (process.platform === "win32" && process.env.LOCALAPPDATA) {
         const windowsAdbPath = node_path_1.default.join(process.env.LOCALAPPDATA, "Android", "Sdk", "platform-tools", "adb.exe");
@@ -52,14 +53,14 @@ const getAdbPath = () => {
             return windowsAdbPath;
         }
     }
-    if (process.env.HOME) {
+    if (process.platform === "darwin" && process.env.HOME) {
         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;
         }
     }
     // fallthrough, hope for the best
-    return "adb";
+    return exeName;
 };
 const BUTTON_MAP = {
     "BACK": "KEYCODE_BACK",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mobilenext/mobile-mcp",
   "mcpName": "io.github.mobile-next/mobile-mcp",
-  "version": "0.0.34",
+  "version": "0.0.36",
   "description": "Mobile MCP",
   "repository": {
     "type": "git",
@@ -31,7 +31,7 @@
     "zod-to-json-schema": "3.24.6"
   },
   "optionalDependencies": {
-    "@mobilenext/mobilecli": "0.0.33"
+    "@mobilenext/mobilecli": "0.0.38"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",