getsentry/MobileBuildMCP

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

무엇인가요

MobileBuildMCP는 Model Context Protocol (MCP) 서버와 대응하는 명령줄 인터페이스 (CLI) 를 실행하는 작은 오픈소스 패키지입니다. 목적은 AI 코드 에이전트(예: Claude, Cursor, Codex)가 xcodebuild 구문을 정확히 알지 못해도 iOS/macOS 프로젝트의 Xcode 관련 빌드 및 테스트 명령을 호출할 수 있도록 하는 것입니다.

누가 사용할까

iOS/macOS 앱을 자동화 워크플로우의 일부로 빌드, 테스트, 패키징해야 하는 AI 기반 개발 보조 도구.
시뮬레이터 빌드, 테스트 제품 준비, 디바이스 서명 등의 일반적인 Xcode 빌드 작업을 단일 크로스플랫폼 진입점에서 편리하게 실행하고 싶은 개발자.
Xcode 위에 고수준 자동화를 구축하고 있는 도구 팀으로, 안정적이고 언어에 의존하지 않는 RPC 인터페이스(MCP 서버)를 필요로 하는 사람.

핵심 기능 (README에 설명됨)

기능	설명
MCP 서버	MCP 호환 AI 에이전트로부터 요청을 수신하고, 빌드, 테스트, 디바이스 서명 등 Xcode 관련 도구를 Model Context Protocol을 통해 노출합니다.
CLI	터미널에서 직접 동일한 도구를 제공합니다 (`mobilebuildmcp <하위 명령>`).
이중 설치 모드	Homebrew (`brew install mobilebuildmcp`) 또는 글로벌 npm 패키지 (`npm install -g mobilebuildmcp`)로 설치 가능합니다.
에이전트 스킬	AI 에이전트가 서버 또는 CLI를 사용하는 방법을 가르치기 위한 선택적 "MCP 스킬" 및 "CLI 스킬" JSON 블롭입니다.
시뮬레이터 워크플로우	특정 시뮬레이터를 위한 빌드, 테스트 번들을 실행하지 않고 생성, 나중에 선택한 시뮬레이터에서 실행하는 명령을 제공합니다.
디바이스 도구	Xcode에서 코드 서명이 설정되어 있다면 실제 디바이스용 빌드를 지원합니다.
업그레이드 헬퍼	`mobilebuildmcp upgrade --check` / `--yes`를 사용해 설치된 바이너리를 직접 업데이트할 수 있습니다.
테레메트리	런타임 오류 데이터를 Sentry에 전송합니다 (옵트아웃 가능).
문서	설치, 구성, 도구 참조, 문제 해결을 다루는 풍부한 마크다운 문서를 보조 리포지토리 (`getsentry/xcodebuildmcp.com`)에 호스팅합니다.

작동 방식 (개요)

설치 – 사용자가 패키지를 설치합니다 (Homebrew 또는 npm). 설치 시 mobilebuildmcp 바이너리와 MCP 서버 코드가 제공됩니다.
서버 시작 – mobilebuildmcp mcp를 실행하면 AI 에이전트로부터 JSON-RPC 형식의 요청을 수신하는 HTTP 유사 MCP 엔드포인트가 시작됩니다.
에이전트 상호작용 – AI 에이전트는 제공된 MCP 스킬 (또는 CLI 스킬)을 로드하여 사용 가능한 JSON 메서드(예: simulator.build, simulator.test)를 학습합니다. 에이전트는 요청을 보내고, 서버는 적절한 xcodebuild 명령어로 변환하여 실행하고, 로그를 캡처한 후 결과를 반환합니다.
CLI 백업 – 사용자가 수동 제어를 선호하는 경우, mobilebuildmcp simulator build …와 같은 하위 명령어를 직접 호출하여 동일한 작업을 수행할 수 있습니다.
상태 유지 데몬 – CLI는 각 워크스페이스별 백그라운드 데몬을 시작하여 로그와 상태를 캐시하고 반복 작업을 가속화합니다.

AI 지원 개발에서의 중요성

표준화된 인터페이스: MCP를 통해 Xcode 기능을 노출함으로써, 어떤 LLM 기반 코드 보조 도구도 각 도구마다 맞춤형 스크립트를 작성하지 않고도 iOS/macOS 프로젝트와 상호작용할 수 있습니다.
프롬프트 복잡성 감소: 스킬 파일은 에이전트에게 간결한 "API 사양"을 제공하여, 프롬프트가 저수준 빌드 플래그가 아닌 비즈니스 로직에 집중할 수 있게 합니다.
크로스플랫폼 진입점: 개발자는 로컬에서 동일한 명령어를 실행하거나 AI 에이전트가 원격에서 실행하도록 할 수 있어, 이미 AI 기반 코드 생성을 사용하는 CI/CD 파이프라인에 쉽게 통합할 수 있습니다.

시작하기 (빠른 단계)

# Homebrew (macOS에서 추천)
brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

# 또는 npm
npm install -g mobilebuildmcp@latest

# 확인
mobilebuildmcp --help

# AI 클라이언트용 MCP 서버 시작
mobilebuildmcp mcp

# 시뮬레이터용 CLI 빌드 예시
mobilebuildmcp simulator build \
  --scheme MyApp \
  --project-path ./MyApp.xcodeproj \
  --simulator-name "iPhone 17"

라이선스 및 커뮤니티

MIT 라이선스로 제공됩니다.
오류 테레메트리에 Sentry를 사용합니다 (옵트아웃 가능).
GitHub의 일반적인 풀 리퀘스트 워크플로우를 통해 기여를 환영합니다. 자세한 기여 가이드는 문서에 링크되어 있습니다.

위의 모든 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.