XcodeBuildMCP

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

GitHub

6.5k

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

Build for simulator — AI에게 명명된 스킴과 프로젝트 경로를 사용하여 특정 시뮬레이터용 iOS 또는 macOS 앱을 컴파일하도록 요청하세요.
Prepare test products — AI가 테스트를 실행하지 않고 선택한 시뮬레이터를 대상으로 휴대용 테스트 번들을 생성하도록 하세요.
Run prepared tests — AI에게 지정된 시뮬레이터에서 이전에 빌드된 테스트 제품을 실행하도록 지시하세요.
List available tools — AI에게 호출할 수 있는 전체 CLI 명령 및 MCP 서버 기능 세트를 표시하도록 요청하세요.
Check for updates — AI에게 설치된 버전을 확인하고 필요 시 도구를 제자리에서 업그레이드하도록 요청하세요.

문서

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

설치

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

옵션 A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

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

npm install -g mobilebuildmcp@latest

설치 확인:

mobilebuildmcp --help

MCP 클라이언트 연결

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

요구 사항

macOS 14.5 이상
Xcode 16.x 이상
Node.js 18.x 이상 (Homebrew 설치에는 필요하지 않음)

스킬

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

MCP 스킬: MCP 서버의 도구 사용 방법에 대한 지침으로 에이전트를 준비시킵니다 (MCP 서버 사용 시 선택 사항).
CLI 스킬: CLI 탐색 방법에 대한 지침으로 에이전트를 준비시킵니다 (CLI 사용 시 권장).

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

mobilebuildmcp init

또는 전역 설치 없이 npx로 직접 설치:

npx -y mobilebuildmcp@latest init

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

참고 사항

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

개인정보 보호

MobileBuildMCP는 내부 런타임 오류 원격 분석에만 Sentry를 사용합니다. 자세한 내용과 거부 방법은 Privacy & Telemetry를 참조하세요.

CLI

MobileBuildMCP는 통합 명령줄 인터페이스를 제공합니다. mcp 하위 명령은 MCP 서버를 시작하며, 다른 모든 명령은 도구에 대한 직접 터미널 액세스를 제공합니다:

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

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

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

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

문서

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

라이선스

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