apple-docs-mcp
Xcode'un diskteki indeksinden Apple Developer Documentation arayan MCP sunucusu ve CLI — tamamen çevrimdışı, ağ çağrısı yok.
Neden var
Kodlama ajanları Apple API'lerini, kurulu SDK'nın gerisinde kalan eğitim verisinden hatırlıyor. Xcode dokümantasyonun yerel bir kopyasını zaten indiriyor ama metin durduğu yerde okunamıyor: index.json hiç metin içermeyen gezinme düğümleri tutuyor, cache.db başlığı LZ4, LZFSE, zlib, LZMA ve LZBITMAP'in hiçbiriyle açılmayan sıkıştırılmış blob'lar saklıyor, documentation-db/index.sql ise Xcode'un kendi anlamsal araması için bir vektör deposu, metin değil. Bu sunucu gerçek metni açıyor: imzalar, kullanılabilirlik ve kod örnekleri.
Ne yapar
- search_docs: anlama göre arama; sonuç başına tam metin, kod örneği, uri ve skor
- list_frameworks: yerel indeksteki tüm framework'ler (~395), çevrimdışı, onay gerektirmez
- doc_status: aramanın şu an kullanılabilir olup olmadığını ve değilse nedenini bildirir
- --json çıktısı ve hata sınıfı başına ayrı çıkış kodu veren CLI
Teknoloji
- Python
- uv
- Model Context Protocol
- Xcode mcpbridge
Kullanım
claude mcp add apple-docs --scope user -- \
uv run --quiet --project /path/to/apple-docs-mcp apple-docs-mcp
apple-docs search "SwiftData model inheritance" --framework SwiftData
apple-docs search "AVAudioSession category" --json
apple-docs frameworks
apple-docs statusMühendislik notları
Sarmaladığı köprünün ölçülen davranışı: sorgu başına tam içerikli ve kod örnekli 19-20 doküman, medyan yaklaşık 0.4 saniye gecikme ve sıfır bayt ağ trafiği. Zahmetli kısım gizlenmiyor, yazılı: search_docs mcpbridge'i sürdüğü için Xcode onaylanmış bir çalışma alanıyla açık olmalı, onay kullanıcı başına değil süreç başına veriliyor ve 24 saat sonra düşüyor. Her hata, çözümüyle birlikte tipli dönüyor; araç bir sorunu bildirmek için asla boş liste döndürmüyor, çünkü boş sonuçla "bu API yok" ayırt edilemez — projenin ortadan kaldırmak için yazıldığı karışıklık tam olarak bu. Birim testleri Xcode istemiyor, entegrasyon testleri köprü yoksa ya da onaysızsa kendilerini atlıyor.
Sınırlar
- macOS ve kurulu Xcode gerektirir.
- search_docs onaylanmış bir Xcode çalışma alanı ister; onay süreç başına ve 24 saat sonra düşer.