AI-powered MCP server for mobile testing: 20 free tools for iOS & Android automation via Claude/Cursor. Natural language commands, Appium-based, npx ready. Pro adds OCR, visual regression, parallel execution.
npm install @mobilepixel/mcpnpx -y @mobilepixel/mcp@latest) | Manual setup |
bash
npx -y @mobilepixel/mcp@latest
`
Plus, seamless upgrade to Pro for:
- AI-powered element finding (754x faster with caching)
- OCR text recognition (~500ms)
- Visual regression testing (9 tools)
- Parallel execution (2-8x speedup on Pro Team)
- 94+ total tools (Pro Team)
$3
- MCP Protocol Support - Native integration with Claude, Cursor, and other MCP-compatible AI tools
- NPX Ready - Zero installation: npx -y @mobilepixel/mcp@latest
- Cross-Platform - iOS & Android support via Appium 2.x
- 20 Core Tools - Essential mobile automation capabilities
- Easy Integration - Simple setup with MCP protocol
- Apache 2.0 License - Free for commercial and personal use
- Community Support - GitHub issues and discussions
- Pro Upgrade Available - Seamless path to advanced features
---
Comparison: Free vs Pro
$3
> Note: Pro version is currently in development and will be available soon.
| Feature | Free (Open Source) | Pro (Planned) |
|---------|:----------------------:|:-----------------:|
| License | Apache 2.0 | Commercial |
| Tools Count | 20 | 37 (Individual) / 94+ (Team) |
| Pricing | FREE | $20/month (Individual)
Contact for Team |
| | | |
| Core Features | | |
| Device Management | Yes | Yes |
| App Management | Yes | Yes |
| Basic Interactions | Yes | Yes |
| Screenshots & Logs | Yes | Yes |
| MCP Protocol | Yes | Yes |
| | | |
| AI & Advanced Features | | |
| AI Element Finding | No | Yes (0ms instant) |
| OCR Text Recognition | No | Yes (500ms) |
| Visual Regression Testing | No | Yes |
| Smart Login/Form Filling | No | Yes (95% success) |
| Screenshot Annotations | No | Yes |
| | | |
| Enterprise Features (Team) | | |
| Parallel Execution | No | Yes (2-8x speedup) |
| Test Sharding (CI/CD) | No | Yes |
| Performance Monitoring | No | Yes (CPU/Memory/FPS) |
| Accessibility Testing | No | Yes (WCAG 2.1) |
| Network Interception | No | Yes (HAR Export) |
| Flaky Test Detection | No | Yes |
| Self-Healing Selectors | No | Yes (AI-powered) |
| | | |
| Platform Support | | |
| iOS Simulators | Yes | Yes |
| Android Emulators | Yes | Yes |
| Real Devices | Yes | Yes |
| React Native | Limited | Yes (Full support) |
| | | |
| Documentation & Support | | |
| Documentation | Yes (Comprehensive) | Yes (Comprehensive) |
| Community Support | Yes (GitHub) | Yes (GitHub) |
| Email Support | No | Yes (48h, Pro) |
| Priority Support | No | Yes (4h, Team) |
$3
Clear Roadmap - Free version available now, Pro version coming soon
Transparent Features - Detailed comparison of what's included in each edition
Upgrade Path - Start free, upgrade when Pro becomes available
Enterprise Ready - Pro Team will offer parallel execution, test sharding, and more
---
Installation
$3
The fastest way to get started - no installation required!
`bash
Start MCP server instantly with npx
npx -y @mobilepixel/mcp@latest
`
Benefits:
- No global installation needed
- Always use the latest version
- Perfect for CI/CD environments
- Works on any machine with Node.js 18+
Use in MCP Config:
`json
{
"mcpServers": {
"mobilepixel": {
"command": "npx",
"args": ["-y", "@mobilepixel/mcp@latest"]
}
}
}
`
$3
MobilePixel works as an MCP (Model Context Protocol) server, allowing AI assistants like Claude in Cursor or Claude Desktop to use mobile automation tools.
#### For Cursor
1. Create or edit .cursor/mcp.json in your project root:
`json
{
"mcpServers": {
"mobilepixel": {
"command": "npx",
"args": ["-y", "@mobilepixel/mcp@latest"]
}
}
}
`
2. Restart Cursor to load the MCP server.
3. The MobilePixel tools will be available to Claude in Cursor.
#### For Claude Desktop
1. Open Claude Desktop settings and edit the MCP configuration file (location varies by OS):
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
2. Add MobilePixel to the mcpServers section:
`json
{
"mcpServers": {
"mobilepixel": {
"command": "npx",
"args": ["-y", "@mobilepixel/mcp@latest"]
}
}
}
`
3. Restart Claude Desktop.
$3
For users who prefer a traditional installation:
`bash
npm install -g @mobilepixel/mcp
`
After installation, you can start the MCP server manually:
`bash
mcp-server-mobile
`
When to use global installation:
- You want to avoid npx download time on every start
- Working on local projects without internet
- Running on a dedicated test server
$3
- Node.js 18 or higher
- Appium 2.x installed and running
- iOS Simulator or Android Emulator
---
Quick Start
Once installed and configured, you can use MobilePixel tools through your AI assistant:
`
Claude, use MobilePixel to:
1. List available devices
2. Connect to iOS simulator
3. Launch the app with bundle ID "com.example.app"
4. Take a screenshot and show me what's on screen
`
---
What's Included
$3
The Open Source version includes 20 essential tools for basic mobile automation:
#### Device Discovery & Management (3 tools)
- mobile_list_available_devices - List all connected devices and simulators
- mobile_connect_device - Connect to a specific device
- mobile_disconnect_device - Disconnect from current device
#### App Management (3 tools)
- mobile_list_apps - List installed applications on device
- mobile_launch_app - Launch an application by package name
- mobile_terminate_app - Stop a running application
#### Screen Information (2 tools)
- mobile_get_screen_size - Get screen dimensions in pixels
- mobile_list_elements_on_screen - List all UI elements with coordinates and properties
#### Basic Interactions (5 tools)
- mobile_click_on_screen_at_coordinates - Tap at specific pixel coordinates
- mobile_long_press_on_screen_at_coordinates - Long press at coordinates
- mobile_swipe_on_screen - Swipe gesture (up/down/left/right)
- mobile_type_keys - Type text into focused element
- mobile_press_button - Press system buttons (HOME, BACK, ENTER, etc.)
#### Additional Features (3 tools)
- mobile_open_url - Open URL in device browser
- mobile_save_screenshot - Capture and save screenshot to file
- mobile_set_orientation - Change screen orientation (portrait/landscape)
#### Diagnostics & Logs (4 tools)
- mobile_get_app_logs - Get application logs for debugging
- mobile_clear_app_logs - Clear application logs (Android only)
- mobile_get_crash_logs - Get crash logs with stack traces
- mobile_get_system_errors - Get system-level error logs
Total: 20 tools - Everything you need for basic mobile automation and testing.
---
Usage Examples
$3
`typescript
// Ask Claude in Cursor:
"Please help me test the login flow on my mobile app:
1. List available iOS simulators
2. Connect to iPhone 15 simulator
3. Launch app with bundle ID 'com.myapp.demo'
4. Wait 2 seconds for app to load
5. List all elements on screen
6. Tap on the username field at coordinates you find
7. Type 'testuser@example.com'
8. Tap on the password field
9. Type 'password123'
10. Tap the 'Sign In' button
11. Take a screenshot to verify login
12. Get app logs to check for errors"
`
$3
`typescript
// Natural language commands through MCP:
"Connect to my Android emulator and show me what apps are installed"
"Launch the Calculator app and take a screenshot"
"Swipe up on the home screen and list all visible elements"
"Navigate to Settings and change orientation to landscape"
`
$3
`typescript
// Ask Claude:
"Help me create a visual regression test:
1. Connect to iPhone 14 Pro simulator
2. Launch app 'com.myapp.prod'
3. Navigate to the home screen
4. Take a screenshot and save as 'baseline-home.png'
5. Now navigate to profile screen
6. Take another screenshot as 'baseline-profile.png'
7. Navigate back to home
8. Take a new screenshot as 'current-home.png'
9. Compare current with baseline and tell me if they match"
`
$3
`typescript
// Ask Claude:
"I need to test on multiple devices, please:
1. List all available iOS and Android devices
2. Show me which ones are currently running
3. Connect to the first iOS device
4. Get screen size and orientation
5. Take a screenshot
6. Disconnect and connect to first Android device
7. Repeat steps 4-5 for Android
8. Compare the two screenshots"
`
$3
`typescript
// Natural conversation with Claude:
User: "I want to test my new iOS app build"
Claude: "I'll help you with that. First, let me list available iOS devices..."
// Uses mobile_list_available_devices
User: "Connect to iPhone 15 Pro"
Claude: "Connected! What's the bundle ID of your app?"
User: "It's com.mycompany.myapp"
Claude: "Let me check if it's installed..."
// Uses mobile_list_apps, then mobile_launch_app
Claude: "App launched successfully! Would you like me to take a screenshot?"
`
---
Demo & Screenshots
$3
We're preparing demo videos and GIFs showing:
- Quick setup with Cursor/Claude Desktop
- iOS and Android automation in action
- AI-powered natural language testing
- Real-world test scenarios
$3
If you've created demos or screenshots using MobilePixel, we'd love to feature them!
Please submit via GitHub Issues with the demo label.
---
Upgrade to Pro
Need more power? Upgrade to MobilePixel Pro for advanced features:
$3
| Feature | Open Source | Pro Individual | Pro Team |
|---------|------------|-----|------|
| Total Tools | 20 | 37 | 94+ |
| Core Tools | Yes (20) | Yes (20) | Yes (20) |
| AI-Powered Tools | No | Yes (8) | Yes (8) |
| Visual Testing | No | Yes (9) | Yes (9) |
| Enterprise Tools | No | No | Yes (57+) |
| | | | |
| Key Features | | | |
| AI Element Finding | No | Yes (0ms instant) | Yes (0ms instant) |
| Smart Login | No | Yes (95% success) | Yes (95% success) |
| OCR Text Recognition | No | Yes (~500ms) | Yes (~500ms) |
| Visual Regression | No | Yes | Yes |
| Parallel Execution | No | No | Yes (2-8x speedup) |
| Test Sharding | No | No | Yes |
| Performance Monitoring | No | No | Yes |
| Flaky Test Detection | No | No | Yes |
| Self-Healing Selectors | No | No | Yes |
| Accessibility Testing | No | No | Yes (WCAG 2.1) |
| | | | |
| Support | | | |
| Community (GitHub) | Yes | Yes | Yes |
| Email Support | No | Yes | Yes |
| Priority Support | No | No | Yes |
| Custom Integrations | No | No | Yes |
$3
Pro Individual includes everything from Open Source plus:
#### AI-Powered Automation (8 tools)
- Natural Language Element Finding - Find elements by description (0ms instant search)
- Smart Element Interaction - Tap elements using natural language (85% success rate)
- Smart Login - One-command auto-login with 95% success rate
- Smart Form Filling - Automatically fill forms intelligently (90% success rate)
- AI Element Finder - 754x faster element finding with intelligent caching
- OCR Text Recognition - Extract text from screenshots when accessibility API fails (~500ms)
- Keyboard Management - Automatic keyboard hiding and management
- Text Extraction - Extract all text from screenshots using OCR
#### Visual Testing Suite (9 tools)
- Touch Indicators - Visual feedback for taps and interactions
- Demo Mode - Full visual feedback mode for presentations
- Screenshot Annotations - Add markers, highlights, and annotations
- Visual Regression Testing - Pixel-perfect screenshot comparisons
- Baseline Management - Create and manage visual test baselines
- Touch Indicator Controls - Enable/disable/toggle visual touch feedback
- Screenshot Comparison - Automated visual diff detection
- Visual Test Reports - Detailed reports with visual diffs
- Annotation Tools - Mark and highlight areas in screenshots
Total: 37 tools (20 core + 8 AI + 9 visual)
$3
Pro Team includes everything from Pro Individual plus enterprise-grade features:
#### Parallel Execution & Scaling (5+ tools)
- Parallel Test Execution - Run tests on multiple devices simultaneously (2-8x speedup)
- Test Sharding - Automatically distribute tests across device pools for CI/CD
- Device Pool Management - Manage and orchestrate multiple devices
- Concurrent Operations - Execute multiple actions in parallel
- Load Balancing - Intelligent distribution of test workload
#### Performance Monitoring (5+ tools)
- CPU Monitoring - Real-time CPU usage tracking
- Memory Monitoring - Memory usage and leak detection
- FPS Tracking - Frame rate monitoring for performance testing
- Network Monitoring - Intercept and analyze network traffic
- Performance Profiling - Detailed performance analysis and reports
#### Test Intelligence (8+ tools)
- Flaky Test Detection - Identify unstable tests with >20% failure rate
- Self-Healing Selectors - Automatically fix broken selectors using AI
- Test Data Generation - Generate realistic test data automatically
- Test Recording - Record user actions for test generation
- Code Generation - Generate test code from recorded actions
- Test Metrics Collection - Collect and analyze test execution metrics
- Test Context Management - Advanced test state and context tracking
- Test Flakiness Analysis - Deep analysis of test stability
#### Advanced Features (20+ more tools)
- Accessibility Testing (WCAG 2.1)
- Video & Trace Recording
- Bug Report Generation
- CI/CD Integration (JUnit, JSON, TAP)
- Security & Compliance tools
- And many more...
Total: 94+ tools (20 core + 8 AI + 9 visual + 57+ enterprise)
$3
Open Source is perfect for:
- Basic mobile automation needs
- Learning and experimentation
- Simple CI/CD integration
- Personal projects
- Small test suites
Pro Individual is ideal for:
- Solo developers and freelancers
- Projects requiring AI-powered element finding
- Visual testing and regression testing
- Faster test development with smart automation
- Small teams (1-3 people)
Pro Team is designed for:
- Teams and organizations
- Large-scale test execution
- Performance monitoring and optimization
- Enterprise CI/CD pipelines
- Advanced debugging and analytics
- Accessibility compliance requirements
- Complex test scenarios requiring parallel execution
View Pricing & Upgrade →
---
Configuration
Set up environment variables:
`bash
Appium server URL (default: http://localhost:4723)
export APPIUM_SERVER_URL="http://localhost:4723"
Enable debug logging
export DEBUG=mobilepixel:*
Pro version license key (if you have Pro)
export MOBILEPIXEL_LICENSE_KEY="your-license-key-here"
`
---
Known Issues & iOS Testing Status
$3
Limited iOS Testing: This open-source version has received limited testing on iOS devices and simulators. While the core functionality is designed to work with iOS, you may encounter bugs or unexpected behavior that hasn't been discovered during development.
$3
If you encounter any bugs or issues, please report them through:
1. GitHub Issues - For detailed technical issues:
- Report a bug on GitHub
- Include steps to reproduce, error messages, and device/iOS version
2. Email - mr.trockiy@gmail.com
- For general bug reports and support
- Please include: iOS version, device type, what you were trying to do, and error messages
Your feedback helps us improve the tool for everyone!
---
Documentation
- Quick Start Guide
- API Reference
- MCP Integration Guide
- Examples
- FAQ
---
Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
`bash
Clone the repo
git clone https://github.com/MrTrotskiy/mobilepixel.git
Install dependencies
npm install
Run tests
npm test
Build
npm run build:open
``