/plugin marketplace add conorluddy/xclaude-plugin

Claude Code를 위한 모듈형 iOS 개발 자동화

Claude와의 자연스러운 대화를 통해 iOS 앱을 빌드, 테스트 및 자동화하세요. Xcode, Simulator, IDB에 걸쳐 24개의 도구를 제공하는 8개의 워크플로우 전용 MCP (Model Context Protocol) 서버가 포함되어 있습니다.

필요한 기능만 활성화하세요. 각 MCP는 특정 워크플로우를 위해 맞춤 제작되어 컨텍스트 윈도우 (Context Window)를 가볍게 유지합니다. 또한, 당사의 도구는 Xcode 출력값(오류, 테스트 결과, 빌드 로그)을 지능적으로 캡슐화하여 Claude가 50줄 이상의 가공되지 않은 로그 대신 구조화된 JSON을 처리하도록 합니다. 이를 통해 토큰을 크게 절약하고 더 빠른 피드백 루프를 구현할 수 있습니다.

8개의 워크플로우 전용 MCP 서버 (각각 600~3500 토큰)
필요한 기능만 활성화 - 초소형부터 풀 기능까지
23개의 공유 도구 - Xcode, Simulator, IDB 전반에 걸쳐 제공
단일 진실 공급원 (Single source of truth) - 도구는 한 번만 정의되어 MCP에 의해 임포트됨

xc-build (~600 토큰) - 빌드 검증, 오류, 클린, 스킴(Schemes) 목록 확인
xc-launch (~400 토큰) - 시뮬레이터 앱 라이프사이클: 설치 및 실행
xc-interact (~900 토큰) - 순수 UI 상호작용, 빌드 제외

xc-ai-assist (~1400 토큰) - 빌드 + UI 자동화 + 스크린샷
xc-setup (~800 토큰) - 환경 구성 및 검증
xc-testing (~1200 토큰) - 테스트 실행 + UI 흐름
xc-meta (~700 토큰) - 프로젝트 유지 관리 및 정리

xc-all (~3500 토큰) - 복잡한 워크플로우를 위한 24개 도구 전체

xcode-workflows - 빌드 시스템 가이드 및 결과 분석
simulator-workflows - 디바이스 및 앱 라이프사이클 패턴
ui-automation-workflows - 접근성 우선 자동화
accessibility-testing - WCAG 준수 및 품질 점검
ios-testing-patterns - 테스트 실행 및 불안정한 테스트 (Flaky test) 탐지
crash-debugging - 크래시 로그 분석 및 심볼리케이션 (Symbolication)
performance-profiling - Instruments 통합
state-management - 캐시 및 구성 관리

/plugin marketplace add conorluddy/xclaude-plugin
/plugin install xclaude-plugin

/plugin marketplace add /path/to/xclaude-plugin
/plugin install xclaude-plugin

방금 설치하셨나요? 빠른 개발을 위해 xc-build와 xc-launch를 활성화하세요:

1. Claude 설정에서 "xc-build" 및 "xc-launch" MCP를 활성화합니다.
2. Claude에게 다음과 같이 요청합니다: "iPhone 15에서 MyApp을 빌드하고 실행해줘"
3. 완료! ✨

이것으로 끝입니다. xc-build + xc-launch 조합은 조합 가능한(composable) 개발 루프를 제공합니다: xc-build로 빌드하고, xc-launch로 설치 및 실행합니다. Claude가 이 2단계 워크플로우(workflow)를 오케스트레이션(orchestrate)합니다. 다른 워크플로우(테스트, 설정, UI 자동화)가 필요한 경우 아래의 적절한 MCP 선택하기를 참조하세요.

• macOS 13.0+ 또는 Linux
• Xcode 15.0+ (iOS 개발을 위한 macOS 전용)
• Node.js 18+
• 선택 사항: 고급 UI 자동화를 위한 IDB (Facebook iOS Development Bridge)

이전 버전에서 업그레이드하는 경우, 다음의 중대한 변경 사항(breaking changes)에 유의하세요:

변경 사항:

• 명확성을 위해 서버 이름이 xc-build-and-launch에서 xc-launch로 변경되었습니다.
• 제거됨: skip_build 플래그가 포함된 단일 도구(monolithic tool), 그리고 xcode_build, xcode_clean, xcode_list (xc-build로 이동됨)
• 현재 포함 내용: 오직 simulator_install_app 및 simulator_launch_app만 포함
• 철학: 개발 루프를 위해 xc-build + xc-launch를 함께 사용하십시오.
• 이유: 단일 도구인 xcode_build_and_launch는 빌드, 설치, 실행을 하나의 작업으로 결합했습니다. 새로운 아키텍처는 빌드 관련 작업(xc-build)과 시뮬레이터 생명주기(xc-launch)를 분리하여 다음과 같은 이점을 제공합니다:
  • 더 나은 오류 복구 (개별 단계 재시도 가능)
  • 더 명확한 멘탈 모델 (build → install → launch)
  • skip_build라는 코드 스멜(code smell) 제거 - 단일 책임 원칙(Single Responsibility Principle) 준수

필요한 조치:

• .mcp.json 설정을 업데이트하세요:
  • "xc-build-and-launch": { - "command": "node", - "args": ["${CLAUDE_PLUGIN_ROOT}/mcp-servers/xc-build-and-launch/dist/index.js"]
  • "xc-launch": { + "command": "node", + "args": ["${CLAUDE_PLUGIN_ROOT}/mcp-servers/xc-launch/dist/index.js"]
• Claude 설정에서 "xc-build-and-launch" 대신 "xc-launch"를 활성화하세요.

이전 버전:

v0.3.0

:xc-run

→xc-build-and-launch

v0.3.0

:xc-compile

→xc-build

,xc-hybrid

→xc-all

현재 설정은 .mcp.json.example을 참조하세요.

중요: 최적의 토큰 효율성을 위해 한 번에 하나의 MCP만 활성화하세요. 현재 워크플로(workflow)에 따라 선택하세요:

☐ xc-build # 빌드 검증, 에러 확인, 클린(clean)? (~600 tokens)
☐ xc-launch # 시뮬레이터 라이프사이클: 설치 + 실행? (~400 tokens)
☐ xc-interact # 이미 빌드된 앱으로 UI 테스트? (~900 tokens)
...

시나리오 1: 빌드 및 에러 수정

활성화: xc-build (~600 tokens)
"프로젝트를 빌드하고 에러를 보여줘"
→ 자동 에러 추출 기능이 포함된 xcode_build를 사용합니다.
...

시나리오 2: 빠른 개발 - 빌드 및 실행

활성화: xc-build + xc-launch (~1000 tokens)
"iPhone 15에서 MyApp을 빌드하고 실행해줘"
→ Claude가 오케스트레이션(orchestrates)합니다: 빌드 (xc-build) → 설치 및 실행 (xc-launch)
...

시나리오 3: UI 흐름 테스트 (앱이 이미 빌드된 경우)

활성화: xc-interact (~900 tokens)
"로그인 버튼을 탭하고, 프로필 화면이 나타나는지 확인해줘"
→ 접근성 트리(accessibility tree)를 쿼리합니다 (스크린샷보다 3~4배 빠름)
...

시나리오 4: AI 기반 UI 반복 작업

활성화: xc-ai-assist (~1400 tokens)
"버튼 색상을 파란색으로 업데이트하고, 다시 빌드한 뒤 스크린샷을 보여줘"
→ 코드를 수정하고, 빌드하며, 스크린샷을 캡처합니다.
...

┌─────────────────────────────────────────────────────┐
│ 공유 도구 라이브러리 (24 tools) │
│ ├─ Xcode (6): build, build+run, clean, test, list, version │
...

사용자용:

• 필요한 것만 활성화 (300-3500 tokens)
• 명확한 멘탈 모델 (워크플로 기반 명명 규칙)
• 도구 중복으로 인한 혼란 방지
• Claude 설정에서 쉽게 켜고 끄기 가능

개발자용:

• 단일 진실 공급원 (Single source of truth, 공유 도구)
• 쉬운 테스트 (격리된 기능)
• 간단한 유지보수 (한 번의 업데이트)
• 전 과정에 걸친 타입 안정성 (Type-safe, any 사용 제로)

MCP	도구 (Tools)	토큰 비용 (Token Cost)	사용 시점 (Use When)
xc-build	3	~600	clean/scheme 탐색을 통한 빌드 검증 (Build validation)
xc-launch	2	~400	시뮬레이터 생명주기 (Simulator lifecycle): 앱 설치 및 실행
xc-interact	6	~900	이미 빌드된 앱으로 UI 흐름 테스트

MCP	도구 (Tools)	토큰 비용 (Token Cost)	사용 시점 (Use When)
xc-ai-assist	7	~1400	시각적 피드백을 통한 AI UI 반복 작업 (AI UI iteration)
xc-setup	5	~800	초기 설정, 환경 검증
xc-testing	6	~1200	테스트 스위트 실행 + UI 자동화 (UI automation)
xc-meta	6	~700	유지보수, 관리 (housekeeping), 환경 점검

MCP	도구 (Tools)	토큰 비용 (Token Cost)	사용 시점 (Use When)
xc-all	23	~3500	모든 기능이 필요한 복잡한 워크플로우

프로 팁 (Pro tip): 여러 개의 MCP를 동시에 활성화하지 마세요. 도구 중복으로 인해 토큰 사용량이 증가할 수 있습니다! 다중 워크플로우 세션에는 대신 xc-all을 사용하세요.

필요한 도구가 어떤 MCP에 있는지 확인하기 위한 빠른 참조 표:

도구 (Tool)	xc-build	xc-launch	xc-interact	xc-ai-assist	xc-setup	xc-testing	xc-meta	xc-all
xcode_build	✅	✅	✅
xcode_build_and_launch	✅
xcode_clean	✅	✅	✅
xcode_test	✅	✅
xcode_list	✅	✅	✅
xcode_version	✅	✅	✅

도구 (Tool)	xc-build	xc-launch	xc-interact	xc-ai-assist	xc-setup	xc-testing	xc-meta	xc-all
simulator_list	✅	✅
simulator_boot	✅	✅
simulator_shutdown	✅	✅
simulator_create	✅	✅
simulator_delete	✅	✅
simulator_install_app	✅	✅
simulator_launch_app	✅	✅
simulator_terminate_app	✅
simulator_screenshot	✅	✅	✅
simulator_openurl	✅
simulator_get_app_container	✅
simulator_health_check	✅	✅	✅

| 도구 (Tool) | xc-build | xc-launch | xc-interact | xc-ai-assist | xc-setup | xc-testing | xc-meta | xc-all |
|---|---|---|---|---|---|---|---|
idb_describe | ✅ | ✅ | ✅ | ✅ | ||||
idb_tap | ✅ | ✅ | ✅ | ✅ | ||||
idb_input | ✅ | ✅ | ✅ | ✅ | ||||
idb_gesture | ✅ | ✅ | ✅ | |||||
idb_find_element | ✅ | ✅ | ✅ | |||||
idb_check_quality | ✅ | ✅ | ✅ |

xcode_build

• 자동 오류 추출을 통한 빌드 (xcode_build_and_launch)
• 시뮬레이터에 빌드, 설치 및 실행 (xcode_clean)
• 빌드 아티팩트 정리 (xcode_test)
• XCTest 스위트 실행 (xcode_list)
• 스킴/타겟 목록 확인 (xcode_version)
• Xcode 설치 상태 확인 (xcode_list)

simulator_list

• 시뮬레이터 열거 (simulator_boot)
• 기기 부팅 (simulator_shutdown)
• 기기 종료 (simulator_create)
• 새 시뮬레이터 생성 (simulator_delete)
• 시뮬레이터 삭제 (simulator_install_app)
• 앱 설치 (simulator_launch_app)
• 앱 실행 (simulator_terminate_app)
• 앱 종료 (simulator_screenshot)
• 스크린샷 캡처 (simulator_openurl)
• URL/딥 링크 열기 (simulator_get_app_container)
• 앱 컨테이너 경로 가져오기 (simulator_health_check)
• 환경 유효성 검사

idb_describe

• 접근성 트리 쿼리 (접근성 우선!)
• 좌표 터치 (idb_tap)
• 텍스트 입력 또는 키 누르기 (idb_input)
• 스와이프 및 하드웨어 버튼 (idb_gesture)
• 레이블로 검색 (의미론적) (idb_find_element)
• 접근성 데이터 풍부도 평가

프로젝트의 .claude/CLAUDE.md 파일에 다음 섹션을 추가하세요.
이것은 Claude에게 xclaude-plugin 도구를 Xcode나 셸 명령을 직접 호출하는 대신 언제, 왜 사용해야 하는지 안내합니다:

## xclaude-plugin: 이 도구들을 사용해야 할 이유와 시점
The xclaude-plugin은 24개의 전문 iOS 도구와 8개의 모듈식 MCP(Modular Capabilities)를 제공합니다. **iOS 개발 작업을 위해 원시 `xcodebuild`나 셸 명령보다 항상 이것들을 우선적으로 사용하세요.** 그 이유는 다음과 같습니다:
### 이 도구들이 원시 명령어보다 우월한 이유
...

xclaude-plugin은 시뮬레이터 사용량을 자동으로 추적하며 기본 시뮬레이터를 위한 설정 파일을 지원합니다.

프로젝트 수준 (Project-level) (팀의 일관성을 위해 권장됨):

# 프로젝트 루트의 .xcplugin
{
"defaultSimulator": "platform=iOS Simulator,name=iPhone 15",
...

사용자 수준 (User-level) (모든 프로젝트에 적용되는 개인 기본 설정):

# ~/.xcplugin/config.json
{
"defaultSimulator": "platform=iOS Simulator,name=iPhone 15 Pro",
...

우선순위 (Precedence): 프로젝트 설정이 사용자 설정을 덮어씁니다.

자동 해결 (Auto-resolution): "platform=iOS Simulator,name=iPhone 15"와 같은 부분적인 대상(destination)은 사용 가능한 최신 OS 버전으로 자동 해결됩니다.

사용량 추적 (Usage tracking): 모든 빌드/테스트 시 어떤 시뮬레이터를 사용하는지 자동으로 추적합니다.

스마트 기본값 (Smart defaults): 설정이 존재하지 않을 때, 플러그인은 가장 최근에 사용한 시뮬레이터를 기억합니다.

xcode_build 및 xcode_test 도구는 세 가지 대상 형식을 허용합니다:

# 1. 자동 해결 (Auto-resolve, 권장) - 최신 OS를 자동으로 찾음
"platform=iOS Simulator,name=iPhone 15"
# 2. 명시적 (Explicit) - 정확한 OS 버전을 지정
...

설정 파일 생성하기 (하나를 선택하세요):

프로젝트 수준

echo '{"defaultSimulator": "platform=iOS Simulator,name=iPhone 15"}' > .xcplugin

사용자 수준

mkdir -p ~/.xcplugin
echo '{"defaultSimulator": "platform=iOS Simulator,name=iPhone 15"}' > ~/.xcplugin/config.json

사용 가능한 시뮬레이터 찾기:
xcrun simctl list devices available

사용 가능한 기기를 확인하려면 simulator_list 도구를 사용하세요:
Claude에게 질문하기: "Show me available simulators"

전체 예시는 플러그인 디렉토리의 .xcplugin.example을 참조하세요.

토큰 효율성 (Token efficiency): xc-build (~600 토큰)는 xc-all (3500 토큰)보다 83% 더 저렴합니다.
정신적 명확성 (Mental clarity): 워크플로 단계별로 집중된 도구 제공
조합 가능한 워크플로 (Composable workflows): 개발 루프를 위해 xc-build + xc-launch를 함께 활성화 가능 (~1000 토큰)

가이드라인:

단일 워크플로 (Single workflow): 하나의 집중된 MCP만 활성화 (예: UI 테스트 전용인 xc-interact)
개발 루프 (Development loop): 빌드 → 설치 → 실행을 위해 xc-build + xc-launch를 함께 활성화
복잡한 워크플로 (Complex workflows): 여러 기능이 동시에 필요할 때 xc-all 활성화