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.4k
Essayer ce MCPSponsorisé

Que pouvez-vous faire avec XcodeBuildMCP MCP ?

  • Build for simulator — Demandez à votre IA de compiler une application iOS ou macOS pour un simulateur spécifique en utilisant un schéma nommé et un chemin de projet.
  • Prepare test products — Faites générer par votre IA des bundles de test portables sans exécuter les tests, en ciblant un simulateur choisi.
  • Run prepared tests — Demandez à votre IA d’exécuter les produits de test précédemment construits sur un simulateur spécifié.
  • List available tools — Demandez à votre IA d’afficher l’ensemble des commandes CLI et des capacités du serveur MCP qu’elle peut invoquer.
  • Check for updates — Demandez à votre IA de vérifier la version installée et de mettre à niveau l’outil sur place si nécessaire.

Documentation

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.

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

Installation

MobileBuildMCP est fourni sous forme d'un paquet unique avec deux modes : une CLI pour une utilisation directe en terminal et un serveur MCP pour les agents de codage IA. Chaque méthode d'installation vous donne les deux.

Option A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

Option B — npm (Node.js 18+)

npm install -g mobilebuildmcp@latest

Vérifiez l'une ou l'autre installation :

mobilebuildmcp --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 mobilebuildmcp@latest mcp sans installation globale.

Exigences

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

Compétences

MobileBuildMCP inclut désormais deux compétences d'agent facultatives :

  • Compétence MCP : Prépare l'agent avec des instructions sur la façon d'utiliser les outils du serveur MCP (facultatif lors de l'utilisation du serveur MCP).

  • Compétence CLI : Prépare l'agent avec des instructions sur la façon de naviguer dans la CLI (recommandé lors de l'utilisation de la CLI).

Pour installer avec un binaire global :

mobilebuildmcp init

Ou installez directement via npx sans installation globale :

npx -y mobilebuildmcp@latest init

Pour plus d'informations sur l'installation des compétences, voir Compétences d'agent.

Remarques

  • MobileBuildMCP demande à xcodebuild de sauter la validation des macros pour éviter les erreurs lors de la compilation de projets utilisant Swift Macros.
  • Les outils pour appareils nécessitent une signature de code configurée dans Xcode. Voir Signature de code pour appareils.

Confidentialité

MobileBuildMCP 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ésinscription, voir Confidentialité et télémétrie.

CLI

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

# Install globally
npm install -g mobilebuildmcp@latest

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

# List available tools
mobilebuildmcp tools

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

# Prepare portable test products without running tests
mobilebuildmcp 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
mobilebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

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

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

La CLI utilise un démon par espace de travail pour les opérations avec état (capture de journaux, débogage, etc.) qui se démarre automatiquement si nécessaire. Voir 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 avis de licences tierces, voir le fichier THIRD_PARTY_LICENSES pour plus de détails. Pour les attributions de paquets npm, voir le fichier THIRD_PARTY_PACKAGE_LICENSES pour plus de détails.