Xcode MCP 서버

“Xcode” MCP 서버는 무엇을 하나요?

Xcode MCP(Model Context Protocol) 서버는 AI 어시스턴트와 Xcode 개발 환경을 연결하기 위해 설계된 특화 도구입니다. Xcode와 관련된 광범위한 작업을 표준 프로토콜로 노출함으로써, AI 에이전트가 Xcode 프로젝트를 관리하고, 파일 작업을 자동화하며, iOS 시뮬레이터를 제어하고, 각종 프로젝트 의존성 및 빌드 도구와 상호작용할 수 있게 만듭니다. 이러한 깊은 통합으로 빌드, 테스트, 코드 분석, 의존성 관리(CocoaPods 및 Swift 패키지 매니저), 시뮬레이터 제어 등의 작업을 프로그래밍적으로 또는 지능형 어시스턴트를 통해 수행할 수 있습니다. 반복 업무 자동화, 코드 품질 향상, iOS/macOS 프로젝트 개발 가속화에 특히 유용하며, 강력한 Xcode 기능을 자연어 또는 AI 기반 인터페이스로 사용할 수 있도록 해줍니다.

프롬프트 목록

사용 가능한 저장소 파일 또는 문서에 프롬프트 템플릿이 언급되어 있지 않습니다.

리소스 목록

사용 가능한 저장소 파일 또는 문서에 명시적인(MCP 정의) 리소스가 나와 있지 않습니다.

도구 목록

• 프로젝트 관리 도구

  • 활성 프로젝트 선택 및 프로젝트 정보 조회
  • 템플릿(iOS, macOS 등)에서 새 Xcode 프로젝트 생성
  • 타겟/그룹 지정으로 파일 추가
  • 워크스페이스 문서 파싱 및 스킴 목록화

• 파일 작업

  • 파일 읽기/쓰기(인코딩 지원)
  • base64로 바이너리 파일 처리
  • 패턴/정규식으로 텍스트 검색
  • 파일 존재 여부 및 메타데이터 확인
  • 디렉터리 자동 생성

• 빌드 & 테스트

  • 커스텀 옵션으로 프로젝트 빌드
  • 테스트 실행 및 실패 리포트
  • 코드 이슈 분석
  • 빌드 디렉터리 정리
  • 배포용 프로젝트 아카이브

• CocoaPods 통합

  • Pod 초기화, 설치, 업데이트, 관리
  • Pod 의존성 추가/제거
  • 임의 Pod 명령 실행

• Swift 패키지 매니저

  • Swift 패키지 및 의존성 관리
  • 패키지 업데이트/해결
  • 문서 생성
  • 패키지 빌드 및 테스트

• iOS 시뮬레이터 도구

  • 시뮬레이터 목록, 부팅, 종료
  • 앱 설치 및 실행
  • 스크린샷/동영상 캡처
  • 시뮬레이터 설정 관리

• Xcode 유틸리티

  • xcrun으로 Xcode 명령 실행
  • 에셋 카탈로그 컴파일
  • 앱 아이콘 세트 생성
  • 앱 성능 추적
  • App Store용 아카이브 내보내기/검증
  • Xcode 버전 전환

MCP 서버 활용 사례

• 자동화된 프로젝트 설정
  AI 에이전트가 새 Xcode 프로젝트를 신속하게 생성하고 설정하며, CocoaPods 또는 Swift 패키지 매니저와 같은 의존성 관리자를 설정하고 디렉터리 구조를 준비할 수 있어 초기화 과정에서 수작업을 크게 줄일 수 있습니다.

• 지속적 통합 및 테스트
  iOS/macOS 프로젝트의 빌드, 테스트, 분석 워크플로우를 자동화할 수 있습니다. AI 기반 루틴으로 빌드 트리거, 테스트 실행, 실패/코드 이슈 리포트가 가능해 채팅 또는 스크립트 인터페이스에서 강력한 CI/CD 파이프라인을 구축할 수 있습니다.

• 시뮬레이터 관리 및 테스트
  iOS 시뮬레이터를 프로그래밍적으로 제어해 자동 UI 테스트, 앱 설치, 스크린샷/동영상 캡처 등을 수행하여 모바일 앱의 테스트 범위와 신뢰성을 높입니다.

