mobile-debug-mcp 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -25,9 +25,7 @@
25
25
 
26
26
  ## Installation
27
27
 
28
- You can install and use **Mobile Debug MCP** in one of two ways:
29
-
30
- ### 1. Clone the repository for local development
28
+ Clone the repo and build:
31
29
 
32
30
  ```bash
33
31
  git clone https://github.com/YOUR_USERNAME/mobile-debug-mcp.git
@@ -36,40 +34,30 @@ npm install
36
34
  npm run build
37
35
  ```
38
36
 
39
- This option is suitable if you want to modify or contribute to the code.
40
-
41
- ### 2. Install via npm for standard use
37
+ Alternatively, you can publish to npm and install globally:
42
38
 
43
39
  ```bash
44
40
  npm install -g mobile-debug-mcp
45
41
  ```
46
42
 
47
- This option installs the package globally for easy use without cloning the repo.
48
-
49
43
  ---
50
44
 
51
45
  ## MCP Server Configuration
52
46
 
53
- Example WebUI MCP config using `npx --yes` and `ADB_PATH` environment variable:
47
+ Example WebUI MCP config:
54
48
 
55
49
  ```json
56
50
  {
57
51
  "mcpServers": {
58
52
  "mobile-debug": {
59
- "command": "npx",
60
- "args": [
61
- "--yes",
62
- "mobile-debug-mcp",
63
- "server",
64
- "--adb-path",
65
- "${ADB_PATH}"
66
- ]
53
+ "command": "node",
54
+ "args": ["/full/path/to/mobile-debug-mcp/dist/server.js"]
67
55
  }
68
56
  }
69
57
  }
70
58
  ```
71
59
 
72
- > Make sure to set the `ADB_PATH` environment variable to the full path of your `adb` executable.
60
+ > Make sure to replace `/full/path/to/` with your actual project path.
73
61
 
74
62
  ---
75
63
 
@@ -92,7 +80,7 @@ Launch a mobile app.
92
80
  ```json
93
81
  {
94
82
  "platform": "android",
95
- "id": "com.example.app"
83
+ "id": "com.modul8.app"
96
84
  }
97
85
  ```
98
86
 
@@ -104,7 +92,6 @@ Fetch recent logs from the app.
104
92
  ```json
105
93
  {
106
94
  "platform": "android" | "ios",
107
- "id": "com.example.app", // Android package or iOS bundle ID (required)
108
95
  "lines": 200 // optional, Android only
109
96
  }
110
97
  ```
@@ -114,7 +101,6 @@ Fetch recent logs from the app.
114
101
  ```json
115
102
  {
116
103
  "platform": "android",
117
- "id": "com.example.app",
118
104
  "lines": 200
119
105
  }
120
106
  ```
@@ -132,7 +118,7 @@ Fetch recent logs from the app.
132
118
 
133
119
  ## Notes
134
120
 
135
- - Ensure `adb` and `xcrun` are in your PATH or set `ADB_PATH` accordingly.
121
+ - Ensure `adb` and `xcrun` are in your PATH.
136
122
  - For iOS, the simulator must be booted before using `start_app` or `get_logs`.
137
123
  - You may want to clear Android logs before launching for cleaner output: `adb logcat -c`
138
124
 
package/dist/server.js CHANGED
@@ -1,4 +1,3 @@
1
- #!/usr/bin/env node
2
1
  import { Server } from "@modelcontextprotocol/sdk/server/index.js";
3
2
  import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
4
3
  import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
package/dist/types.js ADDED
@@ -0,0 +1 @@
1
+ export {};
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "mobile-debug-mcp",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
+ "description": "MCP server for mobile app debugging (Android + iOS), with focus on security and reliability",
4
5
  "type": "module",
5
6
  "bin": {
6
7
  "mobile-debug-mcp": "./dist/server.js"
@@ -14,6 +15,11 @@
14
15
  "node": ">=18"
15
16
  },
16
17
  "dependencies": {
17
- "@modelcontextprotocol/sdk": "^1.0.0"
18
+ "@modelcontextprotocol/sdk": "^1.0.0",
19
+ "zod": "^3.23.0"
20
+ },
21
+ "devDependencies": {
22
+ "@types/node": "^25.4.0",
23
+ "typescript": "^5.9.3"
18
24
  }
19
25
  }
package/src/server.ts CHANGED
@@ -1,4 +1,3 @@
1
- #!/usr/bin/env node
2
1
  import { Server } from "@modelcontextprotocol/sdk/server/index.js"
3
2
  import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
4
3
  import {