XcodeBuildMCP

Un serveur Model Context Protocol (MCP) et CLI qui fournit des outils pour une utilisation par des agents lors du travail sur des projets iOS et macOS.

GitHub
6.2k

Que pouvez-vous faire avec XcodeBuildMCP MCP ?

  • Créer une application pour le simulateur — demandez à l'agent d'exécuter simulator build avec un schéma et un chemin de projet pour compiler votre projet iOS ou macOS.
  • Exécuter des tests sur un simulateur spécifique — utilisez simulator test avec un chemin de produits de test et un nom de simulateur pour exécuter des bundles de tests préparés précédemment.
  • Préparer des produits de test sans les exécuter — invoquez simulator build avec --build-for-testing et --test-products-path pour générer des bundles .xctestproducts portables.
  • Démarrer le serveur MCP pour un client IA — exécutez la sous-commande mcp afin que votre agent de codage puisse accéder à tous les outils de construction et de test via le protocole MCP.
  • Lister les outils disponibles depuis la CLI — utilisez la commande tools pour découvrir quelles opérations sont disponibles dans l'environnement actuel.
  • Vérifier et appliquer les mises à jour — exécutez upgrade --check ou upgrade --yes pour mettre à jour la CLI sur place.

Documentation

XcodeBuild MCP

Un serveur et une CLI Model Context Protocol (MCP) qui fournit des outils destinés aux agents travaillant sur des projets iOS et macOS.

CI npm version License: MIT Node.js Xcode 16 macOS MCP Ask DeepWiki AgentAudit Security pkg.pr.new

Installation

XcodeBuildMCP est livré sous forme d’un package unique avec deux modes : une CLI pour une utilisation directe dans le terminal et un serveur MCP pour les agents de codage IA. Chaque méthode d’installation vous donne accès aux deux.

Option A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Option B — npm (Node.js 18+)

npm install -g xcodebuildmcp@latest

Vérifiez l’installation :

xcodebuildmcp --help

Connectez votre client MCP

Des extraits de configuration prêts à l’emploi pour Cursor, Claude Code, Codex sont disponibles sur la page de documentation officielle Clients MCP. La plupart des clients peuvent également exécuter le serveur MCP à la demande via npx -y xcodebuildmcp@latest mcp sans installation globale.

Prérequis

  • macOS 14.5 ou ultérieur
  • Xcode 16.x ou ultérieur
  • Node.js 18.x ou ultérieur (non requis pour l’installation via Homebrew)

Compétences

XcodeBuildMCP inclut désormais deux compétences d’agent optionnelles :

  • Compétence MCP : Prépare l’agent avec des instructions sur l’utilisation des outils du serveur MCP (optionnelle lors de l’utilisation du serveur MCP).

  • Compétence CLI : Prépare l’agent avec des instructions sur la navigation dans la CLI (recommandée lors de l’utilisation de la CLI).

Pour installer avec un binaire global :

xcodebuildmcp init

Ou installez directement via npx sans installation globale :

npx -y xcodebuildmcp@latest init

Pour plus d’informations sur l’installation des compétences, consultez Compétences d’agent.

Remarques

  • XcodeBuildMCP demande à xcodebuild d’ignorer la validation des macros pour éviter les erreurs lors de la construction de projets utilisant des macros Swift.
  • Les outils pour appareils nécessitent que la signature de code soit configurée dans Xcode. Voir Signature de code pour appareils.

Confidentialité

XcodeBuildMCP utilise Sentry uniquement pour la télémétrie des erreurs d’exécution internes. Pour plus de détails et les instructions de désactivation, consultez Confidentialité et télémétrie.

CLI

XcodeBuildMCP fournit une interface en ligne de commande unifiée. La sous-commande mcp démarre le serveur MCP, tandis que toutes les autres commandes offrent un accès direct aux outils depuis le terminal :

# Install globally
npm install -g xcodebuildmcp@latest

# Start the MCP server (for MCP clients)
xcodebuildmcp mcp

# List available tools
xcodebuildmcp tools

# Build for simulator
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj

# Prepare portable test products without running tests
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts

# Run previously prepared test products
xcodebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

Vérifiez les mises à jour et mettez à niveau sur place :

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

La CLI utilise un démon par espace de travail pour les opérations avec état (capture de logs, débogage, etc.) qui démarre automatiquement lorsque nécessaire. Consultez le guide de la CLI pour la documentation complète.

Documentation

Licence

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails. Pour les mentions de licences tierces, voir le fichier THIRD_PARTY_LICENSES. Pour les attributions des packages npm, voir le fichier THIRD_PARTY_PACKAGE_LICENSES.