• 의존성 관리
  CocoaPods 또는 Swift 패키지 매니저를 사용한 서드파티 라이브러리의 추가, 제거, 업데이트를 자동화하여 프로젝트를 최신 상태로 유지하고 호환성을 수월하게 관리할 수 있습니다.

• 에셋 및 빌드 유틸리티
  에셋 컴파일, 아이콘 생성, 빌드 산출물 관리(아카이브 및 App Store 제출용 내보내기 등)를 자동화하여 효율성을 높이고 수작업 오류를 줄일 수 있습니다.

설정 방법

Windsurf

1. macOS, Xcode(14.0 이상), Node.js(16 이상), npm이 설치되어 있는지 확인하세요.
2. xcode-mcp-server 저장소를 다운로드하거나 클론하세요.
3. 셋업 스크립트를 실행합니다:

   chmod +x setup.sh
   ./setup.sh
   

4. Windsurf 설정 파일을 편집하여 MCP 서버를 추가하세요:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. 설정을 저장하고 Windsurf를 재시작하세요. Xcode MCP 도구가 사용 가능한지 확인합니다.

Claude

1. 필수 구성요소(macOS, Xcode, Node.js, npm)를 설치하세요.
2. 저장소를 클론하고 위와 같이 셋업 스크립트를 실행하세요.
3. Claude의 MCP 설정 파일을 찾으세요.
4. Xcode MCP 서버를 추가합니다:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. 저장 후 Claude를 재시작하세요. 도구 목록에서 설정이 완료되었는지 확인합니다.

Cursor

1. 모든 의존성이 설치되어 있는지 확인하세요.
2. 저장소를 클론하고 셋업 스크립트를 실행하세요.
3. Cursor의 MCP 설정 파일을 여세요.
4. mcpServers 아래에 다음을 추가하세요:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. 저장 후 Cursor를 재시작하고 서버가 활성화되었는지 확인하세요.

Cline

1. 필수 구성요소를 준비하고 셋업 스크립트를 실행하세요.
2. Cline MCP 서버 설정 파일을 편집하세요.
3. Xcode MCP 서버 항목을 삽입합니다:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

4. 변경사항을 저장하고 Cline을 재시작하세요.
5. Cline 내에서 Xcode MCP 서버가 정상 동작하는지 확인하세요.

환경 변수로 API 키 보안 관리

• 민감한 데이터(API 키, 토큰)는 .env 파일에 저장하세요.
• .env 사용 예시:

  XCODE_MCP_API_KEY=your_api_key_here
  

• 설정에서 환경 변수를 참조하세요:

  {
    "mcpServers": {
      "xcode-mcp": {
        "command": "npx",
        "args": ["@xcode/mcp-server@latest"],
        "env": {
          "XCODE_MCP_API_KEY": "${XCODE_MCP_API_KEY}"
        },
        "inputs": {
          "projectBaseDir": "/Users/yourname/Projects"
        }
      }
    }
  }
  

플로우 내에서 MCP 사용 방법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 서버를 통합하려면, 플로우에 MCP 컴포넌트를 추가한 뒤 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭해 설정 패널을 엽니다. 시스템 MCP 구성 섹션에 아래와 같은 JSON 형식으로 MCP 서버 정보를 입력하세요:

{
  "xcode-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

구성이 완료되면, AI 에이전트가 해당 MCP의 모든 기능과 역량을 도구로 활용할 수 있습니다. “MCP-name"을 실제 MCP 서버 이름(예: “xcode-mcp”)으로, URL을 본인 MCP 서버 URL로 바꿔주세요.

요약

위 정보를 바탕으로 Xcode MCP 서버는 Xcode 자동화에 매우 강력한 기능을 제공하지만, 프롬프트 템플릿, 명시적 MCP 리소스, 샘플링/roots 기능에 대한 문서는 부족합니다. 프로젝트/빌드 도구와 명확한 설정 가이드는 장점입니다.

MCP 점수

전체적으로 이 MCP 서버의 평점은 10점 만점에 7점입니다.
광범위한 Xcode 통합 및 자동화 도구, 명확한 설정 문서, 확실한 라이선스가 장점입니다. 다만, 프롬프트 템플릿, 명시적 MCP 리소스, roots 및 샘플링 지원 등은 부족해 완전한 MCP 호환 및 고급 워크플로우에 아쉬움이 있습니다.