apple-docs-mcp MCP — 사용 사례, 설치 & 라이브 데모

Name: apple-docs-mcp MCP Server
Author: kimsungwhee

왜 쓰나요

핵심 기능

Search Apple docs across SwiftUI, UIKit, Foundation, ARKit, Core ML, Metal, Vision
WWDC 2014-2025 video search with transcripts and code examples
Framework-scoped symbol search
Platform compatibility + deprecation tracking
Offline-bundled WWDC session index

라이브 데모

실제 사용 모습

apple-docs.replay ▶ 준비됨

0/0

설치

클라이언트 선택

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

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

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

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "apple-docs": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "apple-docs-mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

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

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: apple-docs-mcp

How to stop your agent from hallucinating SwiftUI APIs

👤 iOS devs using Claude/Cursor ⏱ ~10 min beginner

언제 쓸까: Agent suggests APIs that don't exist in the iOS version you target.

사전 조건

Node 18+ — nvm install 20

흐름

Install

Install via: npx -y @kimsungwhee/apple-docs-mcp@latest (or add to MCP config).✓ 복사됨

→ Tools appear
Ground your question

Use search_apple_docs to find 'navigationDestination' and get_platform_compatibility to check it's available on iOS 16+.✓ 복사됨

→ Official doc entry + minimum deployment target
Cite in code

Now write the navigation code citing the doc you just read.✓ 복사됨

→ Code + citations

결과: Code that compiles against your deployment target.

함정

WWDC-only APIs shown before release — Check get_platform_compatibility — beta APIs are flagged

함께 쓰기: github

How to find the WWDC session that explains a feature

👤 iOS devs adopting a new feature ⏱ ~10 min beginner

언제 쓸까: Docs are terse; the context is in a WWDC talk you didn't watch.

흐름

Search WWDC

search_wwdc_videos 'Observation framework Swift macro' years=[2023,2024].✓ 복사됨

→ Session list
Pull transcript + code

get_wwdc_video_details for the top hit. Extract the code samples.✓ 복사됨

→ Transcript + code snippets

결과: Context + working code without watching the video.

How to plan a migration off a deprecated API

👤 iOS devs maintaining older codebases ⏱ ~10 min intermediate

언제 쓸까: A warning says 'deprecated in iOS 17' and you want the replacement.

흐름

Confirm deprecation

get_platform_compatibility for UIActivityIndicatorView.startAnimating.✓ 복사됨

→ Availability timeline
Find recommended replacement

find_similar_apis — what's the SwiftUI equivalent?✓ 복사됨

→ ProgressView() with appropriate args

결과: Confident migration plan with references.

함께 쓰기: github

조합

다른 MCP와 조합해 10배 효율

apple-docs + github

Ground a migration PR with docs + WWDC references

Find the SwiftUI replacement for our UIKit ActivityViewController usage, cite Apple docs and WWDC sessions, and draft a migration PR.✓ 복사됨

apple-docs + filesystem

Scan local code for deprecated APIs and suggest replacements

Grep my Sources/ for any API marked deprecated per apple-docs-mcp; produce a migration checklist.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
search_apple_docs	query: str, platform?: str	Find any API by name or topic	free
get_apple_doc_content	url_or_id	Read full page after search	free
list_technologies	category?, include_beta?: bool	Browse frameworks	free
search_framework_symbols	framework, query	Scoped symbol lookup	free
get_related_apis	symbol	Inheritance/conformance traversal	free
get_platform_compatibility	symbol	Check availability	free
find_similar_apis	symbol	Replacements for deprecated APIs	free
get_sample_code	topic?	Find Apple sample projects	free
search_wwdc_videos	query, years?: int[], topics?: str[]	Find WWDC talks	free
get_wwdc_video_details	session_id	Full session context	free

비용 및 제한

운영 비용

API 쿼터: developer.apple.com has reasonable-use rate limits; tool caches to reduce calls
호출당 토큰: Docs: 500-3000 tokens. Transcripts: up to 20k tokens for long sessions
금액: Free
팁: Use search_framework_symbols instead of broad search_apple_docs to save tokens.

보안

권한, 시크릿, 파급범위

최소 스코프: None — public docs only

자격 증명 저장: None

데이터 외부 송신: developer.apple.com + bundled offline index

절대 부여 금지: Nothing to grant

Apple docs get revised without notice; Claude responses may lag the live site by a few days.

문제 해결

자주 발생하는 오류와 해결

Search returns no results

Query may be too specific — try the class name alone or use list_technologies to browse.

Doc content looks truncated

Some pages are large; the tool truncates — pass the URL to get_apple_doc_content which handles pagination.

WWDC video not found

Some older sessions are not transcribed. Use search_wwdc_videos with years filter.

대안

apple-docs-mcp 다른 것과 비교

대안	언제 쓰나	단점/장점
apple-docs via firecrawl	You want raw scraping	No WWDC index, no structure
context7 MCP	You want general library docs, not Apple-specific	Weaker Apple coverage

apple-docs-mcp