Mobile MCP — Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Agnostique à la plateforme : mêmes outils pour iOS + Android
Fonctionne avec simulateurs, émulateurs et appareils réels
Capture d'écran + hiérarchie de vues équivalente au DOM
Installation d'APK/IPA depuis une URL ou un chemin local
Aucune expertise en tests mobiles requise

Démo en direct

Aperçu en pratique

mobile-mcp.replay ▶ prêt

0/0

Installer

Choisissez votre 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"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Mobile MCP

Tester sommairement votre app sur iOS + Android depuis un seul prompt

👤 QA mobile, devs sans équipe QA dédiée ⏱ ~20 min intermediate

Quand l'utiliser : Vous venez de créer un build et voulez savoir si le flux d'inscription fonctionne encore sur les deux plateformes.

Prérequis

Simulateur démarré — xcrun simctl boot "iPhone 16" et emulator -avd Pixel_7
App installée — Glissez l'IPA/APK dans le simulateur ou utilisez l'outil install_app

Déroulement

Démarrer la session

Utilise mobile-mcp. Liste tous les appareils disponibles.✓ Copié

→ Simulateur iOS + émulateur Android listés
Exécuter le flux

Sur les deux appareils en parallèle : ouvre mon app, tape « Sign Up », entre [email protected] / password123, tape Continue. Capture chaque étape.✓ Copié

→ Séquence de captures sur les deux appareils
Vérifier

Sur chaque appareil, l'écran « Verify your email » est-il visible ? Sinon, rapporte ce que tu vois.✓ Copié

→ Résultat succès/échec par plateforme avec preuves

Résultat : Rapport succès/échec avec captures d'écran pour les deux plateformes en 2 minutes.

Pièges

Le compte de test est bloqué par l'anti-spam — Utilisez des emails jetables par build ; faites tourner les comptes de test

Combiner avec : filesystem

Générer les captures App Store sur 5 tailles d'appareils

👤 Devs indépendants soumettant à l'App Store ⏱ ~25 min intermediate

Quand l'utiliser : Vous avez besoin de captures 6,5", 6,7", 5,5" et ne voulez pas le faire manuellement.

Prérequis

Simulateurs pour chaque taille requise — Créez-les via xcrun simctl avec les types d'appareils appropriés

Déroulement

Préparer la matrice

Démarre les simulateurs iPhone 15 Pro Max, iPhone 15, iPhone SE. Installe mon app sur chacun.✓ Copié

→ Les trois appareils prêts avec l'app installée
Capturer le flux

Sur chaque appareil, navigue jusqu'aux 5 écrans clés (onboarding, feed, detail, settings, upgrade). Capture chacun en pleine résolution.✓ Copié

→ Captures sauvegardées par appareil avec convention de nommage

Résultat : Captures prêtes pour l'App Store dans toutes les tailles requises, en une seule passe.

Pièges

Les captures incluent la barre d'état du simulateur — Utilisez --status-bar-style=overridden ou post-traitez avec crop

Combiner avec : filesystem

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

mobile-mcp + filesystem

Sauvegarder les captures dans des dossiers QA versionnés

Sauvegarde chaque capture sous /qa/$(date)/ avec le nom du test.✓ Copié

mobile-mcp + xcodebuild

Build, installation et test dans un seul flux

Compile l'app iOS via xcodebuild, installe-la via mobile-mcp, lance le smoke test.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
list_devices	none	Toujours en premier — savoir ce qui est disponible	free
launch_app	device_id, bundle_id	Ouvrir votre app sur l'appareil	free
tap	device_id, selector\|coords	Interagir avec un bouton ou contrôle	free
type_text	device_id, text: str	Remplir un champ texte (doit être focalisé d'abord)	free
get_view_hierarchy	device_id	Identifier ce qui est affiché à l'écran	free
screenshot	device_id, path?: str	Vérification visuelle	free

Coût et limites

Coût d'exécution

Quota d'API: Local
Tokens par appel: La hiérarchie de vues peut dépasser 10k tokens ; les captures sont en base64
Monétaire: Gratuit
Astuce: Préférez les tapotements par sélecteur aux dumps complets de hiérarchie pour économiser des tokens

Sécurité

Permissions, secrets, portée

Portées minimales : device access (physical USB requires trust dialog)

Stockage des identifiants : Aucun

Sortie de données : Aucune du MCP ; les captures transitent vers le fournisseur LLM si partagées

Ne jamais accorder : production device access with PII

Ne testez pas sur des appareils contenant des données de production — utilisez des comptes QA dédiés

Dépannage

Erreurs courantes et correctifs

Aucun appareil listé

Démarrez d'abord un simulateur : xcrun simctl boot / emulator -avd X

Vérifier : `xcrun simctl list | grep Booted`

tap_at_coords rate la cible

Exécutez get_view_hierarchy et utilisez le tap par sélecteur — les coordonnées varient selon la taille d'écran

Appareil réel non approuvé

Sur iOS : Réglages → Général → Gestion des appareils → faire confiance. Sur Android : activez le débogage USB.

Alternatives

Mobile MCP vs autres

Alternative	Quand l'utiliser	Compromis
XcodeBuildMCP	Vous avez besoin d'un build + test iOS uniquement, pas d'automatisation UI multi-plateforme	Pas d'Android ; plus axé sur les outils de build
Appium	Vous voulez un framework de tests mobiles complet pour la CI	Configuration bien plus lourde ; pas natif MCP

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills