Ligne de commande

device-mcp-cli est la ligne de commande de Device MCP. Ce que vous faites dans l'app, ou demandez à votre agent IA de faire, vous pouvez l'exécuter depuis Terminal, un script shell, un Makefile ou la CI : lister vos appareils, prendre des captures d'écran, lire l'écran, toucher et saisir du texte, lancer et installer des apps, définir la position, et gérer votre licence.

Chaque commande peut répondre en JSON : vos scripts lisent le résultat avec jq au lieu d'analyser du texte.

1. Installation#

• Homebrew : brew install --cask device-mcp place device-mcp-cli dans votre PATH.
• Téléchargé depuis le site web : exécutez ceci une fois dans Terminal pour l'ajouter à votre PATH :

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

Le lien continue de fonctionner quand Device MCP se met à jour. Vérifiez-le avec :

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

2. Fonctionnement#

• Device MCP exécute vos commandes. Les commandes d'appareil sont envoyées à l'app Device MCP sur votre Mac. Si elle n'est pas en cours d'exécution, la commande vous demande avant de l'ouvrir : --launch l'ouvre sans demander (à utiliser dans les scripts), --no-launch ne l'ouvre jamais. status, mcp, tools et logs ne l'ouvrent jamais.
• Quel appareil : ajoutez --device (ou -d) suivi du nom ou de l'UDID d'un appareil. Sans cette option, les commandes utilisent l'appareil que vous avez choisi avec devices select, sinon celui qui est sélectionné dans Device MCP.
• JSON : ajoutez --json à n'importe quelle commande. Les erreurs sont elles aussi renvoyées en JSON.
• Vous gardez le contrôle : l'installation et la suppression d'apps, l'ouverture de liens, la lecture ou la modification du presse-papiers et Build & Run demandent d'abord votre accord dans Device MCP, comme pour un agent IA. Consultez Approbations. La dissociation d'un appareil et la désactivation de votre licence demandent toujours votre accord.
• Version gratuite et Pro : toutes les commandes fonctionnent avec Device MCP Free, sauf Build & Run, l'installation d'apps et l'inspecteur de vues 3D, qui nécessitent Device MCP Pro. Device MCP Free recopie un appareil à la fois.

3. Commandes#

<device> est le nom ou l'UDID d'un appareil. Toutes les commandes acceptent --json ; les commandes d'appareil acceptent --device.

Appareils#

L'écran#

Toucher et clavier#

Apps#

Réglages de l'appareil#

Device MCP#

Tout le reste#

4. Exemples#

Se connecter et vérifier le résultat#

Un test de fumée pour votre app, dans un script shell ou une étape de CI :

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
}

Prendre une capture d'écran de chaque appareil#

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

Toucher un élément à l'écran#

elements liste l'écran avec des références. Trouvez-en une avec jq, puis touchez-la :

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

Tester votre app dans une autre langue et à un autre endroit#

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

Compiler et lancer sur un nouveau simulateur#

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

Enregistrer un bug#

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

Configurer un Mac#

Sur un Mac de CI ou le Mac d'un nouveau collègue :

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 et codes de sortie#

Avec --json, une commande affiche un seul objet JSON. Par exemple, 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"
    }
  ]
}

Le kind d'un appareil vaut iphone, ipad, watch, android, simulator ou emulator. Son state vaut ready, locked, blocked (avec issue et fix, qui indiquent pourquoi et quoi faire), connecting, running, shut_down, booting, shutting_down, creating ou starting.

Une erreur affiche {"error": {"code": "…", "message": "…"}} :

Une commande qui réussit se termine avec le code 0.

6. Avec votre agent IA#

Votre agent peut aussi utiliser la ligne de commande, par exemple pour écrire un script de test ou une étape de CI pour votre app :

• « Écris un script qui se connecte sur mon iPhone et échoue si l'écran d'accueil ne se charge pas. »
• « Ajoute une étape de CI qui prend une capture d'écran de chaque écran du parcours d'onboarding. »

Les commandes que lance votre agent apparaissent dans l'onglet Agent sous le nom device-mcp-cli. Consultez Activité de l'agent.