About mobile-pixel
mobile-pixel is an MCP server published by git+rogerfuentes in the Data category: visual-first MCP server for mobile automation. It has been installed 0 times through Conduid.
Install
npx mobile-pixel-mcpclaude mcp add mobile-pixel-mcp -- npx -y mobile-pixel-mcpnpx -y mobile-pixel-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about mobile-pixel
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
Mobile Pixel MCP
A lightweight, visual-first Model Context Protocol (MCP) server for mobile device automation. Enables AI models to control and interact with mobile devices through screenshots and coordinate-based interactions.
Quick Start
Add this to your MCP client configuration (e.g., Claude Desktop, Cursor):
{
"mcpServers": {
"mobile-pixel": {
"command": "npx",
"args": [
"-y",
"mobile-pixel-mcp@latest"
]
}
}
}
You can optionally pass arguments to specify a platform or device:
"args": ["-y", "mobile-pixel-mcp@latest", "--platform", "ios"]
Prerequisites
Start the server after ensuring your environment is ready:
Android
- Android Debug Bridge (ADB) installed and in PATH
- USB debugging enabled on device, or emulator running
- Device connected and authorized (
adb devicesshows your device)
iOS
- IDB (iOS Development Bridge) installed and in PATH
- Xcode and Xcode Command Line Tools (
xcrun simctlsupport) - Simulator running or physical device connected
Features
- Visual-First: Uses screenshots + coordinates (OCR/Computer Vision ready)
- Automatic OCR:
find_textandtap_texttools included - Telemetry Bridge: Read app logs via MCP
- Smart Launch: Context-aware app launching (resumes if running, cold start if not)
- Cross-platform support (Android & iOS)
Available Tools
| Tool | Description | Parameters |
|---|---|---|
get_screen |
Capture current device screen | None |
tap |
Tap at coordinates | x, y |
swipe |
Swipe gesture | x1, y1, x2, y2, duration_ms |
type_text |
Input text into focused element | text |
home |
Press Home button | None |
launch_app |
Launch/Resume an app | app_id |
check_app_status |
Check if app is running | app_id |
find_text |
Find text coordinates (OCR) | text |
tap_text |
Find text and tap center (OCR) | text |
check_app_log |
Tail recent app logs | tag, filter_text |
configure_device |
Switch device/platform dynamically | platform, device_id, app_id |
install_app |
Install app from local path | path |
uninstall_app |
Uninstall app | app_id |
reset_app |
Reset app data/state | app_id |
Configuration
The server supports persistent configuration to avoid specifying arguments on every restart. It looks for mobile-pixel.config.json in the current working directory. The server will automatically create this file with default settings if it doesn't exist.
Dynamic Switching
You can use the configure_device tool to switch platforms (e.g., from Android to iOS) or target devices without restarting the MCP server. This updates the mobile-pixel.config.json file automatically.
Manual Configuration (mobile-pixel.config.json)
{
"platform": "android",
"deviceId": "emulator-5554",
"appId": "com.example.app",
"mainActivity": ".MainActivity"
}
Local Development & Installation
If you want to run from source or contribute:
- Clone:
git clone <repo> - Install:
npm install - Build:
npm run build - Run:
# Android npm start # iOS npm start -- --platform=ios - Test:
npm test
Troubleshooting
"ADB/IDB is not available"
Ensure the respective tools (adb for Android, idb/xcrun for iOS) are installed and in your system PATH.
License
Apache-2.0
README mirrored from the source repository 3 months ago. The original is authoritative.