XcodeBuildMCP

iOS 및 macOS 프로젝트 작업 시 에이전트가 사용할 수 있는 도구를 제공하는 Model Context Protocol (MCP) 서버 및 CLI입니다.

GitHub

6.2k

Xcode Build MCP(으)로 무엇을 할 수 있나요?

시뮬레이터용 앱 빌드 — 에이전트에게 simulator build를 스킴과 프로젝트 경로와 함께 실행하도록 요청하여 iOS 또는 macOS 프로젝트를 컴파일합니다.
특정 시뮬레이터에서 테스트 실행 — simulator test를 테스트 제품 경로와 시뮬레이터 이름과 함께 사용하여 미리 준비된 테스트 번들을 실행합니다.
테스트 제품을 실행하지 않고 준비 — --build-for-testing 및 --test-products-path와 함께 simulator build를 호출하여 이식 가능한 .xctestproducts 번들을 생성합니다.
AI 클라이언트용 MCP 서버 시작 — mcp 하위 명령을 실행하여 코딩 에이전트가 MCP 프로토콜을 통해 모든 빌드 및 테스트 도구에 접근할 수 있도록 합니다.
CLI에서 사용 가능한 도구 나열 — tools 명령을 사용하여 현재 환경에서 사용 가능한 작업을 확인합니다.
업데이트 확인 및 적용 — upgrade --check 또는 upgrade --yes를 실행하여 CLI를 제자리에서 업데이트합니다.

문서

iOS 및 macOS 프로젝트 작업 시 에이전트가 사용할 수 있는 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 및 CLI입니다.

설치

XcodeBuildMCP는 CLI(직접 터미널 사용)와 MCP 서버(AI 코딩 에이전트용)의 두 가지 모드를 갖춘 단일 패키지로 제공됩니다. 어떤 방법으로 설치해도 두 가지 모두 사용할 수 있습니다.

옵션 A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

옵션 B — npm (Node.js 18 이상)

npm install -g xcodebuildmcp@latest

설치 확인:

xcodebuildmcp --help

MCP 클라이언트 연결

Cursor, Claude Code, Codex를 위한 바로 사용 가능한 설정 스니펫은 공식 문서 페이지 MCP Clients에서 확인할 수 있습니다. 대부분의 클라이언트는 전역 설치 없이 npx -y xcodebuildmcp@latest mcp를 통해 필요 시 MCP 서버를 실행할 수도 있습니다.

요구 사항

macOS 14.5 이상
Xcode 16.x 이상
Node.js 18.x 이상 (Homebrew 설치 시에는 불필요)

스킬

XcodeBuildMCP에는 이제 두 가지 선택적 에이전트 스킬이 포함됩니다.

MCP 스킬: MCP 서버 도구 사용 방법에 대한 지침을 에이전트에 제공합니다 (MCP 서버 사용 시 선택 사항).
CLI 스킬: CLI 탐색 방법에 대한 지침을 에이전트에 제공합니다 (CLI 사용 시 권장).

전역 바이너리로 설치하려면:

xcodebuildmcp init

또는 전역 설치 없이 npx를 통해 직접 설치하려면:

npx -y xcodebuildmcp@latest init

스킬 설치에 대한 자세한 내용은 Agent Skills를 참조하세요.

참고 사항

XcodeBuildMCP는 Swift 매크로를 사용하는 프로젝트 빌드 시 오류를 방지하기 위해 xcodebuild에 매크로 검증을 건너뛰도록 요청합니다.
기기 도구를 사용하려면 Xcode에서 코드 서명이 구성되어 있어야 합니다. Device Code Signing을 참조하세요.

개인정보 보호

XcodeBuildMCP는 내부 런타임 오류 원격 측정에만 Sentry를 사용합니다. 자세한 내용 및 비활성화 방법은 Privacy & Telemetry를 참조하세요.

CLI

XcodeBuildMCP는 통합된 명령줄 인터페이스를 제공합니다. mcp 하위 명령은 MCP 서버를 시작하고, 다른 모든 명령은 도구에 대한 직접 터미널 접근을 제공합니다.

# 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"

업데이트 확인 및 현재 위치에서 업그레이드:

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

CLI는 상태 저장 작업(로그 캡처, 디버깅 등)을 위해 작업 공간별 데몬을 사용하며 필요 시 자동으로 시작됩니다. 전체 문서는 CLI guide를 참조하세요.

문서

설치: https://xcodebuildmcp.com/docs/installation
설정: https://xcodebuildmcp.com/docs/setup
MCP 클라이언트: https://xcodebuildmcp.com/docs/clients
CLI 사용법: https://xcodebuildmcp.com/docs/cli
구성 및 옵션: https://xcodebuildmcp.com/docs/configuration
도구 참조: https://xcodebuildmcp.com/docs/tools
문제 해결: https://xcodebuildmcp.com/docs/troubleshooting
개인정보 보호: https://xcodebuildmcp.com/docs/privacy
스킬: https://xcodebuildmcp.com/docs/skills
기여: https://xcodebuildmcp.com/docs/contributing

라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요. 타사 라이선스 고지 사항은 THIRD_PARTY_LICENSES 파일을 참조하세요. npm 패키지 저작자 표시는 THIRD_PARTY_PACKAGE_LICENSES 파일을 참조하세요.