apple-docs-mcp MCP — Anwendungsfälle, Installieren & Live-Demo

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

Warum nutzen

Hauptfunktionen

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

Live-Demo

In der Praxis

apple-docs.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/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
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

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

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

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

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

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

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

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: apple-docs-mcp

How to stop your agent from hallucinating SwiftUI APIs

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

Wann einsetzen: Agent suggests APIs that don't exist in the iOS version you target.

Voraussetzungen

Node 18+ — nvm install 20

Ablauf

Install

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

→ Tools appear
Ground your question

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

→ Official doc entry + minimum deployment target
Cite in code

Now write the navigation code citing the doc you just read.✓ Kopiert

→ Code + citations

Ergebnis: Code that compiles against your deployment target.

Fallstricke

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

Kombinieren mit: github

How to find the WWDC session that explains a feature

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

Wann einsetzen: Docs are terse; the context is in a WWDC talk you didn't watch.

Ablauf

Search WWDC

search_wwdc_videos 'Observation framework Swift macro' years=[2023,2024].✓ Kopiert

→ Session list
Pull transcript + code

get_wwdc_video_details for the top hit. Extract the code samples.✓ Kopiert

→ Transcript + code snippets

Ergebnis: Context + working code without watching the video.

How to plan a migration off a deprecated API

👤 iOS devs maintaining older codebases ⏱ ~10 min intermediate

Wann einsetzen: A warning says 'deprecated in iOS 17' and you want the replacement.

Ablauf

Confirm deprecation

get_platform_compatibility for UIActivityIndicatorView.startAnimating.✓ Kopiert

→ Availability timeline
Find recommended replacement

find_similar_apis — what's the SwiftUI equivalent?✓ Kopiert

→ ProgressView() with appropriate args

Ergebnis: Confident migration plan with references.

Kombinieren mit: github

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

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.✓ Kopiert

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.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
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

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: developer.apple.com has reasonable-use rate limits; tool caches to reduce calls
Tokens pro Aufruf: Docs: 500-3000 tokens. Transcripts: up to 20k tokens for long sessions
Kosten in €: Free
Tipp: Use search_framework_symbols instead of broad search_apple_docs to save tokens.

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: None — public docs only

Credential-Speicherung: None

Datenabfluss: developer.apple.com + bundled offline index

Niemals gewähren: Nothing to grant

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

Fehlerbehebung

Häufige Fehler und Lösungen

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.

Alternativen

apple-docs-mcp vs. andere

Alternative	Wann stattdessen	Kompromiss
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

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen