MCP server XcodeBuildMCP

Q: Como adiciono o MCP XcodeBuildMCP ao Claude Code?

Execute `claude mcp add xcodebuildmcp -- npx -y xcodebuildmcp` no seu terminal. Adicione `--scope user` para torná-lo disponível em todos os projetos.

Q: Como adiciono o MCP XcodeBuildMCP ao Cursor?

Abra `~/.cursor/mcp.json` e adicione o servidor em `mcpServers`, usando a configuração do Cursor mostrada na seção de instalação acima.

✓ Oficial ✓ VerificadoCommit 13 de nov. de 2026

getsentry/xcodebuildmcp · typescript · MIT

Permite que um cliente de IA construa, teste e gerencie projetos Xcode e simuladores iOS via linha de comando ou ferramentas MCP.

Também conhecido como getsentry/XcodeBuildMCP, @mseep/xcodebuildmcp

stdio Developer Tools DevOps & Infrastructure Workflow Automation

Instalar GitHub ↗

Stars: 6.575
Ferramentas: —
Downloads, 30 dias: —
Versão mais recente: 2.7.0
Último commit: 13 de nov. de 2026
Licença: MIT

O que é o MCP XcodeBuildMCP?

XcodeBuildMCP é um MCP server. Permite que um cliente de IA construa, teste e gerencie projetos Xcode e simuladores iOS via linha de comando ou ferramentas MCP.

Resumo gerado a partir do README do projeto

Sobre o MCP server de XcodeBuildMCP

O XcodeBuildMCP permite gerenciar tarefas de desenvolvimento iOS e macOS a partir de um agente de codificação de IA. Ele fornece uma ponte entre clientes de IA e a linha de comando, permitindo que agentes construam, testem e gerenciem projetos Xcode e simuladores iOS diretamente. Desenvolvedores podem utilizá-lo como um MCP server dedicado para agentes ou como uma CLI independente para operações manuais no terminal.

Para usar esta ferramenta, você precisa de macOS 14.5 ou posterior, Xcode 16.x ou posterior e Node.js 18.x se estiver instalando via npm. Ele pode ser instalado via Homebrew ou npm e suporta integração com clientes como Claude Code, Cursor e Codex. O servidor inclui uma lógica específica para pular a validação de macros durante o build para evitar erros ao trabalhar com Swift Macros. Para tarefas específicas de hardware, os usuários devem garantir que o code signing esteja configurado no Xcode para ferramentas de dispositivo.

O que você pode fazer com ele

1Build de projetos para simuladoresPeça ao seu agente de IA para compilar um scheme específico para um simulador de iPhone.
2Preparação de produtos de teste portáteisInstrua um agente a gerar produtos de teste sem executá-los imediatamente.
3Execução de testes automatizadosFaça um cliente de IA executar produtos de teste previamente preparados em um simulador com nome específico.

Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.

Como instalar o MCP XcodeBuildMCP

Formatos verificados em 10 nov 2026Adicionar ao Cursor Adicionar ao Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add xcodebuildmcp -- npx -y xcodebuildmcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "xcodebuildmcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}

$ code --add-mcp '{"name":"xcodebuildmcp","type":"stdio","command":"npx","args":["-y","xcodebuildmcp"]}'

claude_desktop_config.json

{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}

$ codex mcp add xcodebuildmcp -- npx -y xcodebuildmcp

~/.codex/config.toml

[mcp_servers.xcodebuildmcp]
command = "npx"
args = ["-y", "xcodebuildmcp"]

$ gemini mcp add -s user xcodebuildmcp npx -- -y xcodebuildmcp

~/.gemini/settings.json

{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}

Defina 4 variáveis de ambiente antes de iniciar o servidor (abaixo).Guias de configuração:Claude Code Cursor VS Code Claude Desktop

Configuração

INCREMENTAL_BUILDS_ENABLED
Enable experimental xcodemake incremental builds (true/false or 1/0).
XCODEBUILDMCP_DEBUG
Enable verbose debug logging from the server.
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).

Nome	Descrição	Tipo
INCREMENTAL_BUILDS_ENABLED	Enable experimental xcodemake incremental builds (true/false or 1/0).
XCODEBUILDMCP_DEBUG	Enable verbose debug logging from the server.
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).

Verificações automatizadas

Executado em 11 de nov. de 2026Relatório completo →

100/100

Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam

Mostre esta pontuação no seu README

Repositório de origem vinculado e acessívelPassou
Licença de código aberto (OSI)Passou
Commit ou release no último anoPassou
Nome do pacote não é próximo a um pacote popularPassou
O endpoint remoto usa HTTPSNão verificado
Ferramentas destrutivas estão rotuladasNão verificado
Sem instruções ocultas para o modeloPassou
Nenhum aviso crítico no pacote ou em suas dependênciasPassou

README

Ver no GitHub

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

Installation: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
Setup: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/setup.mdx
MCP clients: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/clients.mdx
CLI usage: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
Configuration and options: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
Tools reference: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
Troubleshooting: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
Privacy: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
Skills: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
Contributing: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx

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.

Ler o README completo

Perguntas sobre o MCP XcodeBuildMCP

Como adiciono o MCP XcodeBuildMCP ao Claude Code?

Execute claude mcp add xcodebuildmcp -- npx -y xcodebuildmcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.

Como adiciono o MCP XcodeBuildMCP ao Cursor?

Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.

O que o XcodeBuildMCP faz?

Ele fornece ferramentas para uso por agentes ao trabalhar em projetos iOS e macOS, incluindo compilação para simuladores e execução de produtos de teste preparados.

Como instalo o XcodeBuildMCP?

Instale via Homebrew com brew tap getsentry/xcodebuildmcp e brew install mobilebuildmcp, ou via npm com npm install -g mobilebuildmcp@latest.

Quais são os requisitos para o XcodeBuildMCP?

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

Posso executar o XcodeBuildMCP sem uma instalação global?

Sim, a maioria dos clientes MCP pode executar o servidor sob demanda via npx -y mobilebuildmcp@latest mcp.

MCP server XcodeBuildMCP

✓ Oficial ✓ VerificadoCommit 13 de nov. de 2026

getsentry/xcodebuildmcp · typescript · MIT

Permite que um cliente de IA construa, teste e gerencie projetos Xcode e simuladores iOS via linha de comando ou ferramentas MCP.

Também conhecido como getsentry/XcodeBuildMCP, @mseep/xcodebuildmcp

stdio Developer Tools DevOps & Infrastructure Workflow Automation

Instalar GitHub ↗

Stars: 6.575
Ferramentas: —
Downloads, 30 dias: —
Versão mais recente: 2.7.0
Último commit: 13 de nov. de 2026
Licença: MIT

O que é o MCP XcodeBuildMCP?

XcodeBuildMCP é um MCP server. Permite que um cliente de IA construa, teste e gerencie projetos Xcode e simuladores iOS via linha de comando ou ferramentas MCP.

Resumo gerado a partir do README do projeto

Sobre o MCP server de XcodeBuildMCP

O que você pode fazer com ele

1Build de projetos para simuladoresPeça ao seu agente de IA para compilar um scheme específico para um simulador de iPhone.
2Preparação de produtos de teste portáteisInstrua um agente a gerar produtos de teste sem executá-los imediatamente.
3Execução de testes automatizadosFaça um cliente de IA executar produtos de teste previamente preparados em um simulador com nome específico.

Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.

Como instalar o MCP XcodeBuildMCP

Formatos verificados em 10 nov 2026Adicionar ao Cursor Adicionar ao Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add xcodebuildmcp -- npx -y xcodebuildmcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "xcodebuildmcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}

$ code --add-mcp '{"name":"xcodebuildmcp","type":"stdio","command":"npx","args":["-y","xcodebuildmcp"]}'

claude_desktop_config.json

{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}

$ codex mcp add xcodebuildmcp -- npx -y xcodebuildmcp

~/.codex/config.toml

[mcp_servers.xcodebuildmcp]
command = "npx"
args = ["-y", "xcodebuildmcp"]

$ gemini mcp add -s user xcodebuildmcp npx -- -y xcodebuildmcp

~/.gemini/settings.json

{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}

Defina 4 variáveis de ambiente antes de iniciar o servidor (abaixo).Guias de configuração:Claude Code Cursor VS Code Claude Desktop

Configuração

INCREMENTAL_BUILDS_ENABLED
Enable experimental xcodemake incremental builds (true/false or 1/0).
XCODEBUILDMCP_DEBUG
Enable verbose debug logging from the server.
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).

