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 использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

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

Щёлкните значок MCP Servers на боковой панели Cline, затем "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 использует массив объектов серверов, а не map.

~/.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 — эффект x10

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

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills