@ggboi360/mobile-dev-mcp 0.1.0 → 0.2.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/LICENSE CHANGED
@@ -1,53 +1,48 @@
1
- Elastic License 2.0 (ELv2)
1
+ # Mobile Dev MCP - Dual License
2
2
 
3
- ## Acceptance
3
+ This project uses a dual-license model ("Open Core"):
4
4
 
5
- By using the software, you agree to all of the terms and conditions below.
5
+ ## Basic Tools (17 tools) - MIT License
6
6
 
7
- ## Copyright License
7
+ The **17 core tools** in the Basic tier are licensed under the **MIT License**.
8
+ See [LICENSE-MIT](LICENSE-MIT) for the full text.
8
9
 
9
- The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject to the limitations and conditions below.
10
+ These tools are free to use, modify, and distribute:
11
+ - get_metro_logs, get_adb_logs, screenshot_emulator, list_devices
12
+ - check_metro_status, get_app_info, clear_app_data, restart_adb
13
+ - get_device_info, start_metro_logging, stop_metro_logging
14
+ - list_ios_simulators, screenshot_ios_simulator, get_ios_simulator_logs
15
+ - get_ios_simulator_info, get_license_status, set_license_key
10
16
 
11
- ## Limitations
17
+ ## Advanced Tools (39 tools) - Elastic License 2.0
12
18
 
13
- You may not provide the software to third parties as a hosted or managed service, where the service provides users with access to any substantial set of the features or functionality of the software.
19
+ The **39 advanced tools** are licensed under the **Elastic License 2.0**.
20
+ See [LICENSE-ELASTIC](LICENSE-ELASTIC) for the full text.
14
21
 
15
- You may not move, change, disable, or circumvent the license key functionality in the software, and you may not remove or obscure any functionality in the software that is protected by the license key.
22
+ This means:
23
+ - You CAN use them for personal or commercial projects
24
+ - You CAN modify and create derivative works
25
+ - You CANNOT offer this as a hosted/managed service
26
+ - You CANNOT remove or circumvent the license key functionality
16
27
 
17
- You may not alter, remove, or obscure any licensing, copyright, or other notices of the licensor in the software. Any use of the licensor's trademarks is subject to applicable law.
28
+ Advanced tools include:
29
+ - Streaming & monitoring (stream_adb_realtime, screenshot_history, etc.)
30
+ - Device interaction (tap_screen, input_text, swipe_screen, etc.)
31
+ - iOS Simulator advanced (boot/shutdown, app management, push notifications)
32
+ - React DevTools integration
33
+ - Network inspection
34
+ - Expo DevTools integration
35
+ - Performance metrics
18
36
 
19
- ## Patents
37
+ ## Why Dual License?
20
38
 
21
- The licensor grants you a license, under any patent claims the licensor can license, or becomes able to license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case subject to the limitations and conditions in this license. This license does not cover any patent claims that you cause to be infringed by modifications or additions to the software. If you or your company make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
39
+ We believe in open source while also needing to sustain development:
22
40
 
23
- ## Notices
41
+ - **MIT for Basic**: Enables the community to freely use, learn from, and contribute to core functionality
42
+ - **Elastic for Advanced**: Protects the commercial features that fund ongoing development
24
43
 
25
- You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms.
44
+ ## Questions?
26
45
 