Nome	Descrição	Tipo
INCREMENTAL_BUILDS_ENABLED	Enable experimental xcodemake incremental builds (true/false or 1/0).
XCODEBUILDMCP_DEBUG	Enable verbose debug logging from the server.
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).

Verificações automatizadas

Executado em 11 de nov. de 2026Relatório completo →

100/100

Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam

Mostre esta pontuação no seu README

Repositório de origem vinculado e acessívelPassou
Licença de código aberto (OSI)Passou
Commit ou release no último anoPassou
Nome do pacote não é próximo a um pacote popularPassou
O endpoint remoto usa HTTPSNão verificado
Ferramentas destrutivas estão rotuladasNão verificado
Sem instruções ocultas para o modeloPassou
Nenhum aviso crítico no pacote ou em suas dependênciasPassou

README

Ver no GitHub

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

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

Installation: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
Setup: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/setup.mdx
MCP clients: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/clients.mdx
CLI usage: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
Configuration and options: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
Tools reference: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
Troubleshooting: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
Privacy: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
Skills: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
Contributing: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx

Licence

Ler o README completo

Perguntas sobre o MCP XcodeBuildMCP

Como adiciono o MCP XcodeBuildMCP ao Claude Code?

Execute claude mcp add xcodebuildmcp -- npx -y xcodebuildmcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.

Como adiciono o MCP XcodeBuildMCP ao Cursor?

Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.

O que o XcodeBuildMCP faz?

Ele fornece ferramentas para uso por agentes ao trabalhar em projetos iOS e macOS, incluindo compilação para simuladores e execução de produtos de teste preparados.

Como instalo o XcodeBuildMCP?

Instale via Homebrew com brew tap getsentry/xcodebuildmcp e brew install mobilebuildmcp, ou via npm com npm install -g mobilebuildmcp@latest.

Quais são os requisitos para o XcodeBuildMCP?

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

Posso executar o XcodeBuildMCP sem uma instalação global?

Sim, a maioria dos clientes MCP pode executar o servidor sob demanda via npx -y mobilebuildmcp@latest mcp.

MCP server XcodeBuildMCP

O que é o MCP XcodeBuildMCP?

Sobre o MCP server de XcodeBuildMCP

O que você pode fazer com ele

Como instalar o MCP XcodeBuildMCP

Instalar o MCP XcodeBuildMCP no Claude Code

Instalar o MCP XcodeBuildMCP no Cursor

Instalar o MCP XcodeBuildMCP no VS Code

Instalar o MCP XcodeBuildMCP no VS Code CLI

Instalar o MCP XcodeBuildMCP no Claude Desktop

Instalar o MCP XcodeBuildMCP no Codex

Instalar o MCP XcodeBuildMCP no Codex config.toml

Instalar o MCP XcodeBuildMCP no Gemini CLI

Instalar o MCP XcodeBuildMCP no Gemini settings.json

Configuração

Verificações automatizadas

README

Installation

Option A — Homebrew

Option B — npm (Node.js 18+)

Connect your MCP client

Requirements

Skills

Notes

Privacy

CLI

Documentation

Licence

Perguntas sobre o MCP XcodeBuildMCP

MCP server XcodeBuildMCP

O que é o MCP XcodeBuildMCP?

Sobre o MCP server de XcodeBuildMCP

O que você pode fazer com ele

Como instalar o MCP XcodeBuildMCP

Instalar o MCP XcodeBuildMCP no Claude Code

Instalar o MCP XcodeBuildMCP no Cursor

Instalar o MCP XcodeBuildMCP no VS Code

Instalar o MCP XcodeBuildMCP no VS Code CLI

Instalar o MCP XcodeBuildMCP no Claude Desktop

Instalar o MCP XcodeBuildMCP no Codex

Instalar o MCP XcodeBuildMCP no Codex config.toml

Instalar o MCP XcodeBuildMCP no Gemini CLI

Instalar o MCP XcodeBuildMCP no Gemini settings.json

Configuração

Verificações automatizadas

README

Installation

Option A — Homebrew

Option B — npm (Node.js 18+)

Connect your MCP client

Requirements

Skills

Notes

Privacy

CLI

Documentation

Licence

Perguntas sobre o MCP XcodeBuildMCP