@ggboi360/mobile-dev-mcp 0.1.0 → 0.3.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.
Files changed (29) hide show
  1. package/LICENSE +33 -37
  2. package/LICENSE-ELASTIC +71 -0
  3. package/LICENSE-MIT +43 -0
  4. package/README.md +75 -127
  5. package/dist/index.d.ts +12 -0
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +711 -2036
  8. package/dist/index.js.map +1 -1
  9. package/dist/license.d.ts +11 -96
  10. package/dist/license.d.ts.map +1 -1
  11. package/dist/license.js +243 -552
  12. package/dist/license.js.map +1 -1
  13. package/dist/types.d.ts +52 -0
  14. package/dist/types.d.ts.map +1 -0
  15. package/dist/types.js +50 -0
  16. package/dist/types.js.map +1 -0
  17. package/dist/utils.d.ts +72 -0
  18. package/dist/utils.d.ts.map +1 -0
  19. package/dist/utils.js +307 -0
  20. package/dist/utils.js.map +1 -0
  21. package/package.json +15 -5
  22. package/dist/license.test.d.ts +0 -2
  23. package/dist/license.test.d.ts.map +0 -1
  24. package/dist/license.test.js +0 -198
  25. package/dist/license.test.js.map +0 -1
  26. package/dist/tools.test.d.ts +0 -2
  27. package/dist/tools.test.d.ts.map +0 -1
  28. package/dist/tools.test.js +0 -337
  29. package/dist/tools.test.js.map +0 -1
package/LICENSE CHANGED
@@ -1,53 +1,49 @@
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
+ ## Free Tools (8 tools) - MIT License
6
6
 
7
- ## Copyright License
7
+ The **8 free tools** 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 open source - free to use, modify, and distribute:
10
11
 
11
- ## Limitations
12
+ **Android Debugging (7 tools):**
13
+ - screenshot_emulator, list_devices, get_device_info, get_app_info
14
+ - get_adb_logs, get_metro_logs, check_metro_status
12
15
 
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.
16
+ **License (1 tool):**
17
+ - get_license_status
14
18
 
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.
19
+ Note: MIT license means the code is open source and free to use forever.
16
20
 
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.
21
+ ## Advanced Tools (13 tools) - Elastic License 2.0
18
22
 
19
- ## Patents
23
+ The **13 advanced tools** are licensed under the **Elastic License 2.0**.
24
+ See [LICENSE-ELASTIC](LICENSE-ELASTIC) for the full text.
20
25
 
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.
26
+ This means:
27
+ - You CAN use them for personal or commercial projects
28
+ - You CAN modify and create derivative works
29
+ - You CANNOT offer this as a hosted/managed service
30
+ - You CANNOT remove or circumvent the license key functionality
22
31
 
23
- ## Notices
32
+ Advanced tools include:
33
+ - iOS Simulator support (screenshots, logs, device info)
34
+ - UI tree inspection and element finding
35
+ - Screen analysis and text extraction
36
+ - Multi-device support
24
37
 
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.
38
+ ## Why Dual License?
26
39
 
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.
40
+ We believe in open source while also needing to sustain development:
28
41
 
29
- ## No Other Rights
42
+ - **MIT for Free**: Enables the community to freely use, learn from, and contribute to core Android debugging
43
+ - **Elastic for Advanced**: Protects the commercial features that fund ongoing development
30
44
 
31
- These terms do not imply any licenses other than those expressly granted in these terms.
45
+ ## Questions?
32
46
 
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.
47
+ - GitHub: https://github.com/GGBoi360/mobile-dev-mcp
48
+ - Twitter: @GiliboiGabay
49
+ - Email: GiladGabay@proton.me
package/LICENSE-ELASTIC ADDED
@@ -0,0 +1,71 @@
1
+ Elastic License 2.0 (ELv2)
2
+
3
+ This license applies to the 13 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 13 Advanced tier tools:
60
+
61
+ **iOS Simulator Support:**
62
+ - screenshot_ios_simulator, list_ios_simulators, get_ios_simulator_info, get_ios_simulator_logs
63
+
64
+ **UI Inspection:**
65
+ - get_ui_tree, find_element, wait_for_element, get_element_property, assert_element
66
+
67
+ **Screen Analysis:**
68
+ - suggest_action, analyze_screen, get_screen_text
69
+
70
+ **License:**
71
+ - set_license_key
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,54 +1,57 @@
1
- # Claude Mobile Dev MCP
1
+ # Mobile Dev MCP
2
2
 
3
- 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!
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
+
7
+ A **read-only** MCP server that gives Claude direct access to your mobile development environment. Stop copy-pasting logs and screenshots - let Claude see your app directly!
8
+
9
+ **Open Core**: 8 free tools are MIT licensed. 13 advanced tools are source-available under Elastic License 2.0.
4
10
 
