Android-MCP MCP — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

10 tools: state, click, long-click, type, swipe, drag, press, wait, notification, shell
Device selection: USB serial, WiFi IP:port, or auto-detect
State tool captures the UI tree for automated assertions
Shell tool exposes full adb shell for advanced ops
Typical latency 2-4s per action — fine for QA, not for realtime gaming

Live-Demo

In der Praxis

android.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "android": {
      "command": "uvx",
      "args": [
        "Android-MCP"
      ],
      "_inferred": true
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "android",
      "command": "uvx",
      "args": [
        "Android-MCP"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "android": {
      "command": {
        "path": "uvx",
        "args": [
          "Android-MCP"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add android -- uvx Android-MCP

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Android-MCP

Automate a smoke test of your Android app

👤 Mobile QA engineers, dev teams without a test framework ⏱ ~30 min intermediate

Wann einsetzen: You want 'app opens, login, main screen loads' as an auto-run before every release.

Voraussetzungen

ADB installed and device connected — Android Studio ships ADB; adb devices should show your device
Device has USB debugging or wireless debugging on — Settings > Developer Options > USB Debugging

Ablauf

Capture current state

Get the UI state — what screen am I on and what elements are visible?✓ Kopiert

→ UI tree with labeled elements
Execute the flow

Tap the 'Sign In' button, type '[email protected]' in the email field, 'P@ss' in password, submit.✓ Kopiert

→ App transitions to home
Assert success

Verify the home screen's 'Welcome' banner is visible. If not, fail.✓ Kopiert

→ Pass/fail verdict

Ergebnis: A scriptable smoke test you can run on every build.

Fallstricke

Coordinates change between device sizes — Prefer State-Tool queries that find elements by label/id, then click the returned coordinates
Flow breaks on A/B tests — Pin build config or disable experiments for QA builds

Kombinieren mit: github

Run a repeatable product demo on a live device

👤 Sales engineers, product folks doing investor demos ⏱ ~20 min intermediate

Wann einsetzen: You want the app driven hands-free while you talk.

Ablauf

Script the demo

Script these 5 steps with 3s pauses: open app, tap Explore, scroll to Category B, tap item X, take a screenshot.✓ Kopiert

→ Step plan
Dry run

Execute. Pause between steps so I can narrate.✓ Kopiert

→ Device follows

Ergebnis: A glitch-free demo you can re-run identically.

Triage notifications on a dev device

👤 Developers testing notification flows ⏱ ~10 min beginner

Wann einsetzen: Verifying push notifications arrive and look right.

Ablauf

Read recent notifications

List active notifications. Flag any from com.myapp.prod.✓ Kopiert

→ Filtered list
Inspect one

Pull the full content of the latest myapp notification; does it match our expected format?✓ Kopiert

→ Diff against expected

Ergebnis: Fast confirmation that your push pipeline works.

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

android + github

Run smoke tests on PRs and post results

When PR #88 has a new APK artifact, install to the connected device, run the smoke test flow, comment results on the PR.✓ Kopiert

android + filesystem

Save screenshots and logs as QA artifacts

Take a screenshot after each step of the demo flow and save to ./qa/2026-04-14/step-N.png.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
State-Tool	(none)	Always first — know what's on screen	free
Click-Tool	x: int, y: int	Tap at a point returned by State	free
Long-Click-Tool	x, y, duration_ms?	Context menus	free
Type-Tool	text: str, clear_first?: bool	Enter text in the focused field	free
Swipe-Tool	x1,y1,x2,y2, duration_ms?	Scroll or gesture	free
Drag-Tool	start_x,y,end_x,y	Drag-and-drop flows	free
Press-Tool	key: Back\|Home\|VolumeUp\|...	Hardware keys / system nav	free
Wait-Tool	ms: int	Wait for animation/transition	free
Notification-Tool	(none) or package: str	Inspect notifications	free
Shell-Tool	cmd: str	Escape hatch for logs, am/pm commands, etc.	free (but powerful — dangerous)

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: None — all local via ADB
Tokens pro Aufruf: State tool returns UI trees that can be 2-10k tokens on dense screens
Kosten in €: Free
Tipp: Ask State to filter by a query ('find buttons with Sign In') rather than dump the whole tree.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: None; ADB trust is on the device

Datenabfluss: All local; ADB over USB or local Wi-Fi only

Niemals gewähren: Shell-Tool on devices with production data — it can read private files

Shell-Tool is essentially adb shell — treat it as root-ish privilege on debuggable devices.
Wireless debugging exposes ADB on your LAN — disable when not testing.

Fehlerbehebung

Häufige Fehler und Lösungen

adb: device unauthorized

Accept the fingerprint prompt on the device screen, then retry.

Prüfen: adb devices

No devices found

Check USB debugging is on and USB cable supports data. For WiFi, verify ip:port with adb connect.

Prüfen: adb devices

Coordinates off on different screen

Use State-Tool to get current coords for the labeled element rather than hardcoded x,y.

Prüfen: Call State before click

Type-Tool inserts garbage characters

Device uses a non-US keyboard; switch to US or use adb shell input text via Shell-Tool.

Prüfen: adb shell settings get secure default_input_method

Alternativen

Android-MCP vs. andere

Alternative	Wann stattdessen	Kompromiss
Appium	You want a full QA framework with assertions and reports	Heavy setup; no MCP layer
Maestro	YAML-based UI tests	No MCP integration

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen