xclaude-plugin
무엇인가
xclaude-plugin은 iOS 앱의 빌드·테스트·시뮬레이터 조작을 Claude Code 대화로 수행하게 하면서, 그 과정에서 소모되는 컨텍스트와 토큰을 예산 안에 묶는 플러그인이다. Xcode·Simulator·IDB 도구 24개를 하나의 서버에 몰아넣지 않고 워크플로 단위로 분할해, 사용자가 지금 하는 작업에 해당하는 도구 집합만 활성화하도록 규율한다.
어떻게 동작하나
구조는 .mcp.json에 등록되는 MCP 서버 묶음과 mcp-servers/<이름>/dist/index.js 진입점으로 이루어진다. 도구 정의는 한 곳에서만 작성되고 각 MCP가 이를 import하는 단일 출처 방식이며, 서버별 토큰 점유는 xc-launch 약 400에서 xc-all 약 3500까지 차등이 있다. 별도로 8개의 절차 스킬(xcode-workflows, simulator-workflows, ui-automation-workflows, accessibility-testing, ios-testing-patterns, crash-debugging, performance-profiling, state-management)이 필요할 때만 로드된다. 도구 반환값은 원시 빌드 로그 대신 오류·테스트 결과를 구조화 JSON으로 캡슐화해 전달한다.
무엇과 다른가
프롬프트를 직접 쓰거나 단일 CLAUDE.md에 규칙을 몰아넣는 방식과 달리, 여기서는 도구 자체를 워크플로 경계로 쪼개 토큰 예산을 사용자가 직접 조절한다. v0.4.0에서 build·install·launch를 한 번에 처리하던 xcode_build_and_launch 모놀리식 도구를 제거하고 xc-build와 xc-launch로 분리한 것이 그 원칙의 예로, 실패한 단계만 재시도할 수 있고 skip_build 같은 분기 플래그가 사라진다.
어떻게 쓰나
설치는 마켓플레이스 등록과 플러그인 설치 두 명령으로 끝난다. 설치 후 Claude 설정에서 xc-build와 xc-launch를 함께 켜면 빌드→설치→실행 루프가 약 1000토큰으로 구성되고, "Build and run MyApp on iPhone 15" 같은 요청으로 바로 쓸 수 있다. 테스트·환경 설정·UI 자동화가 필요하면 해당 MCP를 하나만 추가로 켠다.
전제와 한계
전제는 macOS 13.0+ 또는 Linux, Xcode 15.0+, Node.js 18+이며 iOS 개발 자체는 macOS에서만 된다. 고급 UI 자동화에는 IDB가 선택적으로 필요하다. README 기준으로 유지보수가 중단된 상태이고, 저자는 같은 용도의 xc-mcp와 ios-simulator-skill 저장소를 대안으로 안내한다. v0.4.0 이전 설정을 쓰던 경우 .mcp.json의 서버 이름과 활성화 항목을 xc-launch로 바꿔야 한다.
유사 도구
- mcp-useTypeScript로 MCP 서버와 ChatGPT·Claude용 뷰 앱을 정의하도록 Zod 스키마·도구 등록·React 뷰 바인딩·Inspector 검증 절차를 에이전트에 주입하는 Claude Code 플러그인이다.
- claude-delegatorClaude Code가 복잡한 작업을 GPT·Gemini 전문 서브에이전트에게 위임하도록 MCP 라우팅 규칙과 전문가 프롬프트를 주입하는 플러그인이다.
- lumen에이전트가 파일 전체를 읽는 대신 로컬 임베딩으로 만든 의미 검색 MCP 도구를 쓰게 해, 토큰 비용과 세션 시간을 줄이는 Claude Code 플러그인이다.
- agnixCLAUDE.md·AGENTS.md·SKILL.md·훅·MCP 설정을 456개 규칙으로 검사해 잘못된 필드와 무시되는 지시를 잡아내고 자동 수정까지 하는 린터 플러그인이다.