5
11
  ## Features
6
12
 
7
- - **Metro Log Streaming** - Claude can read Metro bundler output in real-time
8
- - **ADB Logcat Integration** - Get React Native logs directly from your device/emulator
9
- - **iOS Simulator Support** - Screenshots and logs from iOS Simulators (macOS only)
10
- - **Screenshot Capture** - Claude can see your app's current screen (Android & iOS)
11
- - **Device Management** - List devices, check status, restart ADB
12
- - **App Management** - Get app info, clear data for fresh testing
13
- - **React DevTools Integration** - Inspect React component trees, props, and state
13
+ - **Screenshots** - Claude can see your app's current screen (Android & iOS)
14
+ - **Logs** - Metro bundler, ADB logcat, and iOS Simulator logs
15
+ - **Device Info** - List devices, check status, get detailed info
16
+ - **UI Inspection** - Get the full UI hierarchy with element details (Advanced)
17
+ - **Screen Analysis** - Find elements, suggest actions, extract text (Advanced)
14
18
 
15
19
  ## Pricing
16
20
 
17
- | Tier | Price | Features |
18
- |------|-------|----------|
19
- | **TRIAL** | Free (50 requests) | Try all 41 tools, then purchase to continue |
20
- | **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 |
21
+ | Tier | Price | Tools | Description |
22
+ |------|-------|-------|-------------|
23
+ | **Free** | $0 | 8 | Android debugging - screenshots, logs, device info |
24
+ | **Advanced** | $18/month | 21 | + iOS support, UI inspection, screen analysis, multi-device |
22
25
 
