XcodeBuild MCP

Um servidor Model Context Protocol (MCP) e CLI que fornece ferramentas para uso por agentes ao trabalhar em projetos iOS e macOS.

Instalação

O XcodeBuildMCP é distribuído como um pacote único com dois modos: uma CLI para uso direto no terminal e um servidor MCP para agentes de codificação com IA. Qualquer método de instalação fornece ambos.

Opção A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Opção B — npm (Node.js 18+)

npm install -g xcodebuildmcp@latest

Verifique qualquer instalação:

xcodebuildmcp --help

Conecte seu cliente MCP

Snippets de configuração prontos para Cursor, Claude Code, Codex podem ser encontrados na página de documentação oficial MCP Clients. A maioria dos clientes também pode executar o servidor MCP sob demanda via npx -y xcodebuildmcp@latest mcp sem uma instalação global.

Requisitos

• macOS 14.5 ou posterior
• Xcode 16.x ou posterior
• Node.js 18.x ou posterior (não necessário para instalação via Homebrew)

Skills

O XcodeBuildMCP agora inclui duas skills opcionais para agentes:

• MCP Skill: Prepara o agente com instruções sobre como usar as ferramentas do servidor MCP (opcional ao usar o servidor MCP).

• CLI Skill: Prepara o agente com instruções sobre como navegar pela CLI (recomendado ao usar a CLI).

Para instalar com um binário global:

xcodebuildmcp init

Ou instale diretamente via npx sem uma instalação global:

npx -y xcodebuildmcp@latest init

Para mais informações sobre a instalação de skills, consulte Agent Skills.

Notas

• O XcodeBuildMCP solicita que o xcodebuild ignore a validação de macros para evitar erros ao compilar projetos que usam Swift Macros.
• As ferramentas de dispositivo exigem que a assinatura de código esteja configurada no Xcode. Consulte Device Code Signing.

Privacidade

O XcodeBuildMCP usa o Sentry apenas para telemetria interna de erros em tempo de execução. Para detalhes e instruções de exclusão, consulte Privacy & Telemetry.

CLI

O XcodeBuildMCP fornece uma interface de linha de comando unificada. O subcomando mcp inicia o servidor MCP, enquanto todos os outros comandos fornecem acesso direto ao terminal para as ferramentas:

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

Verifique atualizações e faça upgrade no local:

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

A CLI usa um daemon por workspace para operações com estado (captura de logs, depuração, etc.) que inicia automaticamente quando necessário. Consulte o guia da CLI para documentação completa.

Documentação

• Instalação: https://xcodebuildmcp.com/docs/installation
• Configuração: https://xcodebuildmcp.com/docs/setup
• Clientes MCP: https://xcodebuildmcp.com/docs/clients
• Uso da CLI: https://xcodebuildmcp.com/docs/cli
• Configuração e opções: https://xcodebuildmcp.com/docs/configuration
• Referência de ferramentas: https://xcodebuildmcp.com/docs/tools
• Solução de problemas: https://xcodebuildmcp.com/docs/troubleshooting
• Privacidade: https://xcodebuildmcp.com/docs/privacy
• Skills: https://xcodebuildmcp.com/docs/skills
• Contribuição: https://xcodebuildmcp.com/docs/contributing

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes. Para avisos de licenciamento de terceiros, consulte o arquivo THIRD_PARTY_LICENSES para detalhes. Para atribuições de pacotes npm, consulte o arquivo THIRD_PARTY_PACKAGE_LICENSES para detalhes.