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

Apple Docs 2.0 MCP

Apple 개발자 문서, 디자인 가이드라인 및 WWDC 세션을 위한 단일 MCP.

에이전트를 사용하여 다음 iOS 앱을 구축하나요? 먼저 Apple 자체 문서를 읽게 하세요: 리라이트 감소, 중단 감소.

MCP tools

Node.js

MCP Registry

skills.sh

MIT license

Quick Start · What's New · Installation · Usage · Tools · Architecture · Development

<code class="language-bash">npx -y apple-docs-2.0-mcp</code>

모델 컨텍스트 프로토콜(Model Context Protocol)을 통한 AI 어시스턴트를 위한 Apple 개발자 문서: API 레퍼런스, 아티클, 샘플 코드, 튜토리얼, Human Interface Guidelines, App Store Connect Help, 웹 서비스 API (App Store Connect API, App Store Server API 등) 및 트랜스크립트와 코드가 포함된 1,700개의 WWDC 세션.

Apple Docs 2.0 MCP는 kimsungwhee의 Apple Docs MCP를 포크(fork)하여 추가 기능, 수정 사항 및 새로운 도구로 개선한 것입니다.

🚀 Quick Start

Claude Desktop (권장)

Claude Desktop 설정에 다음을 추가하세요:

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

⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.

[번역된 제목]: Apple Docs 2.0 MCP

[이번 청크 (이 부분만 번역하세요)]:

{
  "mcpServers": {
    "apple-docs": {
...

참고: 이전 버전 사용에 문제가 발생하면, @latest를 추가하여 최신 버전을 강제할 수 있습니다:

복사

"args": ["-y", "apple-docs-2.0-mcp@latest"]

1

2

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

Claude 코드

claude mcp add apple-docs -- npx -y apple-docs-2.0-mcp

에이전트에게 질문하기

Apple의 문서에서 NavigationStack을 찾아보고, 이를 사용하는 WWDC 코드를 보여줘.

🆕 2.0 버전의 새로운 기능

Apple Docs 2.0 MCP는 Apple Docs MCP 1.0.26이 하던 모든 기능을 유지하며, 작동하지 않았거나 불완전하게 돌아왔던 부분을 수정했습니다. 따라서 이제 어시스턴트가 추측하는 대신 Apple 자체 문서에서 답변을 제공합니다.

🔍 검색 결과 반환

search_apple_docs 기능이 수정되었습니다. 이제 Apple 웹사이트가 사용하는 것과 동일한 검색 서비스를 사용하므로, 어시스턴트는 developer.apple.com에서 볼 수 있는 결과를 얻게 됩니다: API 레퍼런스, 아티클, 샘플 코드, 디자인 가이드라인, App Store Connect 도움말 및 WWDC 비디오입니다. 이전 버전에서는 Apple이 검색 페이지를 변경했기 때문에 검색 결과가 빈 값으로 나왔습니다.

API, 디자인 가이드라인 또는 App Store 프로세스에 대해 질문하면, 어시스턴트가 먼저 검색을 수행한 다음 찾은 페이지들을 읽어줍니다.

🗺️ 이름으로 모든 페이지 조회

새로운 도구인 search_docs_map은 오프라인 상태에서 336,723개의 페이지 중 이름을 통해 또는 일부만으로 어떤 페이지든 찾아줍니다:

• API 심볼: 타입(types), 메서드(methods), 속성(properties), 열거형 케이스(enum cases), 매크로(macros)
• 아티클 및 샘플 코드
• Info.plist 및 엔타이틀먼트 키(entitlement keys)
• 웹 서비스 엔드포인트, 예: App Store Connect API
• 휴먼 인터페이스 가이드라인(Human Interface Guidelines) 및 App Store Connect 도움말 페이지

코드나 오류 메시지에서 이미 이름을 알고 있을 때, 이 도구를 사용하여 해당 페이지를 바로 열 수 있습니다.

📄 완벽한 문서 페이지

Pages는 Apple 웹사이트에서처럼 전체 내용이 제공됩니다. 즉, 모든 메서드와 속성이 완전한 시그니처(var view: UIView!, 단순히 view가 아님)로 표시되며, 해당 타입이 상속받고 준수하는 것들, 관련 API, 그리고 지원하는 OS 버전까지 포함합니다. 2.0은 또한 Human Interface Guidelines(휴먼 인터페이스 가이드라인), 튜토리얼, App Store Connect Help, 그리고 매개변수와 응답을 가진 App Store Connect API 엔드포인트도 읽습니다.

어떤 API, 가이드라인 또는 App Store Connect 주제에 대해 질문해도, 어시스턴트는 답변하거나 코드를 작성하기 전에 전체 페이지를 읽습니다.

🎥 WWDC 2014–2026, 코드 포함

WWDC26을 포함하여 총 1,700개의 세션이 구축되어 있으며 오프라인에서도 작동합니다. 이 중 1,416개 세션의 스크립트가 제공되며, 각 단락에는 시작 시간이 표시되고, 480개 세션은 장(chapter)으로 구분되며, 715개 코드 샘플에는 해당 샘플이 영상에서 나타나는 시간까지 기록되어 있습니다. 세션들은 Apple 웹사이트와 동일한 주제별로 분류됩니다.

새로운 API가 어떻게 작동하는지 물어보면, 어시스턴트는 해당 API를 소개한 WWDC 세션을 코드와 함께 인용할 수 있습니다.

📋 전체 프레임워크 목록

기존 버전의 기술 목록은 200개 항목에서 중단되어 Graphics and Games, Media, System, Web과 같은 전체 카테고리가 나타나지 않았으며, 심볼 검색이 제목과 깨진 링크를 뒤섞어 표시했습니다. 2.0은 모든 것을 나열하고, 베타 상태의 프레임워크를 표시하며, 주제별로 프레임워크를 찾을 수 있습니다. 예를 들어, 'Machine learning'을 검색하면 Core ML, Create ML, Foundation Models, Vision 등이 반환됩니다.

머신러닝이나 오디오와 같은 작업에 적합한 프레임워크가 무엇인지 물어보면, 어시스턴트가 전체 목록을 비교하여 알려줍니다.

🛠️ 작동하도록 구축됨

최신 종속성(dependency), 일반 브라우저처럼 보이는 요청과 순서를 지키는 방식(너무 빨리 보내면 Apple이 빈 검색 결과를 반환함), 요청 실패 시 자동 재시도, 그리고 207개의 자동화 테스트가 포함되어 있습니다. 기존 README의 모든 63개 사용 예제가 오류 없이 실행됩니다.

설정할 것이 없습니다: API 키나 계정이 필요하지 않습니다.

✨ 기능

• 🔍 검색 (Search): Apple의 문서, 디자인 가이드라인, 샘플 코드, App Store Connect 도움말 및 WWDC 세션 등을 하나의 검색창에서 또는 개별적으로 검색
• 🗺️ 문서 지도 (Docs map): 네트워크 요청 없이 제목(심지어 메서드나 속성 이름)으로 모든 페이지를 찾을 수 있음
• 📚 문서 페이지 (Documentation pages): Swift 및 Objective-C API, 아티클, 튜토리얼, 웹 서비스 참조 등을 Markdown 형식으로 제공
• 🎨 휴먼 인터페이스 가이드라인 (Human Interface Guidelines): 모든 HIG 페이지를 검색하고 읽을 수 있음
• 🏪 App Store Connect 도움말: 제품 페이지 필드, 리뷰, TestFlight, 가격 책정 정보
• 🔧 프레임워크 심볼 (Framework symbols): 와일드카드(wildcard)로 프레임워크의 클래스, 구조체(struct), 프로토콜, 멤버를 탐색
• 🔗 API 관계 (API relationships): 관련 API, 유사한 API, 참조된 API 및 사용 중단된 API의 대체품 제공
• 📊 플랫폼 호환성 (Platform compatibility): 각 플랫폼에서 API가 도입되고 사용 중단된 버전을 표시
• 📋 기술 카탈로그 (Technology catalog): 모든 Apple 프레임워크와 기술을 카테고리별로 정리하고, 베타 버전은 별도로 표시
• 📰 문서 업데이트 (Documentation updates): 릴리스 노트, 프레임워크 업데이트 및 WWDC의 '새로운 기능(What's new)' 페이지
• 🎯 기술 개요 (Technology overviews): 앱 디자인, 게임, AI 및 머신러닝, 데이터 등에 대한 Apple 가이드 제공
• 💻 샘플 코드 (Sample code): 모든 샘플 프로젝트를 Apple 검색 순으로 순위화하고, 프레임워크 또는 섹션별로 샘플 코드 라이브러리를 요약 및 다운로드 링크와 함께 제공
• 🎥 WWDC 라이브러리: 2014년부터 2026년까지의 1,700개 세션을 스크립트, 시간 지정된 코드 예제, 리소스 및 관련 세션과 함께 오프라인으로 제공

📦 설치 (Installation)

claude mcp add apple-docs -- npx -y apple-docs-2.0-mcp

📖 Claude Code MCP docs

~/.cursor/mcp.json에 추가:

{

작업 공간 루트에 `.mcp.json` 파일에 추가하세요. VS Code의 포터블 형식입니다:

```json
{
  "mcpServers": {
    "apple-docs": {
...

📖 VS Code MCP 문서

Zed의 settings.json에 추가하세요:

{
  "context_servers": {
    "apple-docs": {
...

📖 Zed MCP 문서

💬 사용 예시

🔍 검색 (Search)

"SwiftUI 애니메이션을 검색해 주세요"
"withAnimation API 문서를 찾아주세요"
"탭 바에 대한 Human Interface Guidelines를 검색해 주세요"
...

🗺️ 문서 지도 (Docs Map)

"accessibilityInputLabels 페이지를 찾아주세요"
"제목에 gauge가 있는 SwiftUI 페이지는 무엇인가요?"
"자동 갱신 구독을 생성하는 App Store Connect API 엔드포인트를 찾아주세요"

📚 문서 접근 (Documentation Access)

"SwiftUI 프레임워크에 대한 자세한 정보를 알려주세요"
"withAnimation API와 관련 API를 보여주세요"
"NSManagedObjectContext 문서를 보여주세요"
...

🔧 프레임워크 탐색 (Framework Exploration)

"SwiftUI 뷰를 보여주세요"
"모든 UIKit delegate 프로토콜을 나열해 주세요"
"WeatherKit API 계층 구조를 가져와 주세요"
...

🔗 API 검색 (API Discovery)

"UIViewController 관련 API를 찾아주세요"
"UIAlertView의 대안을 발견해 주세요"
"SwiftData 문서에서 모든 참조를 가져와 주세요"
...

📋 기술, 업데이트 및 개요 (Technologies, Updates and Overviews)

"사용 가능한 머신러닝 프레임워크는 무엇인가요?"
"베타 버전인 기술은 무엇인가요?"
"SwiftUI의 새로운 기능은 무엇인가요?"
...

💻 샘플 코드 (Sample Code)

"SwiftUI 샘플 코드 프로젝트를 보여주세요"
"머신러닝용 샘플 코드를 찾아주세요"
"Food Truck 샘플을 가져와 주세요"

🎥 WWDC

"SwiftUI에 관한 WWDC 비디오를 검색해 주세요"
"머신러닝에 대한 WWDC 세션을 찾아주세요"
"WWDC 2026 비디오를 보여주세요"
...

🛠️ 사용 가능한 도구 (Available Tools)

🏗️ 아키텍처 (Architecture)

Apple-Docs-2.0-MCP/
├── src/
│   ├── index.ts                    # MCP 서버 및 검색 가이드
...

🌐 요청 및 캐싱 (Requests and Caching)

모든 요청은 하나의 HTTP 클라이언트, 즉 Safari의 헤더가 적용된 fetch를 통해 처리됩니다. 분당 최대 100회 요청이 가능하며, Apple이 결과를 찾지 못할 경우 더 빠른 응답을 보내기 때문에 검색은 한 번에 하나씩, 15초 간격으로 이루어집니다. 각 시도는 2분 타임아웃을 가지며, 네트워크 오류, 타임아웃 및 5xx 응답 발생 시 최대 3회 재시도와 백오프(backoff) 로직이 적용됩니다.

Apple의 JSON 데이터는 Apple이 전송하는 대로 URL 단위로 캐싱되며 모든 도구에서 공유됩니다. 즉, 다른 도구가 방금 읽은 페이지는 다시 다운로드되지 않으며, 동일한 시점에 하나의 URL에 대한 요청들은 단일 다운로드를 공유합니다.

📦 WWDC 데이터 (WWDC Data)

WWDC 세션은 data/wwdc/에 번들되어 있어, WWDC 도구는 오프라인 상태에서 속도 제한(rate limits) 없이 작동합니다:

• 📹 2014년부터 2026년까지의 1,700개 세션 중 1,416개는 스크립트가 첨부되어 있고 각 단락별로 시간이 기록되었으며 (Apple이 더 이상 목록에 포함하지 않은 6개를 제외), 715개는 코드 예제가 있으며, 480개는 챕터가 있습니다
• 🏷️ Apple의 토픽 페이지에서 가져온 19개 주제(topics)
• 💾 48 MB의 JSON 데이터

npx tsx scripts/add-wwdc-year.ts <년도> 명령은 Apple의 페이지에서 연도를 추가하거나 새로 고칩니다. Apple이 더 이상 목록에 포함하지 않은 세션이라도 저장된 데이터를 유지합니다.

🗺️ 문서 맵 (Docs Map)

api-map/apple-docs-map.tsv는 Apple의 네비게이터 인덱스, Human Interface Guidelines 및 App Store Connect Help의 탐색 정보에서 가져온 336,723개의 페이지(URL, 제목, 종류, 기술, 그룹, 트리, 해당 기술의 ID, Beta 또는 Deprecated 표시, 그리고 사이드바에 해당 페이지를 나열하는 다른 기술) 목록을 담고 있습니다. search_docs_map은 사용 중 메모리에 이 정보를 유지합니다. npx tsx scripts/build-docs-map.ts api-map/apple-docs-map.tsv 명령어를 실행하면 약 10분 만에 이를 재구축할 수 있습니다.

🧪 개발 (Development)

git clone https://github.com/mishafyi/Apple-Docs-2.0-MCP.git
cd Apple-Docs-2.0-MCP
npx pnpm@10 install
...

빌드가 완료된 후에는 MCP 클라이언트에서 서버를 재시작하거나 다시 연결해야 합니다.

🙏 크레딧 (Credits)

Apple Docs 2.0 MCP는 Apple Docs MCP를 기반으로 하며, 이는 kimsungwhee가 만든 도구, WWDC 데이터 및 구조에서 시작되었습니다.

🤝 기여 (Contributing)

기여는 환영합니다: