XcodeBuildMCP

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

GitHub

6.2k

O que você pode fazer com Xcode Build MCP?

Crie um aplicativo para o simulador — peça ao agente para executar simulator build com um esquema e caminho do projeto para compilar seu projeto iOS ou macOS.
Execute testes em um simulador específico — use simulator test com um caminho de produtos de teste e nome do simulador para executar pacotes de teste previamente preparados.
Prepare produtos de teste sem executá-los — invoque simulator build com --build-for-testing e um --test-products-path para gerar pacotes portáteis .xctestproducts.
Inicie o servidor MCP para um cliente de IA — execute o subcomando mcp para que seu agente de codificação possa acessar todas as ferramentas de compilação e teste por meio do protocolo MCP.
Liste as ferramentas disponíveis na CLI — use o comando tools para descobrir quais operações estão disponíveis no ambiente atual.
Verifique e aplique atualizações — execute upgrade --check ou upgrade --yes para atualizar a CLI no local.

Documentação

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

Instalação

O XcodeBuildMCP é distribuído como um único pacote 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 uma das instalações:

xcodebuildmcp --help

Conecte seu cliente MCP

Trechos de configuração prontos para Cursor, Claude Code, Codex podem ser encontrados na página oficial de documentação 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 na 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 como instalar skills, consulte Agent Skills.

Notas

O XcodeBuildMCP solicita ao xcodebuild que pule 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 às ferramentas pelo 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"

Verifique atualizações e atualize 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 a 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 está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes. Para avisos de licenciamento de terceiros, veja o arquivo THIRD_PARTY_LICENSES para detalhes. Para atribuições de pacotes npm, veja o arquivo THIRD_PARTY_PACKAGE_LICENSES para detalhes.