English Français العربية

com.xcodebuildmcp/XcodeBuildMCP

Registre officiel Productivité

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package xcodebuildmcp
Claude Code 
claude mcp add xcodebuildmcp -e 'INCREMENTAL_BUILDS_ENABLED=false' -e 'XCODEBUILDMCP_ENABLED_WORKFLOWS=<XCODEBUILDMCP_ENABLED_WORKFLOWS>' -e 'XCODEBUILDMCP_SENTRY_DISABLED=false' -e 'XCODEBUILDMCP_DEBUG=false' -- npx -y xcodebuildmcp@2.7.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "xcodebuildmcp": {
            "command": "npx",
            "args": [
                "-y",
                "xcodebuildmcp@2.7.0"
            ],
            "env": {
                "INCREMENTAL_BUILDS_ENABLED": "false",
                "XCODEBUILDMCP_ENABLED_WORKFLOWS": "<XCODEBUILDMCP_ENABLED_WORKFLOWS>",
                "XCODEBUILDMCP_SENTRY_DISABLED": "false",
                "XCODEBUILDMCP_DEBUG": "false"
            }
        }
    }
}

Variables d'environnement

  • INCREMENTAL_BUILDS_ENABLED Enable experimental xcodemake incremental builds (true/false or 1/0).
  • XCODEBUILDMCP_ENABLED_WORKFLOWS Comma-separated list of workflows to load at startup (e.g., 'simulator,device,project-discovery').
  • XCODEBUILDMCP_SENTRY_DISABLED Disable Sentry error reporting (preferred flag).
  • XCODEBUILDMCP_DEBUG Enable verbose debug logging from the server.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Installation
  2. Requirements
  3. Skills
  4. Notes
  5. Privacy
  6. CLI
  7. Documentation
  8. Licence

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

Installation

MobileBuildMCP ships as a single package with two modes: a CLI for direct terminal use and an MCP server for AI coding agents. Either install method gives you both.

Option A — Homebrew
brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp
Option B — npm (Node.js 18+)
npm install -g mobilebuildmcp@latest

Verify either install:

mobilebuildmcp --help
Connect your MCP client

Drop-in config snippets for Cursor, Claude Code, Codex, can be found in the official docs page MCP Clients. Most clients can also run the MCP server on demand via npx -y mobilebuildmcp@latest mcp without a global install.

Requirements

  • macOS 14.5 or later
  • Xcode 16.x or later
  • Node.js 18.x or later (not required for Homebrew installation)

Skills

MobileBuildMCP now includes two optional agent skills:

  • MCP Skill: Primes the agent with instructions on how to use the MCP server's tools (optional when using the MCP server).
  • CLI Skill: Primes the agent with instructions on how to navigate the CLI (recommended when using the CLI).

To install with a global binary:

mobilebuildmcp init

Or install directly via npx without a global install:

npx -y mobilebuildmcp@latest init

For further information on installing skills, see Agent Skills.

Notes

  • MobileBuildMCP requests xcodebuild to skip macro validation to avoid errors when building projects that use Swift Macros.
  • Device tools require code signing to be configured in Xcode. See Device Code Signing.

Privacy

MobileBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, see Privacy & Telemetry.

CLI

MobileBuildMCP provides a unified command-line interface. The mcp subcommand starts the MCP server, while all other commands provide direct terminal access to tools:

# 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"

Check for updates and upgrade in place:

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

The CLI uses a per-workspace daemon for stateful operations (log capture, debugging, etc.) that auto-starts when needed. See the CLI guide for full documentation.

Documentation

Licence

This project is licensed under the MIT License - see the LICENSE file for details. For third-party licensing notices see the THIRD_PARTY_LICENSES file for details. For npm package attributions see the THIRD_PARTY_PACKAGE_LICENSES file for details.

Questions fréquentes

Qu'est-ce que com.xcodebuildmcp/XcodeBuildMCP ?

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

Comment installer com.xcodebuildmcp/XcodeBuildMCP ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add xcodebuildmcp -e 'INCREMENTAL_BUILDS_ENABLED=false' -e 'XCODEBUILDMCP_ENABLED_WORKFLOWS=<XCODEBUILDMCP_ENABLED_WORKFLOWS>' -e 'XCODEBUILDMCP_SENTRY_DISABLED=false' -e 'XCODEBUILDMCP_DEBUG=false' -- npx -y xcodebuildmcp@2.7.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour com.xcodebuildmcp/XcodeBuildMCP ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

com.xcodebuildmcp/XcodeBuildMCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient com.xcodebuildmcp/XcodeBuildMCP ?

Il est publié par getsentry. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.