XcodeBuild MCP

Um servidor que fornece ferramentas para gerenciamento de projetos Xcode, gerenciamento de simuladores e utilitários de aplicativos.

GitHub
6.5k
Experimente este MCPPatrocinado

Documentação

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

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

Instalação

O MobileBuildMCP é 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 mobilebuildmcp

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

npm install -g mobilebuildmcp@latest

Verifique qualquer instalação:

mobilebuildmcp --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 Clientes MCP. A maioria dos clientes também pode executar o servidor MCP sob demanda via npx -y mobilebuildmcp@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)

Habilidades

O MobileBuildMCP agora inclui duas habilidades opcionais para agentes:

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

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

Para instalar com um binário global:

mobilebuildmcp init

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

npx -y mobilebuildmcp@latest init

Para mais informações sobre a instalação de habilidades, consulte Habilidades do Agente.

Notas

  • O MobileBuildMCP 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 Assinatura de Código do Dispositivo.

Privacidade

O MobileBuildMCP usa Sentry apenas para telemetria interna de erros em tempo de execução. Para detalhes e instruções de exclusão, consulte Privacidade e Telemetria.

CLI

O MobileBuildMCP 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 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"

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

mobilebuildmcp upgrade --check
mobilebuildmcp 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

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.