XcodeBuild

Автоматизируйте проекты Xcode с помощью ИИ, используя XcodeBuild MCP. Собирайте, тестируйте и развёртывайте iOS/macOS-приложения через Model Context Protocol. Оптимизируйте разработку с помощью AI-агентов. Начните сегодня!

Мобильная разработка Инструменты разработчика Прочее ★ 46 GitHub (46 ★)

XcodeBuild упрощает взаимодействие между AI-агентами и проектами Xcode, предоставляя специальные инструменты для типовых операций Xcode через протокол MCP (Model Context Protocol). Это устраняет необходимость в ручном вводе команд в терминале, обеспечивая надёжный и эффективный процесс разработки. Инструмент позволяет агентам самостоятельно проверять изменения кода путём сборки проектов, анализа ошибок и автономных итераций, эффективно автоматизируя рабочие процессы разработки.

Ключевые особенности

01Операция clean для очистки результатов сборки.

0246 звёзд на GitHub

03Операции сборки для macOS, iOS Simulator и iOS устройств.

A Model Context Protocol (MCP) server that provides Xcode-related tools for integration with AI assistants and other MCP clients.

Overview

This project implements an MCP server that exposes Xcode operations as tools that can be invoked by AI agents via the MCP protocol. It enables programmatic interaction with Xcode projects through a standardised interface, optimised for agent-driven development workflows.

Demo2.mp4

Demo showing Claude Code building and launching a macOS app.

Why?

The XcodeBuild MCP tool exists primarily to streamline and standardise interaction between AI agents and Xcode projects. By providing dedicated tools for common Xcode operations, it removes reliance on manual or potentially incorrect command-line invocations.

This ensures a reliable and efficient development process, allowing agents to seamlessly leverage Xcode's capabilities while reducing the risk of configuration errors.

Critically, this MCP enables AI agents to independently validate code changes by building projects, inspecting errors, and iterating autonomously. In contrast to user-driven tools like Sweetpad, XcodeBuild MCP empowers agents to automate these workflows effectively.

Features

The XcodeBuildMCP server provides the following tool capabilities:

Xcode project management

Build Operations: Platform-specific build tools for macOS, iOS simulator, and iOS device targets
Project Information: Tools to list schemes and show build settings for Xcode projects and workspaces
Clean Operations: Clean build products using xcodebuild's native clean action

Simulator management

Simulator Control: List, boot, and open iOS simulators
App Deployment: Install and launch apps on iOS simulators

App utilities

Bundle ID Extraction: Extract bundle identifiers from iOS and macOS app bundles
App Launching: Launch built applications on both simulators and macOS

Getting started

Prerequisites

Node.js (v16 or later)
npm
Xcode command-line tools

Installation

Clone the repository
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```
Optionally start the server:
```
node build/index.js
```

Note

You don't need to run the server manually as MCP clients will do this for you.

Adding to Windsurf/Cursor/Clude Desktop etc.

Create a new custom server configuration and add the following; changing the path to the actual path you cloned the repo to.

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "node",
      "args": [
        "/path_to/XcodeBuildMCP/build/index.js"
      ]
    }
  }
}

Debugging

You can use MCP Inspector via:

npx @modelcontextprotocol/inspector node build/index.js

Demos

Building and running iOS app in Cursor

Demo1.mp4

Building and running iOS app in Claude Code

Demo3.mp4

Licence

This project is licensed under the MIT License - see the LICENSE file for details.

XcodeBuild MCP Server

XcodeBuild — это MCP-сервер, который предоставляет набор инструментов для взаимодействия с Xcode через протокол MCP (Model Context Protocol). Он предназначен для интеграции с AI-ассистентами и позволяет автоматизировать сборку, запуск и управление Xcode-проектами.

Зачем это нужно?

Основная цель XcodeBuild — стандартизировать и упростить взаимодействие AI-агентов с Xcode. Вместо ручного ввода команд или использования сторонних инструментов, этот MCP-сервер предоставляет надёжные и предсказуемые инструменты для типовых операций. Это особенно полезно для автономной валидации кода: AI-агент может собрать проект, увидеть ошибки и исправить их без участия человека.

Возможности

Управление Xcode-проектом

Сборка под macOS, iOS Simulator и iOS Device
Информация о проекте: список схем (schemes) и настройки сборки (build settings)
Очистка продуктов сборки (clean)

Управление симуляторами

Список, запуск и открытие iOS-симуляторов
Установка и запуск приложений на симуляторе

Утилиты для приложений

Извлечение Bundle ID из .app-пакетов
Запуск собранных приложений на симуляторе или macOS

Установка

Требования

Node.js v16 или новее
npm
Xcode Command Line Tools

Шаги

Клонируйте репозиторий:

git clone <repository-url>
cd XcodeBuildMCP

Установите зависимости:
```
npm install
```
Соберите проект:
```
npm run build
```

Запускать сервер вручную не нужно — MCP-клиент сделает это автоматически при обращении.

Настройка клиентов (Windsurf / Cursor / Claude Desktop)

Добавьте конфигурацию MCP-сервера, указав путь к собранному файлу build/index.js:

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "node",
      "args": [
        "/полный/путь/к/XcodeBuildMCP/build/index.js"
      ]
    }
  }
}

Замените /полный/путь/к/ на реальный путь к репозиторию.

Отладка

Для проверки работы сервера используйте MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

Демонстрация

В репозитории доступны видео-демо:

Сборка и запуск iOS-приложения в Cursor (Demo1.mp4)
Сборка и запуск macOS-приложения в Claude Code (Demo2.mp4)
Сборка и запуск iOS-приложения в Claude Code (Demo3.mp4)

Лицензия

Проект распространяется под лицензией MIT. Подробности — в файле LICENSE.

Build Device

Builds an app for a connected device.

Parameters

Clean

Cleans build products with xcodebuild.

Parameters

Discover Projs

Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files.

Parameters

Get App Bundle Id

Extracts the bundle identifier from an app bundle (.app) for any Apple platform (iOS, iPadOS, watchOS, tvOS, visionOS). IMPORTANT: You MUST provide the appPath parameter. Example: get_app_bundle_id({ ...

Parameters

Get Device App Path

Retrieves the built app path for a connected device.

Parameters

Install App Device

Installs an app on a connected device.

Parameters

Launch App Device

Launches an app on a connected device.

Parameters

List Devices

Lists connected physical Apple devices (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro) with their UUIDs, names, and connection status. Use this to discover physical devices for testing.

List Schemes

Lists schemes for a project or workspace.

Show Build Settings

Shows xcodebuild build settings.

Start Device Log Cap

Starts log capture on a connected device.

Parameters

Stop App Device

Stops a running app on a connected device.

Parameters

Stop Device Log Cap

Stops an active Apple device log capture session and returns the captured logs.

Parameters

Test Device

Runs tests on a physical Apple device.

Parameters

Doctor

Provides comprehensive information about the MCP server environment, available dependencies, and configuration status.

Parameters

Start Sim Log Cap

Starts capturing logs from a specified simulator. Returns a session ID. By default, captures only structured logs.

Parameters

Stop Sim Log Cap

Stops an active simulator log capture session and returns the captured logs.

Parameters

Build Macos

Builds a macOS app.

Parameters

Build Run Macos

Builds and runs a macOS app.

Parameters

Get Mac App Path

Retrieves the built macOS app bundle path.

Parameters

Get Mac Bundle Id

Extracts the bundle identifier from a macOS app bundle (.app). IMPORTANT: You MUST provide the appPath parameter. Example: get_mac_bundle_id({ appPath: '/path/to/your/app.app' }) Note: In some environ...

Parameters

Launch Mac App

Launches a macOS application. IMPORTANT: You MUST provide the appPath parameter. Example: launch_mac_app({ appPath: '/path/to/your/app.app' }) Note: In some environments, this tool may be prefixed as ...

Parameters

Stop Mac App

Stops a running macOS application. Can stop by app name or process ID.

Parameters

Test Macos

Runs tests for a macOS target.

Parameters

Scaffold Ios Project

Scaffold a new iOS project from templates. Creates a modern Xcode project with workspace structure, SPM package for features, and proper iOS configuration.

Parameters

Scaffold Macos Project

Scaffold a new macOS project from templates. Creates a modern Xcode project with workspace structure, SPM package for features, and proper macOS configuration.

Parameters

Session Clear Defaults

Clear selected or all session defaults.

Parameters

allboolean

Optional

keysarray

Optional

Session Set Defaults

Set the session defaults needed by many tools. Most tools require one or more session defaults to be set before they can be used. Agents should set the relevant defaults at the beginning of a session.

Parameters

schemestring

Optional

deviceIdstring

Optional

projectPathstring

Optional

simulatorIdstring

Optional

Session Show Defaults

Show current session defaults.

Boot Sim

Boots an iOS simulator.

Build Run Sim

Builds and runs an app on an iOS simulator.

Parameters

Build Sim

Builds an app for an iOS simulator.

Parameters

Describe Ui

Gets entire view hierarchy with precise frame coordinates (x, y, width, height) for all visible elements. Use this before UI interactions or after layout changes - do NOT guess coordinates from screen...

Parameters

simulatorUuidstring

Required

Get Sim App Path

Retrieves the built app path for an iOS simulator.

Parameters

Install App Sim

Installs an app in an iOS simulator.

Parameters

Launch App Logs Sim

Launches an app in an iOS simulator and captures its logs.

Parameters

Launch App Sim

Launches an app in an iOS simulator.

Parameters

List Sims

Lists available iOS simulators with their UUIDs.

Parameters

Open Sim

Opens the iOS Simulator app.

Record Sim Video

Starts or stops video capture for an iOS simulator.

Parameters

Screenshot

Captures screenshot for visual verification. For UI coordinates, use describe_ui instead (don't determine coordinates from screenshots).

Parameters

simulatorUuidstring

Required

Stop App Sim

Stops an app running in an iOS simulator.

Parameters

Test Sim

Runs tests on an iOS simulator.

Parameters

Erase Sims

Erases simulator content and settings. Provide exactly one of: simulatorUdid or all=true. Optional: shutdownFirst to shut down before erasing.

Parameters

Reset Sim Location

Resets the simulator's location to default.

Parameters

Set Sim Appearance

Sets the appearance mode (dark/light) of an iOS simulator.

Parameters

Set Sim Location

Sets a custom GPS location for the simulator.

Parameters

Sim Statusbar

Sets the data network indicator in the iOS simulator status bar. Use "clear" to reset all overrides, or specify a network type (hide, wifi, 3g, 4g, lte, lte-a, lte+, 5g, 5g+, 5g-uwb, 5g-uc).

Parameters

Swift Package Build

Builds a Swift Package with swift build

Parameters

Swift Package Clean

Cleans Swift Package build artifacts and derived data

Parameters

Swift Package List

Lists currently running Swift Package processes

Swift Package Run

Runs an executable target from a Swift Package with swift run

Parameters

Swift Package Stop

Stops a running Swift Package executable started with swift_package_run

Parameters

Swift Package Test

Runs tests for a Swift Package with swift test

Parameters

Button

Press hardware button on iOS simulator. Supported buttons: apple-pay, home, lock, side-button, siri

Parameters

durationnumber

Optional

simulatorUuidstring

Required

Gesture

Perform gesture on iOS simulator using preset gestures: scroll-up, scroll-down, scroll-left, scroll-right, swipe-from-left-edge, swipe-from-right-edge, swipe-from-top-edge, swipe-from-bottom-edge

Parameters

Key Press

Press a single key by keycode on the simulator. Common keycodes: 40=Return, 42=Backspace, 43=Tab, 44=Space, 58-67=F1-F10.

Parameters

keyCodeinteger

Required

durationnumber

Optional

simulatorUuidstring

Required

Key Sequence

Press key sequence using HID keycodes on iOS simulator with configurable delay

Parameters

delaynumber

Optional

keyCodesarray

Required

simulatorUuidstring

Required

Long Press

Long press at specific coordinates for given duration (ms). Use describe_ui for precise coordinates (don't guess from screenshots).

Parameters

xinteger

Required

yinteger

Required

durationnumber

Required

simulatorUuidstring

Required

Swipe

Swipe from one point to another. Use describe_ui for precise coordinates (don't guess from screenshots). Supports configurable timing.

Parameters

x1integer

Required

x2integer

Required

y1integer

Required

y2integer

Required

deltanumber

Optional

Tap

Tap at specific coordinates. Use describe_ui to get precise element coordinates (don't guess from screenshots). Supports optional timing delays.

Parameters

xinteger

Required

yinteger

Required

preDelaynumber

Optional

postDelaynumber

Optional

simulatorUuidstring

Required

Touch

Perform touch down/up events at specific coordinates. Use describe_ui for precise coordinates (don't guess from screenshots).

Parameters

xinteger

Required

yinteger

Required

upboolean

Optional

downboolean

Optional

delaynumber

Optional

Type Text

Type text (supports US keyboard characters). Use describe_ui to find text field, tap to focus, then type.

Parameters

textstring

Required

simulatorUuidstring

Required

Источник: https://mcpmarket.com/server/xcodebuild-2

Ключевые особенности

Overview

Why?

Features

Xcode project management

Simulator management

App utilities

Getting started

Prerequisites

Installation

Adding to Windsurf/Cursor/Clude Desktop etc.

Debugging

Demos

Building and running iOS app in Cursor

Building and running iOS app in Claude Code

Licence

XcodeBuild MCP Server

Зачем это нужно?

Возможности

Управление Xcode-проектом

Управление симуляторами

Утилиты для приложений

Установка

Требования

Шаги

Настройка клиентов (Windsurf / Cursor / Claude Desktop)

Отладка

Демонстрация

Лицензия

Какие операции в Xcode может автоматизировать XcodeBuild MCP?

Что такое XcodeBuild MCP?

Как интегрировать XcodeBuild MCP с ИИ-инструментами, такими как Cursor или Claude?

Каковы преимущества использования XcodeBuild MCP?

Каковы предварительные требования для использования XcodeBuild MCP?

Build Device

Parameters

Clean

Parameters

Discover Projs

Parameters

Get App Bundle Id

Parameters

Get Device App Path

Parameters

Install App Device

Parameters

Launch App Device

Parameters

List Devices

List Schemes

Show Build Settings

Start Device Log Cap

Parameters

Stop App Device

Parameters

Stop Device Log Cap

Parameters

Test Device

Parameters

Doctor

Parameters

Start Sim Log Cap

Parameters

Stop Sim Log Cap

Parameters

Build Macos

Parameters

Build Run Macos

Parameters

Get Mac App Path

Parameters

Get Mac Bundle Id

Parameters

Launch Mac App

Parameters

Stop Mac App

Parameters

Test Macos

Parameters

Scaffold Ios Project