@mobilenext/mobile-mcp 0.0.8 → 0.0.9

package/README.md

@@ -73,29 +73,28 @@ What you will need to connect MCP with your agent and mobile devices:
 ### Simulators, Emulators, and Physical 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 Simulators on macOS/Linux
+- Android Emulators on Linux/Windows/macOS
+- Physical iOS or Android 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 an actual phone connected, you can run Mobile Next Mobile MCP with an emulator or simulator in the background.
+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.
 
 For example, on Android:
-	1.	Start an emulator (avdmanager / emulator command).
-	2.	Run Mobile MCP with the desired flags
+1. Start an emulator (avdmanager / emulator command).
+2. Run Mobile MCP with the desired flags
 
 On iOS, you'll need Xcode and to run the Simulator before using Mobile MCP with that simulator instance.
-`xcrun simctl list`
-`xcrun simctl boot "iPhone 16"`
+- `xcrun simctl list`
+- `xcrun simctl boot "iPhone 16"`
 
 
 # Mobile Commands and interaction tools
 
-These tools use accessibility-based element references on iOS or Android. By relying on the accessibility/automation IDs, you avoid the ambiguity of coordinate-based approaches.
+The commands and tools support both accessibility-based locators (preferred) and coordinate-based inputs, giving you flexibility when accessibility/automation IDs are missing for reliable and seemless automation.
 
 ## mobile_install_app
 - **Description:** Installs an app onto the device/emulator

package/lib/index.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
@@ -7,7 +8,7 @@ async function main() {
     const transport = new stdio_js_1.StdioServerTransport();
     const server = (0, server_1.createMcpServer)();
     await server.connect(transport);
-    (0, logger_1.error)("Appium MCP Server running on stdio");
+    (0, logger_1.error)("mobile-mcp server running on stdio");
 }
 main().catch(err => {
     console.error("Fatal error in main():", err);

package/lib/server.js

@@ -16,7 +16,7 @@ const getAgentVersion = () => {
 };
 const createMcpServer = () => {
     const server = new mcp_js_1.McpServer({
-        name: "appium-mcp",
+        name: "mobile-mcp",
         version: getAgentVersion(),
         capabilities: {
             resources: {},
@@ -43,7 +43,7 @@ const createMcpServer = () => {
         };
         server.tool(name, description, paramsSchema, args => wrappedCb(args));
     };
-    tool("list-apps-on-device", "List all apps on device", {}, async ({}) => {
+    tool("list_apps_on_device", "List all apps on device", {}, async ({}) => {
         /*
         const result = execSync(`adb shell pm list packages`)
             .toString()
@@ -54,17 +54,17 @@ const createMcpServer = () => {
         const result = (0, android_1.listApps)();
         return `Found these packages on device: ${result.join(",")}`;
     });
-    tool("launch-app", "Launch an app on mobile device", {
+    tool("launch_app", "Launch an app on mobile device", {
         packageName: zod_1.z.string().describe("The package name of the app to launch"),
     }, async ({ packageName }) => {
         (0, child_process_1.execSync)(`adb shell monkey -p "${packageName}" -c android.intent.category.LAUNCHER 1`);
         return `Launched app ${packageName}`;
     });
-    tool("get-screen-size", "Get the screen size of the mobile device in pixels", {}, async ({}) => {
+    tool("get_screen_size", "Get the screen size of the mobile device in pixels", {}, async ({}) => {
         const screenSize = (0, android_1.getScreenSize)();
         return `Screen size is ${screenSize[0]}x${screenSize[1]} pixels`;
     });
-    tool("click-on-screen-at-coordinates", "Click on the screen at given x,y coordinates", {
+    tool("click_on_screen_at_coordinates", "Click on the screen at given x,y coordinates", {
         x: zod_1.z.number().describe("The x coordinate to click between 0 and 1"),
         y: zod_1.z.number().describe("The y coordinate to click between 0 and 1"),
     }, async ({ x, y }) => {
@@ -74,36 +74,36 @@ const createMcpServer = () => {
         (0, child_process_1.execSync)(`adb shell input tap ${x0} ${y0}`);
         return `Clicked on screen at coordinates: ${x}, ${y}`;
     });
-    tool("list-elements-on-screen", "List elements on screen and their coordinates, based on text or accessibility label", {}, async ({}) => {
+    tool("list_elements_on_screen", "List elements on screen and their coordinates, based on text or accessibility label", {}, async ({}) => {
         const elements = (0, android_1.getElementsOnScreen)();
         return `Found these elements on screen: ${JSON.stringify(elements)}`;
     });
-    tool("press-button", "Press a button on device", {
+    tool("press_button", "Press a button on device", {
         button: zod_1.z.string().describe("The button to press. Supported buttons: KEYCODE_BACK, KEYCODE_HOME, KEYCODE_MENU, KEYCODE_VOLUME_UP, KEYCODE_VOLUME_DOWN, KEYCODE_ENTER"),
     }, async ({ button }) => {
         (0, child_process_1.execSync)(`adb shell input keyevent ${button}`);
         return `Pressed the button: ${button}`;
     });
-    tool("open-url", "Open a URL in browser on device", {
+    tool("open_url", "Open a URL in browser on device", {
         url: zod_1.z.string().describe("The URL to open"),
     }, async ({ url }) => {
         (0, child_process_1.execSync)(`adb shell am start -a android.intent.action.VIEW -d "${url}"`);
         return `Opened URL: ${url}`;
     });
-    tool("swipe-on-screen", "Swipe on the screen", {
+    tool("swipe_on_screen", "Swipe on the screen", {
         direction: zod_1.z.enum(["up", "down"]).describe("The direction to swipe"),
     }, async ({ direction }) => {
         (0, android_1.swipe)(direction);
         return `Swiped ${direction} on screen`;
     });
-    tool("type-text", "Type text into the focused element", {
+    tool("type_text", "Type text into the focused element", {
         text: zod_1.z.string().describe("The text to type"),
     }, async ({ text }) => {
         const _text = text.replace(/ /g, "\\ ");
         (0, child_process_1.execSync)(`adb shell input text "${_text}"`);
         return `Typed text: ${text}`;
     });
-    server.tool("take-device-screenshot", "Take a screenshot of the mobile device", {}, async ({}) => {
+    server.tool("take_device_screenshot", "Take a screenshot of the mobile device", {}, async ({}) => {
         try {
             const screenshot = await (0, android_1.takeScreenshot)();
             // Scale down the screenshot by 50%

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobilenext/mobile-mcp",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Mobile MCP",
   "repository": {
     "type": "git",
@@ -11,10 +11,9 @@
   },
   "license": "Apache-2.0",
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && chmod +x lib/index.js",
     "lint": "eslint .",
     "watch": "tsc --watch",
-    "start": "node lib/index.js",
     "clean": "rm -rf lib"
   },
   "exports": {
@@ -45,6 +44,9 @@
     "typescript": "^5.8.2"
   },
   "main": "index.js",
+  "bin": {
+    "mcp-server-mobile": "lib/index.js"
+  },
   "directories": {
     "lib": "lib"
   },