mobile-debug-mcp 0.1.0 → 0.3.0

package/README.md

@@ -25,7 +25,9 @@
 
 ## Installation
 
-Clone the repo and build:
+You can install and use **Mobile Debug MCP** in one of two ways:
+
+### 1. Clone the repository for local development
 
 ```bash
 git clone https://github.com/YOUR_USERNAME/mobile-debug-mcp.git
@@ -34,30 +36,40 @@ npm install
 npm run build
 ```
 
-Alternatively, you can publish to npm and install globally:
+This option is suitable if you want to modify or contribute to the code.
+
+### 2. Install via npm for standard use
 
 ```bash
 npm install -g mobile-debug-mcp
 ```
 
+This option installs the package globally for easy use without cloning the repo.
+
 ---
 
 ## MCP Server Configuration
 
-Example WebUI MCP config:
+Example WebUI MCP config using `npx --yes` and `ADB_PATH` environment variable:
 
 ```json
 {
   "mcpServers": {
     "mobile-debug": {
-      "command": "node",
-      "args": ["/full/path/to/mobile-debug-mcp/dist/server.js"]
+      "command": "npx",
+      "args": [
+        "--yes",
+        "mobile-debug-mcp",
+        "server",
+        "--adb-path",
+        "${ADB_PATH}"
+      ]
     }
   }
 }
 ```
 
-> Make sure to replace `/full/path/to/` with your actual project path.
+> Make sure to set the `ADB_PATH` environment variable to the full path of your `adb` executable.
 
 ---
 
@@ -80,7 +92,7 @@ Launch a mobile app.
 ```json
 {
   "platform": "android",
-  "id": "com.modul8.app"
+  "id": "com.example.app"
 }
 ```
 
@@ -92,6 +104,7 @@ Fetch recent logs from the app.
 ```json
 {
   "platform": "android" | "ios",
+  "id": "com.example.app", // Android package or iOS bundle ID (required)
   "lines": 200 // optional, Android only
 }
 ```
@@ -101,6 +114,7 @@ Fetch recent logs from the app.
 ```json
 {
   "platform": "android",
+  "id": "com.example.app",
   "lines": 200
 }
 ```
@@ -118,7 +132,7 @@ Fetch recent logs from the app.
 
 ## Notes
 
-- Ensure `adb` and `xcrun` are in your PATH.
+- Ensure `adb` and `xcrun` are in your PATH or set `ADB_PATH` accordingly.
 - For iOS, the simulator must be booted before using `start_app` or `get_logs`.
 - You may want to clear Android logs before launching for cleaner output: `adb logcat -c`
 

package/dist/server.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "mobile-debug-mcp",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "bin": {
     "mobile-debug-mcp": "./dist/server.js"
   },
   "scripts": {
     "build": "tsc",
-    "start": "node ./dist/server.js"
+    "start": "node ./dist/server.js",
+    "prepare": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0"

package/src/server.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js"
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import {