27
- If you modify the software, you must include in any modified copies of the software prominent notices stating that you have modified the software.
28
-
29
- ## No Other Rights
30
-
31
- These terms do not imply any licenses other than those expressly granted in these terms.
32
-
33
- ## Termination
34
-
35
- If you use the software in violation of these terms, such use is not licensed, and your licenses will automatically terminate. If the licensor provides you with a notice of your violation, and you cease all violation of this license no later than 30 days after you receive that notice, your licenses will be reinstated retroactively. However, if you violate these terms after such reinstatement, any additional violation of these terms will cause your licenses to terminate automatically and permanently.
36
-
37
- ## No Liability
38
-
39
- *As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.*
40
-
41
- ## Definitions
42
-
43
- The **licensor** is the entity offering these terms, and the **software** is the software the licensor makes available under these terms, including any portion of it.
44
-
45
- **you** refers to the individual or entity agreeing to these terms.
46
-
47
- **your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. **control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.
48
-
49
- **your licenses** are all the licenses granted to you for the software under these terms.
50
-
51
- **use** means anything you do with the software requiring one of your licenses.
52
-
53
- **trademark** means trademarks, service marks, and similar rights.
46
+ - GitHub: https://github.com/GGBoi360/mobile-dev-mcp
47
+ - Twitter: @GiliboiGabay
48
+ - Email: GiladGabay@proton.me
@@ -0,0 +1,83 @@
1
+ Elastic License 2.0 (ELv2)
2
+
3
+ This license applies to the 39 Advanced tier tools in Mobile Dev MCP.
4
+
5
+ ## Acceptance
6
+
7
+ By using the software, you agree to all of the terms and conditions below.
8
+
9
+ ## Copyright License
10
+
11
+ The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject to the limitations and conditions below.
12
+
13
+ ## Limitations
14
+
15
+ You may not provide the software to third parties as a hosted or managed service, where the service provides users with access to any substantial set of the features or functionality of the software.
16
+
17
+ You may not move, change, disable, or circumvent the license key functionality in the software, and you may not remove or obscure any functionality in the software that is protected by the license key.
18
+
19
+ You may not alter, remove, or obscure any licensing, copyright, or other notices of the licensor in the software. Any use of the licensor's trademarks is subject to applicable law.
20
+
21
+ ## Patents
22
+
23
+ The licensor grants you a license, under any patent claims the licensor can license, or becomes able to license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case subject to the limitations and conditions in this license. This license does not cover any patent claims that you cause to be infringed by modifications or additions to the software. If you or your company make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
24
+
25
+ ## Notices
26
+
27
+ You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms.
28
+
29
+ If you modify the software, you must include in any modified copies of the software prominent notices stating that you have modified the software.
30
+
31
+ ## No Other Rights
32
+
33
+ These terms do not imply any licenses other than those expressly granted in these terms.
34
+
35
+ ## Termination
36
+
37
+ If you use the software in violation of these terms, such use is not licensed, and your licenses will automatically terminate. If the licensor provides you with a notice of your violation, and you cease all violation of this license no later than 30 days after you receive that notice, your licenses will be reinstated retroactively. However, if you violate these terms after such reinstatement, any additional violation of these terms will cause your licenses to terminate automatically and permanently.
38
+
39
+ ## No Liability
40
+
41
+ *As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.*
42
+
43
+ ## Definitions
44
+
45
+ The **licensor** is the entity offering these terms, and the **software** is the software the licensor makes available under these terms, including any portion of it.
46
+
47
+ **you** refers to the individual or entity agreeing to these terms.
48
+
49
+ **your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. **control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.
50
+
51
+ **your licenses** are all the licenses granted to you for the software under these terms.
52
+
53
+ **use** means anything you do with the software requiring one of your licenses.
54
+
55
+ **trademark** means trademarks, service marks, and similar rights.
56
+
57
+ ---
58
+
59
+ This Elastic License 2.0 applies to the following 39 Advanced tier tools:
60
+
61
+ **Android Streaming & Monitoring:**
62
+ - stream_adb_realtime, stop_adb_streaming, screenshot_history, watch_for_errors, multi_device_logs
63
+
64
+ **Android Interaction:**
65
+ - tap_screen, input_text, press_button, swipe_screen, launch_app, install_apk
66
+
67
+ **iOS Simulator Advanced:**
68
+ - boot_ios_simulator, shutdown_ios_simulator, install_ios_app, launch_ios_app
69
+ - terminate_ios_app, ios_open_url, ios_push_notification, ios_set_location
70
+
71
+ **React DevTools:**
72
+ - setup_react_devtools, check_devtools_connection, get_react_component_tree
73
+ - inspect_react_component, search_react_components
74
+
75
+ **Network Inspection:**
76
+ - get_network_requests, start_network_monitoring, stop_network_monitoring
77
+ - get_network_stats, analyze_request
78
+
79
+ **Expo DevTools:**
80
+ - check_expo_status, get_expo_config, expo_dev_menu, expo_reload, get_eas_builds
81
+
82
+ **Performance Metrics:**
83
+ - get_cpu_usage, get_memory_usage, get_fps_stats, get_battery_stats, get_performance_snapshot
package/LICENSE-MIT ADDED
@@ -0,0 +1,43 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 GGBoi360
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
22
+
23
+ ---
24
+
25
+ This MIT License applies to the following 17 Basic tier tools:
26
+
27
+ - get_metro_logs
28
+ - get_adb_logs
29
+ - screenshot_emulator
30
+ - list_devices
31
+ - check_metro_status
32
+ - get_app_info
33
+ - clear_app_data
34
+ - restart_adb
35
+ - get_device_info
36
+ - start_metro_logging
37
+ - stop_metro_logging
38
+ - list_ios_simulators
39
+ - screenshot_ios_simulator
40
+ - get_ios_simulator_logs
41
+ - get_ios_simulator_info
42
+ - get_license_status
43
+ - set_license_key
package/README.md CHANGED
@@ -1,7 +1,13 @@
1
1
  # Claude Mobile Dev MCP
