/ ディレクトリ / プレイグラウンド / apple-docs-mcp
● コミュニティ kimsungwhee ⚡ 即起動

apple-docs-mcp

作者 kimsungwhee · kimsungwhee/apple-docs-mcp

チャットからApple開発者ドキュメント、WWDCビデオトランスクリプト(2014〜2025年)、サンプルコードを検索できます。根拠に基づいたiOS/macOS/Swiftの回答を得られます。

kimsungwhee/apple-docs-mcpは、developer.apple.comのコンテンツと1,260以上のWWDCビデオトランスクリプトにアクセスできる15のツールを提供します。エージェントがUIKit/SwiftUI APIをハルシネーションするのを防ぐのに最適です。

なぜ使うのか

主な機能

ライブデモ

実際の動作

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

エージェントがSwiftUI APIをハルシネーションするのを防ぐ方法

👤 Claude/Cursorを使うiOS開発者 ⏱ ~10 min beginner

使うタイミング: エージェントがターゲットのiOSバージョンに存在しないAPIを提案する場合に使用します。

前提条件
  • Node 18+ — nvm install 20
フロー
  1. インストール
    次のコマンドでインストール: npx -y @kimsungwhee/apple-docs-mcp@latest(またはMCPコンフィグに追加)。✓ コピーしました
    → ツールが表示される
  2. 質問の根拠を確認する
    search_apple_docsでnavigationDestinationを検索し、get_platform_compatibilityでiOS 16+で利用可能か確認してください。✓ コピーしました
    → 公式ドキュメントのエントリ+最小デプロイメントターゲット
  3. コードに引用する
    読んだドキュメントを引用しながらナビゲーションコードを書いてください。✓ コピーしました
    → コード+引用

結果: デプロイメントターゲットに対してコンパイルできるコード。

注意点
  • リリース前のWWDC限定APIが表示される — get_platform_compatibilityで確認 — ベータAPIにはフラグが付きます
組み合わせ: github

機能を解説しているWWDCセッションを見つける方法

👤 新機能を導入するiOS開発者 ⏱ ~10 min beginner

使うタイミング: ドキュメントが簡潔すぎて、詳しい解説が未視聴のWWDCトークにある場合に使用します。

フロー
  1. WWDCを検索
    search_wwdc_videos 'Observation framework Swift macro' years=[2023,2024]。✓ コピーしました
    → セッション一覧
  2. トランスクリプトとコードを取得
    上位の結果に対してget_wwdc_video_detailsを実行し、コードサンプルを抽出してください。✓ コピーしました
    → トランスクリプト+コードスニペット

結果: ビデオを視聴せずにコンテキストと動作するコードを取得できます。

非推奨APIからの移行を計画する方法

👤 古いコードベースを保守するiOS開発者 ⏱ ~10 min intermediate

使うタイミング: 「iOS 17で非推奨」という警告が出て、代替APIを知りたい場合に使用します。

フロー
  1. 非推奨を確認
    UIActivityIndicatorView.startAnimatingに対してget_platform_compatibilityを実行。✓ コピーしました
    → 利用可能バージョンのタイムライン
  2. 推奨される代替を見つける
    find_similar_apis — SwiftUIでの同等のAPIは何ですか?✓ コピーしました
    → 適切な引数を持つProgressView()

結果: リファレンス付きの確実な移行プラン。

組み合わせ: github

組み合わせ

他のMCPと組み合わせて10倍の力を

apple-docs + github

ドキュメントとWWDCリファレンスに基づいた移行PRの作成

UIKitのActivityViewControllerの使用箇所に対するSwiftUIの代替を見つけ、AppleドキュメントとWWDCセッションを引用して移行PRのドラフトを作成してください。✓ コピーしました
apple-docs + filesystem

ローカルコードの非推奨APIをスキャンして代替を提案

Sources/内でapple-docs-mcpによると非推奨となっているAPIをgrepし、移行チェックリストを作成してください。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
search_apple_docs query: str, platform?: str 名前またはトピックでAPIを検索 free
get_apple_doc_content url_or_id 検索後にページ全体を読む free
list_technologies category?, include_beta?: bool フレームワークを一覧表示 free
search_framework_symbols framework, query スコープ指定のシンボル検索 free
get_related_apis symbol 継承・準拠関係の探索 free
get_platform_compatibility symbol 利用可能バージョンの確認 free
find_similar_apis symbol 非推奨APIの代替を検索 free
get_sample_code topic? Appleのサンプルプロジェクトを検索 free
search_wwdc_videos query, years?: int[], topics?: str[] WWDCトークを検索 free
get_wwdc_video_details session_id セッションの完全なコンテキストを取得 free

コストと制限

運用コスト

APIクォータ
developer.apple.comには適正利用のレート制限があります。ツールはキャッシュにより呼び出し回数を削減します
呼び出しあたりのトークン
ドキュメント: 500〜3000トークン。トランスクリプト: 長いセッションで最大20kトークン
金額
無料
ヒント
トークンを節約するには、広範なsearch_apple_docsの代わりにsearch_framework_symbolsを使用してください。

セキュリティ

権限、シークレット、影響範囲

最小スコープ: None — public docs only
認証情報の保管: 不要
データ送信先: developer.apple.com+バンドルされたオフラインインデックス
絶対に付与しない: Nothing to grant

トラブルシューティング

よくあるエラーと対処法

Search returns no results(検索結果なし)

クエリが具体的すぎる可能性があります。クラス名のみで試すか、list_technologiesでブラウズしてください。

Doc content looks truncated(ドキュメントの内容が切り詰められている)

一部のページは大きいためツールが切り詰めます。ページネーションを処理するget_apple_doc_contentにURLを渡してください。

WWDC video not found(WWDCビデオが見つからない)

古いセッションの一部はトランスクリプトがありません。yearsフィルター付きでsearch_wwdc_videosを使用してください。

代替案

apple-docs-mcp 他との比較

代替案代わりに使う場面トレードオフ
apple-docs via firecrawl生のスクレイピングが必要な場合WWDCインデックスなし、構造化なし
context7 MCPApple固有ではなく汎用的なライブラリドキュメントが必要な場合Appleのカバレッジが弱い

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る