1. Conduid
  2. Data
  3. mobile-pixel
MCP server · Data

mobile-pixel

by · github.com/rogerfuentes/mobile-pixel-mcp

Visual-first MCP server for mobile automation

Unclaimed data
InstallView source
39Low

Scored 6 days ago · breakdown

About mobile-pixel

mobile-pixel is an MCP server published by git+rogerfuentes in the Data category: visual-first MCP server for mobile automation.

Install

Install
npx mobile-pixel-mcp
Claude Code
claude mcp add mobile-pixel-mcp -- npx -y mobile-pixel-mcp
npx
npx -y mobile-pixel-mcp

This 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.

Tools (14)

check_app_logTail recent app logs

Parameters not published.

check_app_statusCheck if app is running

Parameters not published.

configure_deviceSwitch device/platform dynamically

Parameters not published.

find_textFind text coordinates (OCR)

Parameters not published.

get_screenCapture current device screen

Parameters not published.

homePress Home button

Parameters not published.

install_appInstall app from local path

Parameters not published.

launch_appLaunch/Resume an app

Parameters not published.

reset_appReset app data/state

Parameters not published.

swipeSwipe gesture

Parameters not published.

Show all 14 tools
tapTap at coordinates

Parameters not published.

tap_textFind text and tap center (OCR)

Parameters not published.

type_textInput text into focused element

Parameters not published.

uninstall_appUninstall app

Parameters not published.

Ask AI

✦

Ask AI about mobile-pixel

Powered by Claude · Grounded in docs

I know everything about mobile-pixel. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

4 checks have not been run yet.

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 devices shows your device)

iOS

  • IDB (iOS Development Bridge) installed and in PATH
  • Xcode and Xcode Command Line Tools (xcrun simctl support)
  • Simulator running or physical device connected

Features

  • Visual-First: Uses screenshots + coordinates (OCR/Computer Vision ready)
  • Automatic OCR: find_text and tap_text tools 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:

  1. Clone: git clone <repo>
  2. Install: npm install
  3. Build: npm run build
  4. Run: 
    # Android
npm start
# iOS
npm start -- --platform=ios
  5. 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 copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About mobile-pixel

How do I install mobile-pixel?

Run npx mobile-pixel-mcp, then add the server to your MCP client's configuration.

Is mobile-pixel safe to use with an AI agent?

Its trust score is 39 out of 100 (low). It passes 1 of the 2 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is mobile-pixel still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.