Mobile MCP — Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Plattformunabhängig: dieselben Tools für iOS + Android
Funktioniert mit Simulatoren, Emulatoren und echten Geräten
Screenshot + DOM-äquivalente View-Hierarchie
APK/IPA von URL oder lokalem Pfad installieren
Kein Mobile-Testing-Fachwissen erforderlich

Live-Demo

In der Praxis

mobile-mcp.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": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

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

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

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mobile-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mobile-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mobilenext/mobile-mcp@latest"
        ]
      }
    }
  }
}

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

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest

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

Anwendungsfälle

Praxisnahe Nutzung: Mobile MCP

Smoke-Test deiner App auf iOS + Android aus einem Prompt

👤 Mobile-QA, Entwickler ohne dediziertes QA-Team ⏱ ~20 min intermediate

Wann einsetzen: Du hast gerade einen Build erstellt und willst wissen, ob der Sign-Up-Flow auf beiden Plattformen noch funktioniert.

Voraussetzungen

Simulator gestartet — xcrun simctl boot "iPhone 16" und emulator -avd Pixel_7
App installiert — IPA/APK in den Simulator ziehen oder install_app-Tool nutzen

Ablauf

Session starten

Nutze mobile-mcp. Liste alle verfügbaren Geräte auf.✓ Kopiert

→ iOS-Simulator + Android-Emulator aufgelistet
Flow ausführen

Auf beiden Geräten parallel: App öffnen, „Sign Up“ tippen, [email protected] / password123 eingeben, Continue tippen. Jeden Schritt screenshotten.✓ Kopiert

→ Dual-Gerät-Screenshot-Sequenz
Assertieren

Ist auf jedem Gerät der Bildschirm „Verify your email“ sichtbar? Falls nicht, berichte, was du siehst.✓ Kopiert

→ Plattformweises Bestanden/Nicht bestanden mit Belegen

Ergebnis: Bestanden/Nicht-bestanden-Bericht mit Screenshots für beide Plattformen in 2 Minuten.

Fallstricke

Testkonto durch Anti-Spam gesperrt — Pro Build Wegwerf-E-Mails verwenden; Testkonten rotieren

Kombinieren mit: filesystem

App-Store-Screenshots für 5 Gerätegrößen generieren

👤 Indie-Entwickler, die im App Store einreichen ⏱ ~25 min intermediate

Wann einsetzen: Du brauchst 6,5", 6,7", 5,5"-Screenshots und willst das nicht manuell erledigen.

Voraussetzungen

Simulatoren für jede erforderliche Größe — Via xcrun simctl mit den entsprechenden Gerätetypen erstellen

Ablauf

Matrix aufbauen

iPhone 15 Pro Max, iPhone 15, iPhone SE Simulatoren starten. Meine App auf jedem installieren.✓ Kopiert

→ Alle drei Geräte bereit mit installierter App
Flow aufnehmen

Auf jedem Gerät zu den 5 Hauptbildschirmen navigieren (Onboarding, Feed, Detail, Einstellungen, Upgrade). Jeden in voller Auflösung screenshotten.✓ Kopiert

→ Screenshots pro Gerät mit einheitlicher Benennung gespeichert

Ergebnis: App-Store-fertige Screenshots in allen erforderlichen Größen, in einem Durchlauf.

Fallstricke

Screenshots enthalten Simulator-Statusleiste — --status-bar-style=overridden verwenden oder mit crop nachbearbeiten

Kombinieren mit: filesystem

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

mobile-mcp + filesystem

Screenshots in versionierten QA-Ordnern speichern

Jeden Screenshot unter /qa/$(date)/ mit dem Test-Namen speichern.✓ Kopiert

mobile-mcp + xcodebuild

Bauen, installieren und testen in einem Flow

iOS-App via xcodebuild bauen, via mobile-mcp installieren, Smoke-Test ausführen.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
list_devices	none	Immer zuerst — wissen, was verfügbar ist	free
launch_app	device_id, bundle_id	App auf dem Gerät öffnen	free
tap	device_id, selector\|coords	Mit einem Button/Steuerelement interagieren	free
type_text	device_id, text: str	Textfeld ausfüllen (muss vorher fokussiert sein)	free
get_view_hierarchy	device_id	Herausfinden, was auf dem Bildschirm angezeigt wird	free
screenshot	device_id, path?: str	Visuelle Verifikation	free

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Lokal
Tokens pro Aufruf: View-Hierarchie kann 10k+ Token sein; Screenshots sind Base64
Kosten in €: Kostenlos
Tipp: Selektor-basiertes Tippen gegenüber vollständigen View-Hierarchie-Dumps bevorzugen, um Token zu sparen

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: device access (physical USB requires trust dialog)

Credential-Speicherung: Keine

Datenabfluss: Keine vom MCP; Screenshots fließen zum LLM-Anbieter, wenn sie geteilt werden

Niemals gewähren: production device access with PII

Nicht gegen Geräte mit Produktionsdaten testen — dedizierte QA-Konten verwenden

Fehlerbehebung

Häufige Fehler und Lösungen

Keine Geräte aufgelistet

Zuerst einen Simulator starten: xcrun simctl boot / emulator -avd X

Prüfen: `xcrun simctl list | grep Booted`

tap_at_coords verfehlt

get_view_hierarchy ausführen und selektor-basiertes Tippen verwenden — Koordinaten brechen bei verschiedenen Bildschirmgrößen

Echtes Gerät nicht vertraut

Unter iOS: Einstellungen → Allgemein → Geräteverwaltung → Vertrauen. Unter Android: USB-Debugging aktivieren.

Alternativen

Mobile MCP vs. andere

Alternative	Wann stattdessen	Kompromiss
XcodeBuildMCP	Du brauchst iOS-only Build + Test, keine plattformübergreifende UI-Automatisierung	Kein Android; stärker auf Build-Tooling ausgerichtet
Appium	Du willst ein vollständiges CI-fähiges Mobile-Testing-Framework	Deutlich mehr Setup; nicht MCP-nativ

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen