Apple Docs MCP - Apple 개발자 문서 모델 컨텍스트 프로토콜 서버

Apple 개발자 문서 MCP 서버 - 모델 컨텍스트 프로토콜을 통해 Apple 공식 개발자 문서, 프레임워크, API, SwiftUI, UIKit 및 WWDC 비디오에 액세스하세요. AI 기반 자연어 쿼리로 iOS, macOS, watchOS, tvOS, visionOS 문서를 검색합니다. Claude, Cursor 또는 MCP 호환 AI 어시스턴트에서 Swift/Objective-C 코드 예제, API 레퍼런스 및 기술 가이드를 즉시 확인할 수 있습니다.

English | 日本語 | 한국어 | 简体中文

✨ 기능

🔍 스마트 검색: SwiftUI, UIKit, Foundation, CoreData, ARKit 등 Apple 개발자 문서 지능형 검색
📚 완전한 문서 액세스: Swift, Objective-C 및 프레임워크 문서를 위한 Apple JSON API 완전 액세스
🔧 프레임워크 인덱스: iOS, macOS, watchOS, tvOS, visionOS 프레임워크의 계층적 API 구조 탐색
📋 기술 카탈로그: SwiftUI, UIKit, Metal, Core ML, Vision, ARKit을 포함한 Apple 기술 탐색
📰 문서 업데이트: WWDC 2024/2025 발표, iOS 26, macOS 26 및 최신 SDK 릴리스 추적
🎯 기술 개요: Swift, SwiftUI, UIKit 및 모든 Apple 개발 플랫폼의 포괄적인 가이드
💻 샘플 코드 라이브러리: iOS, macOS 및 크로스 플랫폼 개발을 위한 Swift 및 Objective-C 코드 예제
🎥 WWDC 비디오 라이브러리: WWDC 2014-2025 세션 검색, 트랜스크립트, Swift/SwiftUI 코드 예제 및 리소스 포함
🔗 관련 API 발견: SwiftUI 뷰, UIKit 컨트롤러 및 프레임워크별 API 관계 찾기
📊 플랫폼 호환성: iOS 13+, macOS 10.15+, watchOS 6+, tvOS 13+, visionOS 호환성 분석
⚡ 고성능: Xcode, Swift Playgrounds 및 AI 기반 개발 환경에 최적화
🔄 스마트 UserAgent 풀: 자동 장애 복구 및 성능 모니터링을 갖춘 지능형 UserAgent 로테이션 시스템
🌐 멀티플랫폼: 완전한 iOS, iPadOS, macOS, watchOS, tvOS, visionOS 문서 지원
🏷️ 베타 및 상태 추적: iOS 26 베타 API, 사용 중단된 UIKit 메서드, 새로운 SwiftUI 기능 추적

🚀 빠른 시작

Claude Desktop (권장)

Claude Desktop 구성 파일에 다음을 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
    }
  }
}

참고: 이전 버전이 사용되는 문제가 발생하면 @latest를 추가하여 최신 버전을 강제합니다:
"args": ["-y", "@kimsungwhee/apple-docs-mcp@latest"]

Claude Desktop을 재시작하고 Apple API에 대해 질문해보세요!

📦 설치

📱 Claude Code

claude mcp add apple-docs -- npx -y @kimsungwhee/apple-docs-mcp@latest

📖 Claude Code MCP 문서

🖱️ Cursor

설정을 통해: 설정 → Cursor 설정 → MCP → 새 글로벌 MCP 서버 추가

구성 파일을 통해: ~/.cursor/mcp.json에 추가:

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
    }
  }
}

📖 Cursor MCP 문서

🔷 VS Code

VS Code MCP 구성에 추가:

{
  "mcp": {
    "servers": {
      "apple-docs": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
      }
    }
  }
}

📖 VS Code MCP 문서

🌊 Windsurf

Windsurf MCP 구성에 추가:

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
    }
  }
}

📖 Windsurf MCP 문서

⚡ Zed

Zed settings.json에 추가:

{
  "context_servers": {
    "Apple Docs": {
      "command": {
        "path": "npx",
        "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
      },
      "settings": {}
    }
  }
}

📖 Zed 컨텍스트 서버 문서

🔧 Cline

마켓플레이스를 통해:

Cline 열기 → 메뉴 (☰) → MCP 서버 → 마켓플레이스
"Apple Docs MCP" 검색 → 설치

구성을 통해: cline_mcp_settings.json에 추가:

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "@kimsungwhee/apple-docs-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Amazon Q Developer CLI

구성 파일을 통해: ~/.aws/amazonq/mcp.json에 추가:

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
    }
  }
}

📖 Amazon Q Developer CLI MCP 문서

🪟 Windows

Windows 시스템의 경우:

{
  "mcpServers": {
    "apple-docs": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@kimsungwhee/apple-docs-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

⚙️ 고급 설치

전역 설치:

# pnpm 사용 (권장)
pnpm add -g @kimsungwhee/apple-docs-mcp

# npm 사용
npm install -g @kimsungwhee/apple-docs-mcp

직접 사용:

npx @kimsungwhee/apple-docs-mcp --help

개발 환경 설정:

git clone https://github.com/kimsungwhee/apple-docs-mcp.git
cd apple-docs-mcp

# pnpm 사용 (권장)
pnpm install && pnpm run build

# npm 사용
npm install && npm run build

💬 사용 예제

🔍 스마트 검색

"SwiftUI 애니메이션 검색"
"CoreML 모델 로딩 방법 찾기"
"Swift async/await 패턴 찾아보기"
"AlarmKit 스케줄링 예제 보여줘"

📚 프레임워크 심화 탐구

"SwiftUI 프레임워크의 상세 정보 가져오기"
"iOS 18 프레임워크의 새로운 기능은?"
"Vision 프레임워크 기능에 대해 알려줘"
"모든 WeatherKit API 보여줘"

🔧 API 탐색

"UIViewController 라이프사이클 메서드 보여줘"
"SwiftData 모델 생성 세부사항 가져오기"
"AlarmAttributes 속성은 무엇인가?"
"모든 ARKit 앵커 타입 나열"

💡 샘플 코드 및 튜토리얼

"알람 스케줄링 샘플 코드 찾기"
"SwiftUI 튜토리얼 예제 보여줘"
"카메라 캡처 샘플 코드 가져오기"
"Core Data 마이그레이션 예제 찾기"

📋 기술 발견

"iOS 26의 모든 베타 프레임워크 나열"
"그래픽 & 게임 기술 보여줘"
"어떤 머신러닝 프레임워크가 사용 가능한가?"
"모든 watchOS 프레임워크 탐색"

📰 문서 업데이트

"최신 WWDC 업데이트 보여줘"
"SwiftUI의 새로운 기능은?"
"iOS 기술 업데이트 가져오기"
"Xcode 릴리스 노트 보여줘"
"최신 업데이트에서 베타 기능 찾기"

🎯 기술 개요

"앱 디자인과 UI의 기술 개요 보여줘"
"게임 개발을 위한 포괄적인 가이드 가져오기"
"AI 및 머신러닝 개요 탐색"
"iOS 전용 기술 가이드 보여줘"
"데이터 관리 기술 개요 가져오기"

💻 샘플 코드 라이브러리

"SwiftUI 샘플 코드 프로젝트 보여줘"
"머신러닝 샘플 코드 찾기"
"UIKit 예제 프로젝트 가져오기"
"추천 WWDC 샘플 코드 보여줘"
"Core Data 샘플 구현 찾기"
"베타 샘플 코드 프로젝트만 보여줘"

🎥 WWDC 비디오 검색

"SwiftUI에 대한 WWDC 비디오 검색"
"머신러닝 WWDC 세션 찾기"
"WWDC 2024 비디오 보여줘"
"async/await WWDC 강연 검색"
"Swift 동시성에 대한 WWDC 비디오 찾기"
"접근성 주제의 WWDC 세션 보여줘"

📺 WWDC 비디오 상세 정보

"WWDC 세션 10176의 상세 정보 가져와"
"WWDC23 SwiftData 세션의 대본 보여줘"
"WWDC 비디오 10019의 코드 예제 가져오기"
"Vision Pro WWDC 세션의 리소스 보여줘"
"'Meet async/await in Swift' 세션의 대본 가져와"

📋 WWDC 주제 및 연도

"모든 WWDC 주제 나열"
"Swift 주제의 WWDC 비디오 보여줘"
"개발자 도구에 대한 WWDC 비디오 가져오기"
"2023년 WWDC 비디오 나열"
"모든 SwiftUI 및 UI 프레임워크 세션 보여줘"
"머신러닝 WWDC 콘텐츠 가져오기"

🛠️ 사용 가능한 도구

도구	설명	주요 기능
`search_apple_docs`	Apple 개발자 문서 검색	공식 검색 API, 특정 API/클래스/메서드 검색
`get_apple_doc_content`	상세한 문서 내용 가져오기	JSON API 액세스, 선택적 향상 분석 (관련/유사 API, 플랫폼 호환성)
`list_technologies`	모든 Apple 기술 탐색	카테고리 필터링, 언어 지원, 베타 상태
`search_framework_symbols`	특정 프레임워크 내 심볼 검색	클래스, 구조체, 프로토콜, 와일드카드 패턴, 타입 필터링
`get_related_apis`	관련 API 찾기	상속, 준수, "참고" 관계
`resolve_references_batch`	API 참조 일괄 해결	문서에서 모든 참조 추출 및 해결
`get_platform_compatibility`	플랫폼 호환성 분석	버전 지원, 베타 상태, 사용 중단 정보
`find_similar_apis`	유사한 API 발견	Apple 공식 권장사항, 주제 그룹화
`get_documentation_updates`	Apple 문서 업데이트 추적	WWDC 발표, 기술 업데이트, 릴리스 노트
`get_technology_overviews`	기술 개요 및 가이드 가져오기	포괄적인 가이드, 계층적 탐색, 플랫폼 필터링
`get_sample_code`	Apple 샘플 코드 프로젝트 탐색	프레임워크 필터링 (제한 있음), 키워드 검색, 베타 상태
`search_wwdc_videos`	WWDC 비디오 세션 검색	키워드 검색, 주제/연도 필터링, 세션 메타데이터
`get_wwdc_video_details`	WWDC 비디오 상세 정보 및 대본	전체 대본, 코드 예제, 리소스, 플랫폼 정보
`list_wwdc_topics`	사용 가능한 모든 WWDC 주제 나열	Swift부터 공간 컴퓨팅까지 19개 주제 카테고리
`list_wwdc_years`	사용 가능한 모든 WWDC 연도 나열	비디오 개수와 함께 연도 정보

🏗️ 기술 아키텍처

apple-docs-mcp/
├── 🔧 src/
│   ├── index.ts                      # MCP 서버 진입점, 모든 도구 포함
│   ├── tools/                        # MCP 도구 구현
│   │   ├── search-parser.ts          # HTML 검색 결과 파싱
│   │   ├── doc-fetcher.ts            # JSON API 문서 가져오기
│   │   ├── list-technologies.ts      # 기술 카탈로그 처리
│   │   ├── get-documentation-updates.ts # 문서 업데이트 추적
│   │   ├── get-technology-overviews.ts # 기술 개요 및 가이드
│   │   ├── get-sample-code.ts        # 샘플 코드 라이브러리 브라우저
│   │   ├── get-framework-index.ts    # 프레임워크 구조 인덱싱
│   │   ├── get-related-apis.ts       # 관련 API 발견
│   │   ├── resolve-references-batch.ts # 일괄 참조 해결
│   │   ├── get-platform-compatibility.ts # 플랫폼 분석
│   │   ├── find-similar-apis.ts      # 유사한 API 추천
│   │   └── wwdc/                     # WWDC 비디오 도구
│   │       ├── wwdc-handlers.ts      # WWDC 도구 핸들러
│   │       ├── content-extractor.ts  # 비디오 콘텐츠 추출
│   │       ├── topics-extractor.ts   # 주제 리스트
│   │       └── video-list-extractor.ts # 비디오 리스트 파싱
│   └── utils/                        # 유틸리티 함수 및 헬퍼
│       ├── cache.ts                  # TTL 지원 메모리 캐시
│       ├── constants.ts              # 애플리케이션 상수 및 URL
│       ├── error-handler.ts          # 오류 처리 및 검증
│       ├── http-client.ts            # 성능 추적 HTTP 클라이언트
│       ├── user-agent-pool.ts        # 스마트 UserAgent 로테이션 시스템
│       ├── http-headers-generator.ts # 동적 브라우저 헤더 생성
│       └── url-converter.ts          # URL 변환 유틸리티
├── 📦 dist/                          # 컴파일된 JavaScript
├── 🧪 tests/                         # 테스트 스위트
├── 📄 package.json                   # 패키지 구성
└── 📖 README.md                      # 이 파일

🚀 성능 기능

메모리 기반 캐싱: 자동 정리 및 TTL 지원을 갖춘 커스텀 캐시 구현
스마트 UserAgent 풀: 자동 장애 복구 및 성능 모니터링을 갖춘 지능형 로테이션 시스템
동적 헤더: 사실적인 브라우저 헤더 생성 (Accept, Accept-Language, User-Agent)
스마트 검색: 향상된 결과 포맷팅을 갖춘 공식 Apple 검색 API
향상된 분석: 선택적 관련 API, 플랫폼 호환성 및 유사성 분석
오류 복원력: 포괄적인 오류 처리를 통한 우아한 성능 저하
타입 안전성: Zod v4.0.5 런타임 검증을 갖춘 완전한 TypeScript
최신 의존성: MCP SDK v1.15.1, 최적화된 패키지 크기

💾 캐싱 전략

콘텐츠 타입	캐시 기간	캐시 크기	이유
API 문서	30분	500 항목	자주 액세스됨, 적당한 업데이트
검색 결과	10분	200 항목	동적 콘텐츠, 사용자별
프레임워크 인덱스	1시간	100 항목	안정적인 구조, 변경 빈도 낮음
기술 목록	2시간	50 항목	거의 변경되지 않음, 대용량 콘텐츠
문서 업데이트	30분	100 항목	정기 업데이트, WWDC 발표
WWDC 비디오 데이터	2시간	무제한	안정적인 콘텐츠, 로컬 JSON 파일

📦 WWDC 데이터

모든 WWDC 비디오 데이터 (2014-2025)는 npm 패키지에 직접 번들링되어 다음을 제공합니다:

✅ 네트워크 지연 없음 - WWDC 콘텐츠에 API 호출 불필요
✅ 100% 오프라인 액세스 - 인터넷 연결 없이 작동
✅ 속도 제한 없음 - 무제한 WWDC 검색 및 탐색
✅ 즉각적인 응답 - 모든 데이터가 로컬에서 사용 가능

포함된 데이터:

📹 1,260개 이상의 WWDC 세션 비디오 및 전체 대본
🏷️ 20개 주제 카테고리로 체계적인 탐색
📅 13년간의 콘텐츠 (2012-2025)
💾 35MB의 최적화된 JSON 데이터

참고: 최신 WWDC 콘텐츠를 받으려면 패키지를 업데이트하세요.

⚙️ 설정

🔄 UserAgent 풀 설정

MCP 서버는 API 안정성을 향상시키기 위한 지능형 UserAgent 로테이션 시스템을 포함합니다:

환경 변수

변수	설명	기본값	예시
`USER_AGENT_ROTATION_ENABLED`	로테이션 활성화/비활성화	`true`	`true`
`USER_AGENT_POOL_STRATEGY`	로테이션 전략	`random`	`smart`
`USER_AGENT_MAX_RETRIES`	최대 재시도 횟수	`3`	`5`
`USER_AGENT_POOL_CONFIG`	커스텀 풀 설정 (JSON)	내장 에이전트	아래 참조

커스텀 풀 설정

# 커스텀 UserAgent 풀 설정
export USER_AGENT_POOL_CONFIG='[
  {"userAgent": "MyApp/1.0 (compatible)", "weight": 3, "maxUsageCount": 1000},
  {"userAgent": "MyApp/2.0 (advanced)", "weight": 2, "maxUsageCount": 800}
]'

# 로테이션 전략 설정 (random/sequential/smart)
export USER_AGENT_POOL_STRATEGY=smart

# 디버깅 활성화
export NODE_ENV=development

사용 가능한 전략

random: 빠른 무작위 선택 (최고 성능)
sequential: 라운드 로빈 로테이션 (예측 가능한 순서)
smart: 성공률 최적화 (최고 안정성)

내장 UserAgent

서버에는 다음을 포함하는 12개 이상의 사전 구성된 UserAgent 문자열이 포함됩니다:

Chrome (Mac Intel/Apple Silicon, Windows, Linux)
Firefox (Mac Intel/Apple Silicon, Windows, Linux)
Safari (Mac Intel/Apple Silicon, 최신 버전)
Edge (Windows, Mac Intel/Apple Silicon)

🧪 개발

빠른 명령어

# 자동 재로드 개발
pnpm run dev    # 또는: npm run dev

# 프로덕션 빌드
pnpm run build  # 또는: npm run build

# 타입 체크
pnpm exec tsc --noEmit  # 또는: npx tsc --noEmit

# 빌드 결과물 정리
pnpm run clean  # 또는: npm run clean

로컬 테스트

# MCP 서버 직접 테스트
node dist/index.js

# 샘플 쿼리로 테스트
npx @kimsungwhee/apple-docs-mcp --test

🤝 기여

기여를 환영합니다! 시작하는 방법:

저장소를 Fork
기능 브랜치 생성: git checkout -b feature/amazing-feature
변경사항 커밋: git commit -m 'Add amazing feature'
브랜치에 푸시: git push origin feature/amazing-feature
Pull Request 열기

📄 라이선스

MIT 라이선스 - 자세한 내용은 LICENSE를 참조하세요.

⚠️ 면책조항

이 프로젝트는 Apple Inc.와 제휴하거나 승인받지 않았습니다. 교육 및 개발 목적으로 공개적으로 사용 가능한 Apple 개발자 문서 API를 사용합니다.

Apple 개발자 커뮤니티를 위해 ❤️로 제작

문제 신고 • 기능 요청 • 문서

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Apple Docs MCP - Apple 개발자 문서 모델 컨텍스트 프로토콜 서버

✨ 기능

🚀 빠른 시작

Claude Desktop (권장)

📦 설치

💬 사용 예제

🔍 스마트 검색

📚 프레임워크 심화 탐구

🔧 API 탐색

💡 샘플 코드 및 튜토리얼

📋 기술 발견

📰 문서 업데이트

🎯 기술 개요

💻 샘플 코드 라이브러리

🎥 WWDC 비디오 검색

📺 WWDC 비디오 상세 정보

📋 WWDC 주제 및 연도

🛠️ 사용 가능한 도구

🏗️ 기술 아키텍처

🚀 성능 기능

💾 캐싱 전략

📦 WWDC 데이터

⚙️ 설정

🔄 UserAgent 풀 설정

환경 변수

커스텀 풀 설정

사용 가능한 전략

내장 UserAgent

🧪 개발

빠른 명령어

로컬 테스트

🤝 기여

📄 라이선스

⚠️ 면책조항

FilesExpand file tree

README.ko.md

Latest commit

History

README.ko.md

File metadata and controls

Apple Docs MCP - Apple 개발자 문서 모델 컨텍스트 프로토콜 서버

✨ 기능

🚀 빠른 시작

Claude Desktop (권장)

📦 설치

💬 사용 예제

🔍 스마트 검색

📚 프레임워크 심화 탐구

🔧 API 탐색

💡 샘플 코드 및 튜토리얼

📋 기술 발견

📰 문서 업데이트

🎯 기술 개요

💻 샘플 코드 라이브러리

🎥 WWDC 비디오 검색

📺 WWDC 비디오 상세 정보

📋 WWDC 주제 및 연도

🛠️ 사용 가능한 도구

🏗️ 기술 아키텍처

🚀 성능 기능

💾 캐싱 전략

📦 WWDC 데이터

⚙️ 설정

🔄 UserAgent 풀 설정

환경 변수

커스텀 풀 설정

사용 가능한 전략

내장 UserAgent

🧪 개발

빠른 명령어

로컬 테스트

🤝 기여

📄 라이선스

⚠️ 면책조항