XcodeBuildMCP MCP Server

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
6k

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

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 de sauter la validation des macros afin d’éviter les erreurs lors de la construction de projets utilisant des macros Swift.
  • Les outils de périphérique nécessitent que la signature de code soit configurée dans Xcode. Voir Signature de code pour périphériques.

Confidentialité

XcodeBuildMCP utilise Sentry uniquement pour la télémétrie interne des erreurs d’exécution. 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

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 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.