XcodeBuildMCP

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

설치

XcodeBuildMCP는 두 가지 모드를 포함하는 단일 패키지로 제공됩니다: 직접 터미널에서 사용하는 CLI와 AI 코딩 에이전트를 위한 MCP 서버입니다. 어떤 설치 방법을 선택하든 두 가지 모두 사용할 수 있습니다.

옵션 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 서버를 실행할 수도 있습니다.

Related MCP server: MCP Xcode Server

요구 사항

• macOS 14.5 이상

• Xcode 16.x 이상

• Node.js 18.x 이상 (Homebrew 설치 시에는 필요하지 않음)

기술(Skills)

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

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

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

CLI는 필요할 때 자동으로 시작되는 상태 저장 작업(로그 캡처, 디버깅 등)을 위해 워크스페이스별 데몬을 사용합니다. 전체 문서는 CLI 가이드를 참조하세요.

문서

• 설치: 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

• 기술(Skills): https://xcodebuildmcp.com/docs/skills

• 기여: https://xcodebuildmcp.com/docs/contributing

라이선스

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