@ggboi360/mobile-dev-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,53 @@
+Elastic License 2.0 (ELv2)
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+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.
+
+## Limitations
+
+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.
+
+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.
+
+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.
+
+## Patents
+
+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.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in these terms.
+
+## Termination
+
+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.
+
+## No Liability
+
+*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.*
+
+## Definitions
+
+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.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**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.
+
+**your licenses** are all the licenses granted to you for the software under these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,193 @@
+# Claude Mobile Dev MCP
+
+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!
+
+## 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
+
+## Pricing
+
+| Tier | Price | Features |
+|------|-------|----------|
+| **TRIAL** | Free (50 requests) | Try all 41 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 41 tools, unlimited logs, 3 devices, real-time streaming, React DevTools |
+
+Purchase at: https://mobile-dev-mcp.com
+
+## Installation
+
+### Option 1: Claude Code Plugin (Recommended)
+```bash
+# In Claude Code
+/plugin install GGBoi360/claude-mobile-dev-mcp
+```
+
+### Option 2: Manual MCP Setup
+```bash
+# Clone the repo
+git clone https://github.com/GGBoi360/claude-mobile-dev-mcp.git
+cd claude-mobile-dev-mcp
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Add to Claude Code
+claude mcp add mobile-dev -- node /path/to/claude-mobile-dev-mcp/dist/index.js
+```
+
+### Option 3: NPX (Coming Soon)
+```bash
+claude mcp add mobile-dev -- npx claude-mobile-dev-mcp
+```
+
+## Requirements
+
+- **Node.js** >= 18.0.0
+- **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):**
+  - **Xcode** with Command Line Tools
+  - Run `xcode-select --install` if not installed
+
+## Available Tools
+
+### Core Tools - Android (All Tiers)
+
+| 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 |
+| `list_devices` | List connected Android devices/emulators |
+| `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 |
+
+## 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: {...}}"
+
+## Workflow
+
+1. Start your Metro bundler: `npx expo start` or `npx react-native start`
+2. Start your emulator (Genymotion, Android Studio, etc.)
+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)
+- [ ] Expo DevTools integration
+- [ ] Network request inspection
+- [ ] Performance metrics
+- [ ] Team tier with centralized license management
+
+## License Activation
+
+1. Purchase a license at https://mobile-dev-mcp.com
+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`
+
+## Contributing
+
+PRs welcome! Help us make mobile dev with Claude actually usable.
+
+---
+
+Built with frustration and determination by the mobile dev community.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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