@ggboi360/mobile-dev-mcp 0.2.0 → 0.3.1

package/LICENSE

@@ -2,21 +2,25 @@
 
 This project uses a dual-license model ("Open Core"):
 
-## Basic Tools (17 tools) - MIT License
+## Free Tools (8 tools) - MIT License
 
-The **17 core tools** in the Basic tier are licensed under the **MIT License**.
+The **8 free tools** are licensed under the **MIT License**.
 See [LICENSE-MIT](LICENSE-MIT) for the full text.
 
-These tools are free to use, modify, and distribute:
-- get_metro_logs, get_adb_logs, screenshot_emulator, list_devices
-- check_metro_status, get_app_info, clear_app_data, restart_adb
-- get_device_info, start_metro_logging, stop_metro_logging
-- list_ios_simulators, screenshot_ios_simulator, get_ios_simulator_logs
-- get_ios_simulator_info, get_license_status, set_license_key
+These tools are open source - free to use, modify, and distribute:
 
-## Advanced Tools (39 tools) - Elastic License 2.0
+**Android Debugging (7 tools):**
+- screenshot_emulator, list_devices, get_device_info, get_app_info
+- get_adb_logs, get_metro_logs, check_metro_status
 
-The **39 advanced tools** are licensed under the **Elastic License 2.0**.
+**License (1 tool):**
+- get_license_status
+
+Note: MIT license means the code is open source and free to use forever.
+
+## Advanced Tools (13 tools) - Elastic License 2.0
+
+The **13 advanced tools** are licensed under the **Elastic License 2.0**.
 See [LICENSE-ELASTIC](LICENSE-ELASTIC) for the full text.
 
 This means:
@@ -26,19 +30,16 @@ This means:
 - You CANNOT remove or circumvent the license key functionality
 
 Advanced tools include:
-- Streaming & monitoring (stream_adb_realtime, screenshot_history, etc.)
-- Device interaction (tap_screen, input_text, swipe_screen, etc.)
-- iOS Simulator advanced (boot/shutdown, app management, push notifications)
-- React DevTools integration
-- Network inspection
-- Expo DevTools integration
-- Performance metrics
+- iOS Simulator support (screenshots, logs, device info)
+- UI tree inspection and element finding
+- Screen analysis and text extraction
+- Multi-device support
 
 ## Why Dual License?
 
 We believe in open source while also needing to sustain development:
 
-- **MIT for Basic**: Enables the community to freely use, learn from, and contribute to core functionality
+- **MIT for Free**: Enables the community to freely use, learn from, and contribute to core Android debugging
 - **Elastic for Advanced**: Protects the commercial features that fund ongoing development
 
 ## Questions?

package/LICENSE-ELASTIC

@@ -1,6 +1,6 @@
 Elastic License 2.0 (ELv2)
 
-This license applies to the 39 Advanced tier tools in Mobile Dev MCP.
+This license applies to the 13 Advanced tier tools in Mobile Dev MCP.
 
 ## Acceptance
 
@@ -56,28 +56,16 @@ The **licensor** is the entity offering these terms, and the **software** is the
 
 ---
 
-This Elastic License 2.0 applies to the following 39 Advanced tier tools:
+This Elastic License 2.0 applies to the following 13 Advanced tier tools:
 
-**Android Streaming & Monitoring:**
-- stream_adb_realtime, stop_adb_streaming, screenshot_history, watch_for_errors, multi_device_logs
+**iOS Simulator Support:**
+- screenshot_ios_simulator, list_ios_simulators, get_ios_simulator_info, get_ios_simulator_logs
 
-**Android Interaction:**
-- tap_screen, input_text, press_button, swipe_screen, launch_app, install_apk
+**UI Inspection:**
+- get_ui_tree, find_element, wait_for_element, get_element_property, assert_element
 
-**iOS Simulator Advanced:**
-- boot_ios_simulator, shutdown_ios_simulator, install_ios_app, launch_ios_app
-- terminate_ios_app, ios_open_url, ios_push_notification, ios_set_location
+**Screen Analysis:**
+- suggest_action, analyze_screen, get_screen_text
 