23
- Purchase at: https://mobile-dev-mcp.com
26
+ **Need automation?** Screen streaming, tapping, typing, and workflows are available in [CodeControl](https://codecontrol.dev).
24
27
 
25
28
  ## Installation
26
29
 
27
- ### Option 1: Claude Code Plugin (Recommended)
30
+ ### Option 1: NPX (Recommended)
28
31
  ```bash
29
- # In Claude Code
30
- /plugin install GGBoi360/claude-mobile-dev-mcp
32
+ # Add to Claude Code
33
+ claude mcp add mobile-dev -- npx @ggboi360/mobile-dev-mcp
31
34
  ```
32
35
 
33
- ### Option 2: Manual MCP Setup
34
- ```bash
35
- # Clone the repo
36
- git clone https://github.com/GGBoi360/claude-mobile-dev-mcp.git
37
- cd claude-mobile-dev-mcp
38
-
39
- # Install dependencies
40
- npm install
41
-
42
- # Build
43
- npm run build
44
-
45
- # Add to Claude Code
46
- claude mcp add mobile-dev -- node /path/to/claude-mobile-dev-mcp/dist/index.js
36
+ Or add to your `~/.claude/claude_desktop_config.json`:
37
+ ```json
38
+ {
39
+ "mcpServers": {
40
+ "mobile-dev": {
41
+ "command": "npx",
42
+ "args": ["@ggboi360/mobile-dev-mcp"]
43
+ }
44
+ }
45
+ }
47
46
  ```
48
47
 
49
- ### Option 3: NPX (Coming Soon)
48
+ ### Option 2: Manual Setup (Development)
50
49
  ```bash
51
- claude mcp add mobile-dev -- npx claude-mobile-dev-mcp
50
+ git clone https://github.com/GGBoi360/mobile-dev-mcp.git
51
+ cd mobile-dev-mcp
52
+ npm install
53
+ npm run build
54
+ claude mcp add mobile-dev -- node /path/to/mobile-dev-mcp/dist/index.js
52
55
  ```
53
56
 
54
57
  ## Requirements
@@ -57,137 +60,82 @@ claude mcp add mobile-dev -- npx claude-mobile-dev-mcp
57
60
  - **For Android:**
58
61
  - **ADB** (Android Debug Bridge) - Part of Android SDK Platform Tools
59
62
  - [Download Platform Tools](https://developer.android.com/tools/releases/platform-tools)
60
- - Make sure `adb` is in your PATH
61
- - **For iOS (macOS only):**
63
+ - **For iOS (macOS only, Advanced tier):**
62
64
  - **Xcode** with Command Line Tools
63
65
  - Run `xcode-select --install` if not installed
64
66
 
65
67
  ## Available Tools
66
68
 
67
- ### Core Tools - Android (All Tiers)
69
+ ### Free Tier (8 tools) - Android Only
68
70
 
69
71
  | Tool | Description |
70
72
  |------|-------------|
71
- | `get_metro_logs` | Get recent Metro bundler logs with optional filtering |
72
- | `get_adb_logs` | Get React Native logs from device via ADB logcat |
73
- | `screenshot_emulator` | Capture screenshot from Android emulator |
73
+ | `screenshot_emulator` | Capture screenshot from Android emulator/device |
74
74
  | `list_devices` | List connected Android devices/emulators |
75
+ | `get_device_info` | Get detailed Android device information |
76
+ | `get_app_info` | Get info about an installed Android app |
77
+ | `get_adb_logs` | Get React Native logs from device via ADB logcat |
78
+ | `get_metro_logs` | Get recent Metro bundler logs |
75
79
  | `check_metro_status` | Check if Metro bundler is running |
76
- | `get_app_info` | Get info about an installed app |
77
- | `clear_app_data` | Clear app data for fresh testing |
78
- | `restart_adb` | Restart ADB server when it gets stuck |
79
- | `get_device_info` | Get detailed device information |
80
- | `start_metro_logging` | Start capturing Metro logs in background |
81
- | `stop_metro_logging` | Stop Metro log capture |
82
-
83
- ### Core Tools - iOS Simulator (All Tiers, macOS only)
84
-
85
- | Tool | Description |
86
- |------|-------------|
87
- | `list_ios_simulators` | List all available iOS Simulators |
88
- | `screenshot_ios_simulator` | Capture screenshot from iOS Simulator |
89
- | `get_ios_simulator_logs` | Get logs from iOS Simulator |
90
- | `get_ios_simulator_info` | Get detailed simulator information |
91
-
92
- ### License Tools (All Tiers)
93
-
94
- | Tool | Description |
95
- |------|-------------|
96
80
  | `get_license_status` | Check your current license tier and limits |
97
- | `set_license_key` | Activate a license key to unlock paid features |
98
81
 
99
- ### Advanced Tools - Android (Advanced Tier Only)
82
+ ### Advanced Tier (+13 tools = 21 total) - $18/month
100
83
 
101
84
  | Tool | Description |
102
85
  |------|-------------|
103
- | `stream_adb_realtime` | Start real-time ADB log streaming in background |
104
- | `stop_adb_streaming` | Stop real-time ADB log streaming |
105
- | `screenshot_history` | Get previously captured screenshots (stores up to 20) |
106
- | `watch_for_errors` | Monitor logs for specific error patterns |
107
- | `multi_device_logs` | Get logs from multiple devices simultaneously |
108
- | `tap_screen` | Tap on the screen at specific coordinates |
109
- | `input_text` | Type text into the currently focused input field |
110
- | `press_button` | Press hardware buttons (back, home, recent, volume, power) |
111
- | `swipe_screen` | Swipe/scroll on the screen |
112
- | `launch_app` | Launch an app by package name |
113
- | `install_apk` | Install an APK file to the device |
114
-
115
- ### Advanced Tools - iOS Simulator (Advanced Tier Only, macOS)
116
-
117
- | Tool | Description |
118
- |------|-------------|
119
- | `boot_ios_simulator` | Boot an iOS Simulator by UDID or name |
120
- | `shutdown_ios_simulator` | Shutdown an iOS Simulator (or all) |
121
- | `install_ios_app` | Install an app (.app bundle) on simulator |
122
- | `launch_ios_app` | Launch an app by bundle identifier |
123
- | `terminate_ios_app` | Force quit an app on simulator |
124
- | `ios_open_url` | Open a URL (deep links, universal links) |
125
- | `ios_push_notification` | Send a push notification to simulator |
126
- | `ios_set_location` | Set simulated GPS location |
86
+ | `screenshot_ios_simulator` | Capture screenshot from iOS Simulator (macOS) |
87
+ | `list_ios_simulators` | List all available iOS Simulators (macOS) |
88
+ | `get_ios_simulator_info` | Get detailed iOS Simulator information (macOS) |
89
+ | `get_ios_simulator_logs` | Get logs from iOS Simulator (macOS) |
90
+ | `get_ui_tree` | Get the full UI hierarchy with element details |
91
+ | `find_element` | Find elements by text, resourceId, or contentDescription |
92
+ | `wait_for_element` | Wait for an element to appear (with configurable timeout) |
93
+ | `get_element_property` | Get specific property of an element |
94
+ | `assert_element` | Verify element exists or has expected state |
95
+ | `suggest_action` | Get AI-suggested actions based on current screen state |
96
+ | `analyze_screen` | Analyze current screen content and layout |
97
+ | `get_screen_text` | Extract all visible text from current screen |
98
+ | `set_license_key` | Activate a license key to unlock paid features |
127
99
 
128
- ### Advanced Tools - React DevTools (Advanced Tier Only)
100
+ ### Tier Limits
129
101
 
130
- | Tool | Description |
131
- |------|-------------|
132
- | `setup_react_devtools` | Configure React DevTools connection and port forwarding |
133
- | `check_devtools_connection` | Check if DevTools is connected to your app |
134
- | `get_react_component_tree` | Get the React component hierarchy |
135
- | `inspect_react_component` | Inspect a component's props, state, and hooks |
136
- | `search_react_components` | Search for components by name |
102
+ | Feature | Free | Advanced |
103
+ |---------|------|----------|
104
+ | Tools | 8 | 21 |
105
+ | Log lines | 50 | 200 |
106
+ | Devices | 1 | 3 |
137
107
 
138
108
  ## Usage Examples
139
109
 
140
- Once installed, Claude can use these tools automatically:
141
-
142
- **You:** "Check if my Metro bundler is running"
143
- **Claude:** *Uses check_metro_status tool* "Metro is running on port 8081..."
144
-
145
- **You:** "Show me the recent React Native errors"
146
- **Claude:** *Uses get_adb_logs with filter='E'* "I found 3 errors in the logs..."
147
-
148
110
  **You:** "Take a screenshot of my app"
149
111
  **Claude:** *Uses screenshot_emulator* "Here's what your app looks like..." [shows image]
150
112
 
151
- **You:** "What's happening with my app? It crashed"
152
- **Claude:** *Uses get_adb_logs and screenshot_emulator* "I can see a null pointer exception in the logs, and the screen shows..."
113
+ **You:** "Show me the recent React Native errors"
114
+ **Claude:** *Uses get_adb_logs with level='E'* "I found 3 errors in the logs..."
153
115
 
154
- **You:** "Show me the React component tree"
155
- **Claude:** *Uses get_react_component_tree* "Here's your component hierarchy: App > Navigator > HomeScreen > ..."
116
+ **You:** "What's on the screen right now?"
117
+ **Claude:** *Uses get_ui_tree* "I can see a login form with email and password fields..."
156
118
 
157
- **You:** "Inspect the UserProfile component"
158
- **Claude:** *Uses search_react_components and inspect_react_component* "Found UserProfile with props: {userId: '123'}, state: {loading: false, data: {...}}"
119
+ **You:** "Find the Submit button"
120
+ **Claude:** *Uses find_element* "Found a clickable button with text 'Submit' at coordinates [540, 1200]"
159
121
 
160
122
  ## Workflow
161
123
 
162
124
  1. Start your Metro bundler: `npx expo start` or `npx react-native start`
163
- 2. Start your emulator (Genymotion, Android Studio, etc.)
125
+ 2. Start your emulator or connect your device
164
126
  3. Start Claude Code with this MCP server installed
165
127
  4. Ask Claude about your app - it can now see logs and screenshots!
166
128
 
167
- ## Roadmap
168
-
169
- - [x] Real-time log streaming (Advanced tier)
170
- - [x] Screenshot history (Advanced tier)
171
- - [x] Multi-device support (Advanced tier)
172
- - [x] Error pattern watching (Advanced tier)
173
- - [x] iOS Simulator support (screenshots, logs, app management)
174
- - [x] React DevTools integration (component tree, props, state inspection)
175
- - [ ] Expo DevTools integration
176
- - [ ] Network request inspection
177
- - [ ] Performance metrics
178
- - [ ] Team tier with centralized license management
179
-
180
129
  ## License Activation
181
130
 
182
- 1. Purchase a license at https://mobile-dev-mcp.com
131
+ 1. Purchase at https://mobiledevmcp.dev/pricing
183
132
  2. You'll receive a license key via email
184
- 3. Use the `set_license_key` tool to activate: `set_license_key` with your key
185
- 4. Or add to config file: `~/.mobiledev-mcp/config.json`
133
+ 3. Use the `set_license_key` tool to activate
186
134
 
187
135
  ## Contributing
188
136
 
189
- PRs welcome! Help us make mobile dev with Claude actually usable.
137
+ PRs welcome! This is an open-core project - the 8 free tools are MIT licensed.
190
138
 
191
139
  ---
192
140
 
193
- Built with frustration and determination by the mobile dev community.
141
+ Built with frustration and determination. [Website](https://mobiledevmcp.dev) | [GitHub](https://github.com/GGBoi360/mobile-dev-mcp)
package/dist/index.d.ts CHANGED
@@ -1,3 +1,15 @@
1
1
  #!/usr/bin/env node
2
+ /**
3
+ * Mobile Dev MCP - Read-Only Debugging Tools for Mobile Development
4
+ *
5
+ * A read-only MCP server for observing and debugging mobile apps:
6
+ * - Taking screenshots
7
+ * - Viewing device information
8
+ * - Reading logs
9
+ * - Inspecting UI hierarchy
10
+ * - Analyzing screen content
11
+ *
12
+ * License: Dual (MIT + Elastic License 2.0)
13
+ */
2
14
  export {};
3
15
  //# sourceMappingURL=index.d.ts.map
package/dist/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG"}