2
2
 
3
+ [![npm version](https://img.shields.io/npm/v/@ggboi360/mobile-dev-mcp.svg)](https://www.npmjs.com/package/@ggboi360/mobile-dev-mcp)
4
+ [![License: MIT (Core)](https://img.shields.io/badge/License-MIT%20(Core)-green.svg)](LICENSE-MIT)
5
+ [![License: Elastic 2.0 (Advanced)](https://img.shields.io/badge/License-Elastic%202.0%20(Advanced)-blue.svg)](LICENSE-ELASTIC)
6
+
3
7
  An MCP (Model Context Protocol) server that gives Claude real-time access to mobile development tools. Stop copy-pasting logs and screenshots - let Claude see your app directly!
4
8
 
9
+ **Open Core**: 17 core tools are MIT licensed (free forever). 39 advanced tools are source-available under Elastic License 2.0.
10
+
5
11
  ## Features
6
12
 
7
13
  - **Metro Log Streaming** - Claude can read Metro bundler output in real-time
@@ -11,30 +17,44 @@ An MCP (Model Context Protocol) server that gives Claude real-time access to mob
11
17
  - **Device Management** - List devices, check status, restart ADB
12
18
  - **App Management** - Get app info, clear data for fresh testing
13
19
  - **React DevTools Integration** - Inspect React component trees, props, and state
20
+ - **Expo DevTools Integration** - Check Expo server status, manage config, trigger reloads, EAS builds
21
+ - **Performance Metrics** - CPU, memory, FPS, and battery monitoring for your app
14
22
 
15
23
  ## Pricing
16
24
 
17
25
  | Tier | Price | Features |
18
26
  |------|-------|----------|
19
- | **TRIAL** | Free (50 requests) | Try all 41 tools, then purchase to continue |
27
+ | **TRIAL** | Free (50 requests) | Try all 56 tools, then purchase to continue |
20
28
  | **BASIC** | $6/month | 17 core tools (Android + iOS basics), 50 log lines max, 1 device |
21
- | **ADVANCED** | $8/week, $12/month, or $99/year | All 41 tools, unlimited logs, 3 devices, real-time streaming, React DevTools |
29
+ | **ADVANCED** | $8/week, $12/month, or $99/year | All 56 tools, unlimited logs, 3 devices, streaming, DevTools, network, Expo, performance |
22
30
 
23
31
  Purchase at: https://mobile-dev-mcp.com
24
32
 
25
33
  ## Installation
26
34
 
27
- ### Option 1: Claude Code Plugin (Recommended)
35
+ ### Option 1: NPX (Recommended)
28
36
  ```bash
29
- # In Claude Code
30
- /plugin install GGBoi360/claude-mobile-dev-mcp
37
+ # Add to Claude Code
38
+ claude mcp add mobile-dev -- npx @ggboi360/mobile-dev-mcp
31
39
  ```
32
40
 
33
- ### Option 2: Manual MCP Setup
41
+ Or add to your `~/.claude/claude_desktop_config.json`:
42
+ ```json
43
+ {
44
+ "mcpServers": {
45
+ "mobile-dev": {
46
+ "command": "npx",
47
+ "args": ["@ggboi360/mobile-dev-mcp"]
48
+ }
49
+ }
50
+ }
51
+ ```
52
+
53
+ ### Option 2: Manual Setup (Development)
34
54
  ```bash
35
55
  # Clone the repo
36
- git clone https://github.com/GGBoi360/claude-mobile-dev-mcp.git
37
- cd claude-mobile-dev-mcp
56
+ git clone https://github.com/GGBoi360/mobile-dev-mcp.git
57
+ cd mobile-dev-mcp
38
58
 
39
59
  # Install dependencies
40
60
  npm install
@@ -43,12 +63,7 @@ npm install
43
63
  npm run build
44
64
 
45
65
  # Add to Claude Code
46
- claude mcp add mobile-dev -- node /path/to/claude-mobile-dev-mcp/dist/index.js
47
- ```
48
-
49
- ### Option 3: NPX (Coming Soon)
50
- ```bash
51
- claude mcp add mobile-dev -- npx claude-mobile-dev-mcp
66
+ claude mcp add mobile-dev -- node /path/to/mobile-dev-mcp/dist/index.js
52
67
  ```
53
68
 
54
69
  ## Requirements
@@ -135,6 +150,36 @@ claude mcp add mobile-dev -- npx claude-mobile-dev-mcp
135
150
  | `inspect_react_component` | Inspect a component's props, state, and hooks |
136
151
  | `search_react_components` | Search for components by name |
137
152
 
153
+ ### Advanced Tools - Network Inspection (Advanced Tier Only)
154
+
155
+ | Tool | Description |
156
+ |------|-------------|
157
+ | `get_network_requests` | Get recent HTTP/HTTPS requests from app logs |
158
+ | `start_network_monitoring` | Start real-time network request capture |
159
+ | `stop_network_monitoring` | Stop monitoring and get summary |
160
+ | `get_network_stats` | Get device network statistics (WiFi, data usage) |
161
+ | `analyze_request` | Analyze a specific captured request in detail |
162
+
163
+ ### Advanced Tools - Expo DevTools (Advanced Tier Only)
164
+
165
+ | Tool | Description |
166
+ |------|-------------|
167
+ | `check_expo_status` | Check Expo dev server status and connected devices |
168
+ | `get_expo_config` | Get Expo project configuration (app.json/app.config.js) |
169
+ | `expo_dev_menu` | Open the Expo developer menu on device |
170
+ | `expo_reload` | Trigger a reload of the Expo app |
171
+ | `get_eas_builds` | Get recent EAS build status and download links |
172
+
173
+ ### Advanced Tools - Performance Metrics (Advanced Tier Only)
174
+
175
+ | Tool | Description |
176
+ |------|-------------|
177
+ | `get_cpu_usage` | Get CPU usage for device or specific app |
178
+ | `get_memory_usage` | Get memory usage (heap, native, PSS) for an app |
179
+ | `get_fps_stats` | Get frame rendering stats (jank frames, percentiles) |
180
+ | `get_battery_stats` | Get battery consumption by app |
181
+ | `get_performance_snapshot` | Get all metrics at once for quick profiling |
182
+
138
183
  ## Usage Examples
139
184
 
140
185
  Once installed, Claude can use these tools automatically:
@@ -157,6 +202,30 @@ Once installed, Claude can use these tools automatically:
157
202
  **You:** "Inspect the UserProfile component"
158
203
  **Claude:** *Uses search_react_components and inspect_react_component* "Found UserProfile with props: {userId: '123'}, state: {loading: false, data: {...}}"
159
204
 
205
+ **You:** "What API calls is my app making?"
206
+ **Claude:** *Uses get_network_requests* "Found 15 requests: GET /api/users (200), POST /api/login (200), GET /api/feed (500 error)..."
207
+
208
+ **You:** "Monitor network traffic while I use the app"
209
+ **Claude:** *Uses start_network_monitoring* "Network monitoring started. Make some requests, then I'll summarize them."
210
+
211
+ **You:** "Is my Expo server running?"
212
+ **Claude:** *Uses check_expo_status* "Expo is running on port 8081. Metro bundler active, 1 device connected."
213
+
214
+ **You:** "Reload the app"
215
+ **Claude:** *Uses expo_reload* "App reloaded! The JavaScript bundle has been refreshed."
216
+
217
+ **You:** "Show me my EAS builds"
218
+ **Claude:** *Uses get_eas_builds* "Found 3 recent builds: Android production (complete), iOS staging (in progress)..."
219
+
220
+ **You:** "Is my app using too much memory?"
221
+ **Claude:** *Uses get_memory_usage* "Your app is using 145 MB (PSS). Java heap: 45 MB, Native: 78 MB. This is within normal range."
222
+
223
+ **You:** "Check the performance of com.myapp"
224
+ **Claude:** *Uses get_performance_snapshot* "CPU: 12%, Memory: 145 MB, Frames: 2450 rendered, 3% janky. Battery: 85%, temp 32°C"
225
+
226
+ **You:** "Why is my app laggy?"
227
+ **Claude:** *Uses get_fps_stats* "Found 15% janky frames. 90th percentile frame time is 24ms (should be <16ms). Consider optimizing heavy UI operations."
228
+
160
229
  ## Workflow
161
230
 
162
231
  1. Start your Metro bundler: `npx expo start` or `npx react-native start`
@@ -172,9 +241,9 @@ Once installed, Claude can use these tools automatically:
172
241
  - [x] Error pattern watching (Advanced tier)
173
242
  - [x] iOS Simulator support (screenshots, logs, app management)
174
243
  - [x] React DevTools integration (component tree, props, state inspection)
175
- - [ ] Expo DevTools integration
176
- - [ ] Network request inspection
177
- - [ ] Performance metrics
244
+ - [x] Network request inspection (capture, monitor, analyze HTTP traffic)
245
+ - [x] Expo DevTools integration (server status, config, reload, EAS builds)
246
+ - [x] Performance metrics (CPU, memory, FPS, battery monitoring)
178
247
  - [ ] Team tier with centralized license management
179
248
 
180
249
  ## License Activation