XcodeBuildMCP

XcodeBuildMCP — это MCP-сервер и CLI, который даёт AI-агентам и разработчикам возможность взаимодействовать с проектами iOS и macOS: сборка, запуск на симуляторе/устройстве, анализ логов и другие типичные для Xcode задачи.

Сервер предоставляется в виде единого пакета, работающего в двух режимах: CLI (прямые команды в терминале) и MCP-сервер (для подключения AI-агентов через протокол MCP).

Требования

• macOS 14.5 или новее
• Xcode 16.x или новее
• Node.js 18.x или новее (не требуется при установке через Homebrew)

Установка

Вариант A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

После установки доступна команда xcodebuildmcp:

xcodebuildmcp --help

Конфигурация для MCP-клиента:

"XcodeBuildMCP" : {
  "command" : "xcodebuildmcp",
  "args" : ["mcp"]
}

Обновление: brew update && brew upgrade xcodebuildmcp.

Вариант B — npm / npx (Node.js 18+)

Для использования CLI установите глобально:

npm install -g xcodebuildmcp@latest
xcodebuildmcp --help

Для запуска MCP-сервера без глобальной установки добавьте в конфиг клиента:

"XcodeBuildMCP" : {
  "command" : "npx",
  "args" : ["-y", "xcodebuildmcp@latest", "mcp"]
}

Чтобы зафиксировать конкретную версию, замените @latest на нужную (например, xcodebuildmcp@1.0.0).

Настройка для конкретных MCP-клиентов

Ниже приведены примеры конфигураций для популярных инструментов. Если вы использовали Homebrew, замените command на "xcodebuildmcp" и args на ["mcp"].

Cursor

Проектная конфигурация — создайте .cursor/mcp.json в корне проекта:

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "npx",
      "args": ["-y", "xcodebuildmcp@latest", "mcp"]
    }
  }
}

Глобальная конфигурация (~/.cursor/mcp.json):

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "/bin/zsh",
      "args": ["-lc", "cd \"${workspaceFolder}\" && exec npx -y xcodebuildmcp@latest mcp"]
    }
  }
}

Быстрая ссылка для установки: Cursor Install

Claude Code

claude mcp add XcodeBuildMCP -- npx -y xcodebuildmcp@latest mcp

Codex CLI

codex mcp add XcodeBuildMCP -- npx -y xcodebuildmcp@latest mcp

Альтернативно, добавьте в ~/.codex/config.toml:

[mcp_servers.XcodeBuildMCP]
command = "npx"
args = ["-y", "xcodebuildmcp@latest", "mcp"]

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "npx",
      "args": ["-y", "xcodebuildmcp@latest", "mcp"]
    }
  }
}

VS Code / VS Code Insiders

Добавьте в настройки VS Code (settings.json):

"mcp": {
  "servers": {
    "XcodeBuildMCP": {
      "command": "npx",
      "args": ["-y", "xcodebuildmcp@latest", "mcp"]
    }
  }
}

Windsurf

Добавьте в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "npx",
      "args": ["-y", "xcodebuildmcp@latest", "mcp"]
    }
  }
}

Trae

Добавьте в ~/Library/Application Support/Trae/User/mcp.json:

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "npx",
      "args": ["-y", "xcodebuildmcp@latest", "mcp"]
    }
  }
}

Xcode (Codex Agent)

Требуется Xcode 26.3 или новее. Codex Agent должен быть установлен и настроен в Xcode (Settings → Intelligence → Open AI).

Создайте файл .codex/config.toml в корне проекта:

[mcp_servers.XcodeBuildMCP]
args = [
  "-lc",
  "PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin; export NVM_DIR=\\