apple-docs-mcp MCP — Cas d'usage, Installer & Démo en direct

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

Pourquoi l'utiliser

Fonctionnalités clés

Recherchez dans la documentation Apple : SwiftUI, UIKit, Foundation, ARKit, Core ML, Metal, Vision
Recherche vidéos WWDC 2014-2025 avec transcriptions et exemples de code
Recherche de symboles par framework
Compatibilité multiplateforme et suivi des API dépréciées
Index des sessions WWDC en local (sans connexion)

Démo en direct

Aperçu en pratique

apple-docs.replay ▶ prêt

0/0

Installer

Choisissez votre 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
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : apple-docs-mcp

Comment empêcher votre agent d'inventer des API SwiftUI

👤 Développeurs iOS utilisant Claude/Cursor ⏱ ~10 min beginner

Quand l'utiliser : Votre agent propose des API qui n'existent pas dans la version iOS que vous ciblez.

Prérequis

Node 18+ — nvm install 20

Déroulement

Installation

Installez via : npx -y @kimsungwhee/apple-docs-mcp@latest (ou ajoutez à la configuration MCP).✓ Copié

→ Les outils apparaissent
Fondez votre question

Utilisez search_apple_docs pour chercher 'navigationDestination' et get_platform_compatibility pour vérifier qu'elle est disponible sur iOS 16+.✓ Copié

→ Entrée officielle de la documentation + cible de déploiement minimum
Citez dans le code

Écrivez maintenant le code de navigation en citant la documentation que vous venez de lire.✓ Copié

→ Code + citations

Résultat : Code qui compile contre votre cible de déploiement.

Pièges

API disponibles uniquement en WWDC avant la sortie — Vérifiez get_platform_compatibility — les API bêta sont signalées

Combiner avec : github

Comment trouver la session WWDC qui explique une fonctionnalité

👤 Développeurs iOS adoptant une nouvelle fonctionnalité ⏱ ~10 min beginner

Quand l'utiliser : La documentation est succincte ; le contexte se trouve dans une présentation WWDC que vous n'avez pas regardée.

Déroulement

Recherchez WWDC

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

→ Liste des sessions
Récupérez la transcription + le code

get_wwdc_video_details pour le meilleur résultat. Extrayez les exemples de code.✓ Copié

→ Transcription + extraits de code

Résultat : Contexte + code fonctionnel sans regarder la vidéo.

Comment planifier une migration loin d'une API dépréciée

👤 Développeurs iOS maintenant des bases de code anciennes ⏱ ~10 min intermediate

Quand l'utiliser : Un avertissement indique 'dépréciée dans iOS 17' et vous voulez le remplacement.

Déroulement

Confirmez la dépréciation

get_platform_compatibility pour UIActivityIndicatorView.startAnimating.✓ Copié

→ Chronologie de disponibilité
Trouvez le remplacement recommandé

find_similar_apis — quel est l'équivalent SwiftUI ?✓ Copié

→ ProgressView() avec les arguments appropriés

Résultat : Plan de migration confiant avec des références.

Combiner avec : github

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

apple-docs + github

Fondez une PR de migration avec la documentation + références WWDC

Trouvez le remplacement SwiftUI pour notre utilisation de UIKit ActivityViewController, citez la documentation Apple et les sessions WWDC, et rédigez une PR de migration.✓ Copié

apple-docs + filesystem

Analysez le code local pour les API dépréciées et suggérez des remplaçants

Recherchez dans mon Sources/ toute API marquée comme dépréciée selon apple-docs-mcp ; produisez une liste de contrôle de migration.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
search_apple_docs	query: str, platform?: str	Trouvez n'importe quel API par nom ou sujet	gratuit
get_apple_doc_content	url_or_id	Lisez la page complète après la recherche	gratuit
list_technologies	category?, include_beta?: bool	Parcourez les frameworks	gratuit
search_framework_symbols	framework, query	Recherche de symboles limités au scope	gratuit
get_related_apis	symbol	Traversée de l'héritage/conformité	gratuit
get_platform_compatibility	symbol	Vérifiez la disponibilité	gratuit
find_similar_apis	symbol	Remplaçants des API dépréciées	gratuit
get_sample_code	topic?	Trouvez les projets d'exemple d'Apple	gratuit
search_wwdc_videos	query, years?: int[], topics?: str[]	Trouvez les présentations WWDC	gratuit
get_wwdc_video_details	session_id	Contexte complet de la session	gratuit

Coût et limites

Coût d'exécution

Quota d'API: developer.apple.com a des limites de débit raisonnables pour l'utilisation ; l'outil met en cache pour réduire les appels
Tokens par appel: Documentation : 500-3000 tokens. Transcriptions : jusqu'à 20k tokens pour les sessions longues
Monétaire: Gratuit
Astuce: Utilisez search_framework_symbols au lieu de search_apple_docs large pour économiser les tokens.

Sécurité

Permissions, secrets, portée

Portées minimales : Aucun — documentation publique uniquement

Stockage des identifiants : Aucun

Sortie de données : developer.apple.com + index hors ligne fourni

Ne jamais accorder : Rien à autoriser

La documentation Apple est révisée sans préavis ; les réponses Claude peuvent être en retard par rapport au site en direct de quelques jours.

Dépannage

Erreurs courantes et correctifs

La recherche ne retourne aucun résultat

La requête peut être trop spécifique — essayez le nom de classe seul ou utilisez list_technologies pour parcourir.

Le contenu de la documentation semble tronqué

Certaines pages sont volumineuses ; l'outil tronque — transmettez l'URL à get_apple_doc_content qui gère la pagination.

Vidéo WWDC non trouvée

Certaines anciennes sessions ne sont pas transcrites. Utilisez search_wwdc_videos avec le filtre years.

Alternatives

apple-docs-mcp vs autres

Alternative	Quand l'utiliser	Compromis
apple-docs via firecrawl	Vous voulez du scraping brut	Pas d'index WWDC, pas de structure
context7 MCP	Vous voulez la documentation générale des bibliothèques, pas spécifique à Apple	Couverture Apple plus faible

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills