MCP(모델 컨텍스트 프로토콜) 서버로, AI 어시스턴트를 위한 포괄적인 Xcode 통합을 제공합니다. 이 서버는 AI 에이전트가 Xcode 프로젝트와 상호작용하고, iOS 시뮬레이터를 관리하며, 다양한 Xcode 관련 작업을 수행할 수 있도록 하며, 오류 처리 및 다양한 프로젝트 유형에 대한 지원이 강화됩니다.

특징

프로젝트 관리

• 활성 프로젝트 설정 및 상세 프로젝트 정보 확보
• 템플릿(iOS, macOS, watchOS, tvOS)에서 새로운 Xcode 프로젝트 생성
• 타겟 및 그룹 명세가 있는 Xcode 프로젝트에 파일 추가
• 관련 프로젝트를 찾기 위한 작업 공간 문서 구문 분석
• 프로젝트 및 작업 공간에서 이용 가능한 스킴 목록

파일 작업

• 다양한 인코딩을 지원하는 파일 읽기/쓰기
• base64 인코딩/디코딩을 이용한 바이너리 파일 처리
• 패턴과 정규 표현식을 사용하여 파일 내 텍스트 콘텐츠 검색
• 파일 존재 확인 및 파일 메타데이터 획득
• 디렉터리 구조 자동 생성

빌드 및 테스트

• 맞춤형 옵션을 가진 프로젝트 구축
• 상세한 고장 보고가 포함된 테스트 실행
• 코드 분석 가능한 문제
• 클린 빌드 디렉터리
• 배포를 위한 아카이브 프로젝트

코코아팟 통합

• 프로젝트에서 코코아팟 초기화

Xcode MCP Server

An MCP (Model Context Protocol) server providing comprehensive Xcode integration for AI assistants. This server enables AI agents to interact with Xcode projects, manage iOS simulators, and perform various Xcode-related tasks with enhanced error handling and support for multiple project types.

Features

Project Management

• Set active projects and get detailed project information
• Create new Xcode projects from templates (iOS, macOS, watchOS, tvOS)
• Add files to Xcode projects with target and group specification
• Parse workspace documents to find associated projects
• List available schemes in projects and workspaces

File Operations

• Read/write files with support for different encodings
• Handle binary files with base64 encoding/decoding
• Search for text content within files using patterns and regex
• Check file existence and get file metadata
• Create directory structures automatically

Build & Testing

• Build projects with customizable options
• Run tests with detailed failure reporting
• Analyze code for potential issues
• Clean build directories
• Archive projects for distribution

CocoaPods Integration

• Initialize CocoaPods in projects
• Install and update pods
• Add and remove pod dependencies
• Execute arbitrary pod commands

Swift Package Manager

• Initialize new Swift packages
• Add and remove package dependencies with various version requirements
• Update packages and resolve dependencies
• Generate documentation for Swift packages using DocC
• Run tests and build Swift packages

iOS Simulator Tools

• List available simulators with detailed information
• Boot and shut down simulators
• Install and launch apps on simulators
• Take screenshots and record videos
• Manage simulator settings and state

Xcode Utilities

• Execute Xcode commands via xcrun
• Compile asset catalogs
• Generate app icon sets from source images
• Trace app performance
• Export and validate archives for App Store submission
• Switch between different Xcode versions

Installation

Prerequisites

• macOS with Xcode 14.0 or higher installed
• Node.js 16 or higher
• npm or yarn
• Swift 5.5+ for Swift Package Manager features
• CocoaPods (optional, for CocoaPods integration)

Setup

Option 1: Automated Setup (Recommended)

Use the included setup script which automates the installation and configuration process:

# Make the script executable
chmod +x setup.sh

# Run the setup script
./setup.sh

What the Setup Script Does:

1. Environment Verification:

   • Checks that you’re running on macOS
   • Verifies Xcode is installed and accessible
   • Confirms Node.js (v16+) and npm are available
   • Checks for Ruby installation
   • Verifies CocoaPods installation (offers to install if missing)

2. Dependency Installation: