Befehlszeile

device-mcp-cli ist die Befehlszeile von Device MCP. Was du in der App machst oder deinen KI-Agenten machen lässt, kannst du auch im Terminal, in einem Shell-Skript, einem Makefile oder in CI ausführen: deine Geräte auflisten, Bildschirmfotos machen, den Bildschirm lesen, tippen und Text eingeben, Apps starten und installieren, den Standort festlegen und deine Lizenz verwalten.

Jeder Befehl kann in JSON antworten, sodass deine Skripte das Ergebnis mit jq lesen, statt Text zu parsen.

1. Installation#

• Homebrew: brew install --cask device-mcp legt device-mcp-cli in deinen PATH.
• Von der Website geladen: Führe einmal im Terminal Folgendes aus, um es in deinen PATH zu legen:

sudo ln -sf "/Applications/Device MCP.app/Contents/MacOS/device-mcp-cli" /usr/local/bin/device-mcp-cli

Der Link funktioniert weiter, wenn sich Device MCP selbst aktualisiert. Prüfe ihn mit:

device-mcp-cli --version
device-mcp-cli --help                  # every command
device-mcp-cli help apps launch        # one command, with its options

2. So funktioniert es#

• Device MCP führt deine Befehle aus. Gerätebefehle gehen an die App Device MCP auf deinem Mac. Läuft sie nicht, fragt der Befehl, bevor er sie öffnet: --launch öffnet sie ohne Rückfrage (nutze das in Skripten), --no-launch öffnet sie nie. status, mcp, tools und logs öffnen sie nie.
• Welches Gerät: Hänge --device (oder -d) mit dem Namen oder der UDID eines Geräts an. Ohne diese Option verwenden Befehle das Gerät, das du mit devices select gewählt hast, sonst das in Device MCP ausgewählte.
• JSON: Hänge --json an einen beliebigen Befehl an. Auch Fehler kommen dann in JSON.
• Du behältst die Kontrolle: Bevor Apps installiert oder entfernt, Links geöffnet, die Zwischenablage gelesen oder geändert oder Build & Run gestartet wird, fragt Device MCP dich, genau wie bei einem KI-Agenten. Siehe Freigaben. Vor dem Entkoppeln eines Geräts und dem Deaktivieren deiner Lizenz fragt Device MCP immer nach.
• Free und Pro: Jeder Befehl funktioniert mit Device MCP Free, außer Build & Run, dem Installieren von Apps und dem 3D-View-Inspector; dafür brauchst du Device MCP Pro. Free spiegelt jeweils ein Gerät.

3. Befehle#

<device> ist der Name oder die UDID eines Geräts. Jeder Befehl versteht --json, Gerätebefehle zusätzlich --device.

Geräte#

Der Bildschirm#

Berührungen und Tasten#

Apps#

Geräteeinstellungen#

Device MCP#

Alles andere#

4. Beispiele#

Anmelden und das Ergebnis prüfen#

Ein Smoke-Test für deine App, in einem Shell-Skript oder einem CI-Schritt:

set -e
device-mcp-cli apps launch com.example.myapp --launch
device-mcp-cli wait-for "Sign In"
device-mcp-cli type "[email protected]" --field "Email"
device-mcp-cli type - --field "Password" < password.txt
device-mcp-cli tap --text "Sign In"
device-mcp-cli wait-for "Welcome" --timeout 20 || {
  device-mcp-cli screenshot -o failure.png
  exit 1
}

Ein Bildschirmfoto von jedem Gerät machen#

device-mcp-cli devices --json |
  jq -r '.devices[] | select(.state == "ready" or .state == "running") | .udid' |
  while read -r udid; do device-mcp-cli screenshot --device "$udid" -o ~/Desktop/; done

Auf ein Element auf dem Bildschirm tippen#

elements listet den Bildschirm mit Referenzen auf. Finde eine mit jq und tippe dann darauf:

REF=$(device-mcp-cli elements --json | jq -r '.elements[] | select(.label == "General") | .ref')
device-mcp-cli tap --ref "$REF"

Deine App in einer anderen Sprache und an einem anderen Ort testen#

device-mcp-cli apps launch com.example.myapp --language fr --locale fr_FR
device-mcp-cli location set 48.8584 2.2945
device-mcp-cli open-url "myapp://map"
device-mcp-cli appearance dark

Auf einem neuen Simulator bauen und ausführen#

device-mcp-cli simulators start --model "iPhone 17 Pro" --launch
device-mcp-cli build-and-run ~/Projects/MyApp/MyApp.xcodeproj --scheme MyApp
device-mcp-cli screenshot -o ~/Desktop/myapp.png

Einen Bug aufnehmen#

device-mcp-cli record start
# reproduce the bug on the device
device-mcp-cli record stop

Einen Mac einrichten#

Auf einem CI-Mac oder dem Mac eines neuen Teammitglieds:

device-mcp-cli license activate --launch < license-key.txt
device-mcp-cli mcp on
device-mcp-cli mcp setup claude
device-mcp-cli status

5. JSON und Exit-Codes#

Mit --json gibt ein Befehl ein einziges JSON-Objekt aus. Zum Beispiel device-mcp-cli devices --json:

{
  "devices" : [
    {
      "connection" : "USB",
      "current" : true,
      "kind" : "iphone",
      "mirroringStopped" : false,
      "model" : "iPhone 17 Pro",
      "name" : "My iPhone",
      "osVersion" : "27.0.1",
      "platform" : "iOS",
      "state" : "ready",
      "udid" : "00008150-000A1B2C3D4E5F60"
    }
  ]
}

Das Feld kind eines Geräts ist iphone, ipad, watch, android, simulator oder emulator. Sein state ist ready, locked, blocked (dann sagen issue und fix, warum und was zu tun ist), connecting, running, shut_down, booting, shutting_down, creating oder starting.

Ein Fehler gibt {"error": {"code": "…", "message": "…"}} aus:

Ein Befehl, der klappt, endet mit dem Exit-Code 0.

6. Mit deinem KI-Agenten#

Auch dein Agent kann die Befehlszeile nutzen, zum Beispiel um ein Testskript oder einen CI-Schritt für deine App zu schreiben:

• „Schreib ein Skript, das sich auf meinem iPhone anmeldet und fehlschlägt, wenn der Startbildschirm nicht lädt.“
• „Füg einen CI-Schritt hinzu, der von jedem Bildschirm des Onboardings ein Bildschirmfoto macht.“

Befehle, die dein Agent ausführt, erscheinen im Tab Agent als device-mcp-cli. Siehe Agent-Aktivität.