$ timeahead.in
/ servers/npm/@midscene/android-mcp
npm

@midscene/android-mcp

Midscene MCP Server for Android automation

14k stars781/wkupdated 0d agogithub ↗
81good
▣ Overview

What it does

An MCP server exposing Midscene's vision-driven UI automation for Android devices and emulators. Rather than relying on selectors or accessibility trees—which break on UI changes and fail on custom controls—it works from screenshots alone. It pairs Claude with multimodal AI models (Qwen, Doubao, GLM-4.6V, Gemini, or self-hosted UI-TARS) to localize and interact with UI elements. Claude describes actions in natural language and the server translates them into device interactions: taps, text input, assertions on visual state. Handles both native and cross-platform Android apps.

Who it's for

Android QA engineers and test automation teams moving away from brittle, selector-based testing. Developers integrating AI-driven test flows for native apps. Teams testing applications that DOM-based tools can't reach.

Common use cases

  • Automate Android app testing without maintaining selectors across UI refactors
  • Test native Android apps and cross-platform applications
  • Verify visual properties, colors, and layout on Android screens
  • Build AI-driven end-to-end test flows and scenarios
  • Automate complex user journeys requiring human-like interaction (form filling, navigation)

Setup pitfalls

  • Requires Android device or emulator with ADB connectivity and appropriate permissions
  • Requires API key for a compatible multimodal model; Midscene supports several (Qwen, Doubao, GLM-4.6V, Gemini) but configuration varies by provider
  • secrets_found: 1 — repository contains credentials; handle and secure carefully before use
  • Model choice affects performance; select models with strong UI localization capability for reliable interactions
  • Network access required to reach model APIs; offline or air-gapped environments won't work
1 credential detected in repository history via Gitleaks
▣ Score BreakdownMCPScore = Σ(raw × weight)
DimensionRawWeighted
Security
35%
80
28.0
Freshness
25%
100
25.0
Adoption
20%
68
13.5
Quality
10%
90
9.0
Trust
10%
50
5.0
Total
80.5
⚿ Capabilities & Risk Explainer
fs readfs writenetworkexecevalsecrets
◆ Risk level: high
fs read + fs write + network + exec + eval + secrets active — can execute code, access credentials, and make external network calls.
⚙ Install config
Claude Desktop · Cursor · Windsurf · VS Code (Copilot) · Claude Code
add to your MCP client config:
{
  "mcpServers": {
    "midsceneandroid": {
      "command": "npx",
      "args": [
        "-y",
        "@midscene/android-mcp"
      ]
    }
  }
}
📈 Score historylast 48 snapshots
4/30/20267/6/2026 · 48 snapshots
⚙ Maintenance health
74/ 100 · is this project alive?
contributors (1y)39
top contributor share45%
releases (1y)100
last release3d ago
ci✓ passing
⛁ Raw data
weekly downloads781
github stars14k
forks1k
open issues48
license✓ present
readme length9353 chars
last publish0d ago
last commit0d ago
last updated1d ago
install verified✓ pass · 46d ago
owner of this server? claim your listing to get a verified badgeclaim →
🔔 Score drop alerts
get notified by email when this server's score drops 5+ points