-**React DevTools:**
-- setup_react_devtools, check_devtools_connection, get_react_component_tree
-- inspect_react_component, search_react_components
-
-**Network Inspection:**
-- get_network_requests, start_network_monitoring, stop_network_monitoring
-- get_network_stats, analyze_request
-
-**Expo DevTools:**
-- check_expo_status, get_expo_config, expo_dev_menu, expo_reload, get_eas_builds
-
-**Performance Metrics:**
-- get_cpu_usage, get_memory_usage, get_fps_stats, get_battery_stats, get_performance_snapshot
+**License:**
+- set_license_key

package/README.md

@@ -1,34 +1,29 @@
-# Claude Mobile Dev MCP
+# Mobile Dev MCP
 
 [![npm version](https://img.shields.io/npm/v/@ggboi360/mobile-dev-mcp.svg)](https://www.npmjs.com/package/@ggboi360/mobile-dev-mcp)
 [![License: MIT (Core)](https://img.shields.io/badge/License-MIT%20(Core)-green.svg)](LICENSE-MIT)
 [![License: Elastic 2.0 (Advanced)](https://img.shields.io/badge/License-Elastic%202.0%20(Advanced)-blue.svg)](LICENSE-ELASTIC)
 
-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!
+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!
 
-**Open Core**: 17 core tools are MIT licensed (free forever). 39 advanced tools are source-available under Elastic License 2.0.
+**Open Core**: 8 free tools are MIT licensed. 13 advanced tools are source-available under Elastic License 2.0.
 
 ## Features
 
-- **Metro Log Streaming** - Claude can read Metro bundler output in real-time
-- **ADB Logcat Integration** - Get React Native logs directly from your device/emulator
-- **iOS Simulator Support** - Screenshots and logs from iOS Simulators (macOS only)
-- **Screenshot Capture** - Claude can see your app's current screen (Android & iOS)
-- **Device Management** - List devices, check status, restart ADB
-- **App Management** - Get app info, clear data for fresh testing
-- **React DevTools Integration** - Inspect React component trees, props, and state
-- **Expo DevTools Integration** - Check Expo server status, manage config, trigger reloads, EAS builds
-- **Performance Metrics** - CPU, memory, FPS, and battery monitoring for your app
+- **Screenshots** - Claude can see your app's current screen (Android & iOS)
+- **Logs** - Metro bundler, ADB logcat, and iOS Simulator logs
+- **Device Info** - List devices, check status, get detailed info
+- **UI Inspection** - Get the full UI hierarchy with element details (Advanced)
+- **Screen Analysis** - Find elements, suggest actions, extract text (Advanced)
 
 ## Pricing
 
-| Tier | Price | Features |
-|------|-------|----------|
-| **TRIAL** | Free (50 requests) | Try all 56 tools, then purchase to continue |
-| **BASIC** | $6/month | 17 core tools (Android + iOS basics), 50 log lines max, 1 device |
-| **ADVANCED** | $8/week, $12/month, or $99/year | All 56 tools, unlimited logs, 3 devices, streaming, DevTools, network, Expo, performance |
+| Tier | Price | Tools | Description |
+|------|-------|-------|-------------|
+| **Free** | $0 | 8 | Android debugging - screenshots, logs, device info |
+| **Advanced** | $18/month | 21 | + iOS support, UI inspection, screen analysis, multi-device |
 
-Purchase at: https://mobile-dev-mcp.com
+**Need automation?** Screen streaming, tapping, typing, and workflows are available in [CodeControl](https://codecontrol.ai).
 
 ## Installation
 
@@ -52,17 +47,10 @@ Or add to your `~/.claude/claude_desktop_config.json`:
 
 ### Option 2: Manual Setup (Development)
 ```bash
-# Clone the repo
 git clone https://github.com/GGBoi360/mobile-dev-mcp.git
 cd mobile-dev-mcp
-
-# Install dependencies
 npm install
-
-# Build
 npm run build
-
-# Add to Claude Code
 claude mcp add mobile-dev -- node /path/to/mobile-dev-mcp/dist/index.js
 ```
 
@@ -72,191 +60,82 @@ claude mcp add mobile-dev -- node /path/to/mobile-dev-mcp/dist/index.js
 - **For Android:**
   - **ADB** (Android Debug Bridge) - Part of Android SDK Platform Tools
   - [Download Platform Tools](https://developer.android.com/tools/releases/platform-tools)
-  - Make sure `adb` is in your PATH
-- **For iOS (macOS only):**
+- **For iOS (macOS only, Advanced tier):**
   - **Xcode** with Command Line Tools
   - Run `xcode-select --install` if not installed
 
 ## Available Tools
 
-### Core Tools - Android (All Tiers)
+### Free Tier (8 tools) - Android Only
 
 | Tool | Description |
 |------|-------------|
-| `get_metro_logs` | Get recent Metro bundler logs with optional filtering |
-| `get_adb_logs` | Get React Native logs from device via ADB logcat |
-| `screenshot_emulator` | Capture screenshot from Android emulator |
+| `screenshot_emulator` | Capture screenshot from Android emulator/device |
 | `list_devices` | List connected Android devices/emulators |
+| `get_device_info` | Get detailed Android device information |
+| `get_app_info` | Get info about an installed Android app |
+| `get_adb_logs` | Get React Native logs from device via ADB logcat |
+| `get_metro_logs` | Get recent Metro bundler logs |
 | `check_metro_status` | Check if Metro bundler is running |
-| `get_app_info` | Get info about an installed app |
-| `clear_app_data` | Clear app data for fresh testing |
-| `restart_adb` | Restart ADB server when it gets stuck |
-| `get_device_info` | Get detailed device information |
-| `start_metro_logging` | Start capturing Metro logs in background |
-| `stop_metro_logging` | Stop Metro log capture |
-
-### Core Tools - iOS Simulator (All Tiers, macOS only)
-
-| Tool | Description |
-|------|-------------|
-| `list_ios_simulators` | List all available iOS Simulators |
-| `screenshot_ios_simulator` | Capture screenshot from iOS Simulator |
-| `get_ios_simulator_logs` | Get logs from iOS Simulator |
-| `get_ios_simulator_info` | Get detailed simulator information |
-
-### License Tools (All Tiers)
-
-| Tool | Description |
-|------|-------------|
 | `get_license_status` | Check your current license tier and limits |
-| `set_license_key` | Activate a license key to unlock paid features |
-
-### Advanced Tools - Android (Advanced Tier Only)
-
-| Tool | Description |
-|------|-------------|
-| `stream_adb_realtime` | Start real-time ADB log streaming in background |
-| `stop_adb_streaming` | Stop real-time ADB log streaming |
-| `screenshot_history` | Get previously captured screenshots (stores up to 20) |
-| `watch_for_errors` | Monitor logs for specific error patterns |
-| `multi_device_logs` | Get logs from multiple devices simultaneously |
-| `tap_screen` | Tap on the screen at specific coordinates |
-| `input_text` | Type text into the currently focused input field |
-| `press_button` | Press hardware buttons (back, home, recent, volume, power) |
-| `swipe_screen` | Swipe/scroll on the screen |
-| `launch_app` | Launch an app by package name |
-| `install_apk` | Install an APK file to the device |
-
-### Advanced Tools - iOS Simulator (Advanced Tier Only, macOS)
-
-| Tool | Description |
-|------|-------------|
-| `boot_ios_simulator` | Boot an iOS Simulator by UDID or name |
-| `shutdown_ios_simulator` | Shutdown an iOS Simulator (or all) |
-| `install_ios_app` | Install an app (.app bundle) on simulator |
-| `launch_ios_app` | Launch an app by bundle identifier |
-| `terminate_ios_app` | Force quit an app on simulator |
-| `ios_open_url` | Open a URL (deep links, universal links) |
-| `ios_push_notification` | Send a push notification to simulator |
-| `ios_set_location` | Set simulated GPS location |
-
-### Advanced Tools - React DevTools (Advanced Tier Only)
-
-| Tool | Description |
-|------|-------------|
-| `setup_react_devtools` | Configure React DevTools connection and port forwarding |
-| `check_devtools_connection` | Check if DevTools is connected to your app |
-| `get_react_component_tree` | Get the React component hierarchy |
-| `inspect_react_component` | Inspect a component's props, state, and hooks |
-| `search_react_components` | Search for components by name |
-
-### Advanced Tools - Network Inspection (Advanced Tier Only)
-
-| Tool | Description |
-|------|-------------|
-| `get_network_requests` | Get recent HTTP/HTTPS requests from app logs |
-| `start_network_monitoring` | Start real-time network request capture |
-| `stop_network_monitoring` | Stop monitoring and get summary |
-| `get_network_stats` | Get device network statistics (WiFi, data usage) |
-| `analyze_request` | Analyze a specific captured request in detail |
 
-### Advanced Tools - Expo DevTools (Advanced Tier Only)
+### Advanced Tier (+13 tools = 21 total) - $18/month
 
 | Tool | Description |
 |------|-------------|
-| `check_expo_status` | Check Expo dev server status and connected devices |
-| `get_expo_config` | Get Expo project configuration (app.json/app.config.js) |
-| `expo_dev_menu` | Open the Expo developer menu on device |
-| `expo_reload` | Trigger a reload of the Expo app |
-| `get_eas_builds` | Get recent EAS build status and download links |
+| `screenshot_ios_simulator` | Capture screenshot from iOS Simulator (macOS) |
+| `list_ios_simulators` | List all available iOS Simulators (macOS) |
+| `get_ios_simulator_info` | Get detailed iOS Simulator information (macOS) |
+| `get_ios_simulator_logs` | Get logs from iOS Simulator (macOS) |
+| `get_ui_tree` | Get the full UI hierarchy with element details |
+| `find_element` | Find elements by text, resourceId, or contentDescription |
+| `wait_for_element` | Wait for an element to appear (with configurable timeout) |
+| `get_element_property` | Get specific property of an element |
+| `assert_element` | Verify element exists or has expected state |
+| `suggest_action` | Get AI-suggested actions based on current screen state |
+| `analyze_screen` | Analyze current screen content and layout |
+| `get_screen_text` | Extract all visible text from current screen |
+| `set_license_key` | Activate a license key to unlock paid features |
 
-### Advanced Tools - Performance Metrics (Advanced Tier Only)
+### Tier Limits
 
-| Tool | Description |
-|------|-------------|
-| `get_cpu_usage` | Get CPU usage for device or specific app |
-| `get_memory_usage` | Get memory usage (heap, native, PSS) for an app |
-| `get_fps_stats` | Get frame rendering stats (jank frames, percentiles) |
-| `get_battery_stats` | Get battery consumption by app |
-| `get_performance_snapshot` | Get all metrics at once for quick profiling |
+| Feature | Free | Advanced |
+|---------|------|----------|
+| Tools | 8 | 21 |
+| Log lines | 50 | 200 |
+| Devices | 1 | 3 |
 
 ## Usage Examples
 
-Once installed, Claude can use these tools automatically:
-
-**You:** "Check if my Metro bundler is running"
-**Claude:** *Uses check_metro_status tool* "Metro is running on port 8081..."
-
-**You:** "Show me the recent React Native errors"
-**Claude:** *Uses get_adb_logs with filter='E'* "I found 3 errors in the logs..."
-
 **You:** "Take a screenshot of my app"
 **Claude:** *Uses screenshot_emulator* "Here's what your app looks like..." [shows image]
 
-**You:** "What's happening with my app? It crashed"
-**Claude:** *Uses get_adb_logs and screenshot_emulator* "I can see a null pointer exception in the logs, and the screen shows..."
-
-**You:** "Show me the React component tree"
-**Claude:** *Uses get_react_component_tree* "Here's your component hierarchy: App > Navigator > HomeScreen > ..."
-
-**You:** "Inspect the UserProfile component"
-**Claude:** *Uses search_react_components and inspect_react_component* "Found UserProfile with props: {userId: '123'}, state: {loading: false, data: {...}}"
-
-**You:** "What API calls is my app making?"
-**Claude:** *Uses get_network_requests* "Found 15 requests: GET /api/users (200), POST /api/login (200), GET /api/feed (500 error)..."
-
-**You:** "Monitor network traffic while I use the app"
-**Claude:** *Uses start_network_monitoring* "Network monitoring started. Make some requests, then I'll summarize them."
-
-**You:** "Is my Expo server running?"
-**Claude:** *Uses check_expo_status* "Expo is running on port 8081. Metro bundler active, 1 device connected."
-
-**You:** "Reload the app"
-**Claude:** *Uses expo_reload* "App reloaded! The JavaScript bundle has been refreshed."
-
-**You:** "Show me my EAS builds"
-**Claude:** *Uses get_eas_builds* "Found 3 recent builds: Android production (complete), iOS staging (in progress)..."
-
-**You:** "Is my app using too much memory?"
-**Claude:** *Uses get_memory_usage* "Your app is using 145 MB (PSS). Java heap: 45 MB, Native: 78 MB. This is within normal range."
+**You:** "Show me the recent React Native errors"
+**Claude:** *Uses get_adb_logs with level='E'* "I found 3 errors in the logs..."
 
-**You:** "Check the performance of com.myapp"
-**Claude:** *Uses get_performance_snapshot* "CPU: 12%, Memory: 145 MB, Frames: 2450 rendered, 3% janky. Battery: 85%, temp 32°C"
+**You:** "What's on the screen right now?"
+**Claude:** *Uses get_ui_tree* "I can see a login form with email and password fields..."
 
-**You:** "Why is my app laggy?"
-**Claude:** *Uses get_fps_stats* "Found 15% janky frames. 90th percentile frame time is 24ms (should be <16ms). Consider optimizing heavy UI operations."
+**You:** "Find the Submit button"
+**Claude:** *Uses find_element* "Found a clickable button with text 'Submit' at coordinates [540, 1200]"
 
 ## Workflow
 
 1. Start your Metro bundler: `npx expo start` or `npx react-native start`
-2. Start your emulator (Genymotion, Android Studio, etc.)
+2. Start your emulator or connect your device
 3. Start Claude Code with this MCP server installed
 4. Ask Claude about your app - it can now see logs and screenshots!
 
-## Roadmap
-
-- [x] Real-time log streaming (Advanced tier)
-- [x] Screenshot history (Advanced tier)
-- [x] Multi-device support (Advanced tier)
-- [x] Error pattern watching (Advanced tier)
-- [x] iOS Simulator support (screenshots, logs, app management)
-- [x] React DevTools integration (component tree, props, state inspection)
-- [x] Network request inspection (capture, monitor, analyze HTTP traffic)
-- [x] Expo DevTools integration (server status, config, reload, EAS builds)
-- [x] Performance metrics (CPU, memory, FPS, battery monitoring)
-- [ ] Team tier with centralized license management
-
 ## License Activation
 
-1. Purchase a license at https://mobile-dev-mcp.com
+1. Purchase at https://codecontrol.ai/mcp
 2. You'll receive a license key via email
-3. Use the `set_license_key` tool to activate: `set_license_key` with your key
-4. Or add to config file: `~/.mobiledev-mcp/config.json`
+3. Use the `set_license_key` tool to activate
 
 ## Contributing
 
-PRs welcome! Help us make mobile dev with Claude actually usable.
+PRs welcome! This is an open-core project - the 8 free tools are MIT licensed.
 
 ---
 
-Built with frustration and determination by the mobile dev community.
+Built with frustration and determination. [Website](https://codecontrol.ai/mcp) | [GitHub](https://github.com/GGBoi360/mobile-dev-mcp)

package/dist/index.d.ts

@@ -1,3 +1,15 @@
 #!/usr/bin/env node
+/**
+ * Mobile Dev MCP - Read-Only Debugging Tools for Mobile Development
+ *
+ * A read-only MCP server for observing and debugging mobile apps:
+ * - Taking screenshots
+ * - Viewing device information
+ * - Reading logs
+ * - Inspecting UI hierarchy
+ * - Analyzing screen content
+ *
+ * License: Dual (MIT + Elastic License 2.0)
+ */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG"}