Apple Docs 2.0 MCP

English · 日本語 · 한국어 · 简体中文

Apple Docs 2.0 MCP

Appleの開発者向けドキュメント、デザインガイドライン、WWDCセッションに対応する1つのMCPです。

エージェントと一緒に次のiOSアプリを開発していますか？ まずApple公式ドキュメントを読ませましょう。書き直しや作業の中断を減らせます。

クイックスタート · 新機能 · インストール · 使用例 · ツール · アーキテクチャ · 開発

npx -y apple-docs-2.0-mcp

Model Context Protocolを通じて、AIアシスタントからApple Developer Documentationを利用できます。APIリファレンス、記事、サンプルコード、チュートリアル、Human Interface Guidelines、App Store Connect Help、ウェブサービスAPI（App Store Connect API、App Store Server APIなど）、および文字起こしとコード付きの1,700件のWWDCセッションに、Claude、Cursor、VS CodeなどのMCPクライアントからアクセスできます。

Apple Docs 2.0 MCPは、kimsungwheeによるApple Docs MCPのフォークで、機能の追加、修正、新しいツールによって改善されています。

🚀 クイックスタート

Claude Desktop（推奨）

Claude Desktopの設定に以下を追加してください。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

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

注：古いバージョンが使用される場合は、@latestを追加して最新バージョンを指定してください。

"args": ["-y", "apple-docs-2.0-mcp@latest"]

Claude Desktopを再起動し、Apple APIについて質問してください！

Claude Code

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

エージェントに質問する

Look up NavigationStack in Apple's docs, then show me the WWDC code that uses it.

🆕 2.0の新機能

Apple Docs 2.0 MCPは、Apple Docs MCP 1.0.26のすべての機能を維持しつつ、動作しなくなった機能や不完全な結果を返していた機能を修正しました。これにより、アシスタントは推測ではなく、Apple公式ドキュメントに基づいて回答できます。

🔍 検索結果が返ってくる検索

search_apple_docsを修正しました。Appleのウェブサイトと同じ検索サービスを使用するため、developer.apple.comで見られるものと同じ検索結果をアシスタントが取得できます。APIリファレンス、記事、サンプルコード、デザインガイドライン、App Store Connect Help、WWDCビデオが対象です。元のバージョンでは、Appleが検索ページを変更したため、検索結果が空になっていました。

API、デザインガイドライン、App Storeの手続きについて質問すると、アシスタントはまず検索し、見つかったページを読み込みます。

🗺️ 名前から任意のページを検索

新しいツールsearch_docs_mapを使うと、336,723ページから任意のページを名前または名前の一部でオフライン検索できます。

• APIシンボル：型、メソッド、プロパティ、列挙型のケース、マクロ
• 記事とサンプルコード
• Info.plistとエンタイトルメントのキー
• App Store Connect APIなどのウェブサービスのエンドポイント
• Human Interface GuidelinesとApp Store Connect Helpのページ

コードやエラーメッセージから名前がすでに分かっている場合に使うと、そのページを直接開けます。

📄 完全なドキュメントページ

Appleのサイトと同様に、ページ全体を取得できます。各メソッドとプロパティの完全なシグネチャ （var view: UIView!。viewだけではありません）、型の継承元と準拠先、関連するAPI、対応するOSのバージョンも含まれます。2.0では、Human Interface Guidelines、チュートリアル、App Store Connect Help、パラメーターとレスポンスを含むApp Store Connect APIのエンドポイントも読み取れます。

API、ガイドライン、App Store Connectのトピックについて質問すると、アシスタントは回答またはコードを作成する前に、ページ全体を読み取ります。

🎥 WWDC 2014–2026、コード付き

WWDC26を含む1,700のセッションが組み込まれており、オフラインでも利用できます。1,416セッションのトランスクリプトがあり、各段落には開始時刻が記されています。480セッションにはチャプターがあり、715セッションには、動画内で表示される時刻が記されたコードサンプルがあります。セッションはAppleのウェブサイトと同じトピック別に分類されています。

新しいAPIの仕組みを尋ねると、アシスタントは、そのAPIが初めて紹介されたWWDCセッションをコードとともに引用できます。

📋 完全なフレームワークリスト

元の技術リストは200件で止まっていたため、カテゴリ全体（Graphics and Games、Media、System、Web）が表示されず、シンボル検索にはリンク切れの見出しが混在していました。2.0ではすべてを一覧表示し、ベータ版のフレームワークに印を付け、分野からフレームワークを検索できます。「機械学習」と検索すると、Core ML、Create ML、Foundation Models、Visionなどが見つかります。

機械学習やオーディオなど、あるタスクに適したフレームワークを尋ねると、アシスタントは完全なリストを比較します。

🛠️ 安定して動作し続ける設計

依存関係を最新に保ち、通常のブラウザーのように見えるリクエストを順番に送信します（リクエストが速すぎるとAppleは空の検索結果を返します）。リクエストが失敗した場合は自動的に再試行し、自動テストは207件あります。元のREADMEにある63個の使用例は、すべてエラーなく実行できます。

セットアップは不要です。APIキーもアカウントも必要ありません。

✨ 機能

• 🔍 検索：Appleのドキュメント、デザインガイドライン、サンプルコード、App Store Connect Help、WWDCセッションをまとめて検索することも、それぞれ個別に検索することもできます
• 🗺️ ドキュメントマップ：ネットワークリクエストなしで、メソッド名やプロパティ名も含め、タイトルから任意のページを見つけられます
• 📚 ドキュメントページ：SwiftおよびObjective-CのAPI、記事、チュートリアル、ウェブサービスのリファレンスをMarkdown形式で表示します
• 🎨 Human Interface Guidelines：すべてのHIGページを検索して閲覧できます
• 🏪 App Store Connect Help：製品ページの項目、審査、TestFlight、価格設定
• 🔧 フレームワークのシンボル：ワイルドカードを使って、フレームワークのクラス、構造体、プロトコル、メンバーを閲覧できます
• 🔗 APIの関連情報：関連するAPI、類似するAPI、参照されているAPI、非推奨APIの置き換え先
• 📊 プラットフォーム互換性：各プラットフォームでAPIが導入されたバージョンと非推奨になったバージョン
• 📋 テクノロジーカタログ：Appleのすべてのフレームワークとテクノロジーをカテゴリ別に掲載し、ベータ版には印を付けています
• 📰 ドキュメントの更新情報：リリースノート、フレームワークの更新情報、WWDCの「What's new」ページ
• 🎯 テクノロジーの概要：アプリのデザイン、ゲーム、AIと機械学習、データなどに関するAppleのガイド
• 💻 サンプルコード：Appleの検索順位順に並べたすべてのサンプルプロジェクト、およびフレームワーク別またはセクション別のSample Code Library。概要とダウンロードリンクも含まれます
• 🎥 WWDCライブラリ：2014年から2026年までの1,700のセッションを収録。トランスクリプト、時刻付きコード例、リソース、関連セッションをオフラインで利用できます

📦 インストール

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

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

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

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

💬 使用例

🔍 検索

"Search for SwiftUI animations"
"Find withAnimation API documentation"
"Search the Human Interface Guidelines for tab bars"
"Search App Store Connect Help for TestFlight external testers"
"Find sample code for Core Data"

🗺️ ドキュメントマップ

"Find the page for accessibilityInputLabels"
"Which SwiftUI pages have gauge in their title?"
"Find the App Store Connect API endpoint to create an auto-renewable subscription"

📚 ドキュメントへのアクセス

"Get detailed information about the SwiftUI framework"
"Show me withAnimation API with related APIs"
"Show me NSManagedObjectContext documentation"
"Read the Human Interface Guidelines page on tab bars"
"Show the steps of the SwiftUI tutorial"

🔧 フレームワークの調査

"Show me SwiftUI views"
"List all UIKit delegate protocols"
"Get WeatherKit API hierarchy"
"Explore Core ML model loading APIs"

🔗 API の検索

"Find APIs related to UIViewController"
"Discover alternatives to UIAlertView"
"Get all references from SwiftData documentation"
"Get platform compatibility for SwiftData"

📋 テクノロジー、アップデート、概要

"What machine learning frameworks are available?"
"Which technologies are in beta?"
"What's new in SwiftUI?"
"Show me release notes for Xcode"
"Get data management technology overviews"

💻 サンプルコード

"Show SwiftUI sample code projects"
"Find sample code for machine learning"
"Get the Food Truck sample"

🎥 WWDC

"Search WWDC videos about SwiftUI"
"Find WWDC sessions on machine learning"
"Show me WWDC 2026 videos"
"Search WWDC transcripts for async/await"
"Show me the transcript for WWDC23 Meet SwiftData"
"Get code examples from WWDC sessions that use SwiftData"
"Find sessions related to WWDC23 Meet SwiftData"
"List all WWDC topics"

🛠️ 利用可能なツール

ドキュメント用ツールは developer.apple.com からデータを取得します。WWDC 用ツールは同梱データを読み込み、search_docs_map はドキュメントマップを読み込みます。いずれもネットワークリクエストは行いません。

🏗️ アーキテクチャ

Apple-Docs-2.0-MCP/
├── src/
│   ├── index.ts                    # MCP server and its search guide
│   ├── tools/
│   │   ├── handlers.ts             # Tool registration
│   │   ├── search-api.ts           # Apple's search API
│   │   ├── search-docs-map.ts      # Docs map search
│   │   ├── doc-fetcher.ts          # Pages from Swift-DocC JSON
│   │   ├── doc-formatter.ts        # Markdown rendering
│   │   ├── help-pages.ts           # App Store Connect Help (jsdom, turndown)
│   │   ├── list-technologies.ts    # Technology catalog
│   │   ├── search-framework-symbols.ts
│   │   ├── get-related-apis.ts, find-similar-apis.ts, resolve-references-batch.ts, get-platform-compatibility.ts
│   │   ├── get-documentation-updates.ts, get-technology-overviews.ts, get-sample-code.ts
│   │   └── wwdc/                   # WWDC tools and the session, topic and year extractors
│   ├── types/                      # Generated from Swift-DocC's specs and captured responses
│   └── utils/                      # HTTP client, caches, constants, URL conversion
├── scripts/
│   ├── add-wwdc-year.ts            # Adds or refreshes a WWDC year in data/wwdc
│   ├── build-docs-map.ts           # Builds api-map/apple-docs-map.tsv
│   └── capture-responses.ts        # Captures responses to type them
├── data/wwdc/                      # The bundled WWDC sessions
├── api-map/                        # The docs map, Apple's search API (OpenAPI) and captured responses
└── tests/                          # Vitest

🌐 リクエストとキャッシュ

すべてのリクエストは、Safari のヘッダーを使用する単一の HTTP クライアント fetch を経由します。リクエストは最大で毎分 100 件で、検索は一度に 1 件ずつ、15 秒間隔で行います。Apple は間隔が短いと結果なしで応答するためです。各試行には 2 分のタイムアウトが設定されており、ネットワークエラー、タイムアウト、5xx 応答の場合は、最大 3 回までバックオフしながら再試行します。

Apple の JSON は、Apple から届いたままの形式で URL ごとにキャッシュされ、すべてのツールで共有されます。別のツールが直前に読み込んだページは再ダウンロードされず、同じ URL への同時リクエストは 1 回のダウンロードを共有します。

📦 WWDC データ

WWDC セッションは data/wwdc/ に同梱されているため、WWDC ツールはオフラインでもレート制限なしで動作します。

• 📹 2014 年から 2026 年までの 1,700 件のセッション。そのうち 1,416 件にはトランスクリプトがあり、各段落にタイムスタンプが付いています（Apple が掲載を終了した 6 件を除く）。715 件にはコード例があり、480 件にはチャプターがあります。
• 🏷️ Apple のトピックページから取得した 19 件のトピック
• 💾 48 MB の JSON

npx tsx scripts/add-wwdc-year.ts <year> は、Apple のページから指定した年のデータを追加または更新します。Apple が掲載を終了したセッションの保存済みデータは保持されます。

🗺️ ドキュメントマップ

api-map/apple-docs-map.tsv には、Apple のナビゲーターインデックス、Human Interface Guidelines、App Store Connect Help のナビゲーションから取得した 336,723 件のページが記載されています（URL、タイトル、種類、テクノロジー、グループ、ツリー、テクノロジー ID、ベータ版または非推奨のマーク、およびページをサイドバーに掲載しているほかのテクノロジー）。search_docs_map は使用中、マップをメモリ上に保持します。npx tsx scripts/build-docs-map.ts api-map/apple-docs-map.tsv を実行すると、約 10 分で再構築できます。

🧪 開発

git clone https://github.com/mishafyi/Apple-Docs-2.0-MCP.git
cd Apple-Docs-2.0-MCP
npx pnpm@10 install
npx pnpm@10 run build          # tsc into dist/

# Run your build in Claude Code in place of the npm package
claude mcp add apple-docs -- node "$PWD/dist/index.js"

# Checks: types (server and scripts), lint and tests
npx tsc --noEmit && npx tsc -p scripts && npx eslint src scripts && npx vitest run

# Call the built server without an MCP client
npx -y @modelcontextprotocol/inspector --cli node dist/index.js --method tools/call \
  --tool-name search_apple_docs --tool-args-json '{"query":"tab bars","type":"design"}'

# Regenerate the types of Apple's JSON
npm run types:docc             # from Swift-DocC's RenderNode and RenderIndex specs
npm run types:captured         # from captured responses (quicktype)

ビルド後、MCP クライアントでサーバーを再起動するか、再接続してください。

🙏 クレジット

Apple Docs 2.0 MCP は、kimsungwhee による Apple Docs MCP を基盤としています。ツール、WWDC データ、構成はこのプロジェクトを出発点としています。

🤝 貢献

貢献を歓迎します。

1. リポジトリを フォーク します
2. 機能ブランチを 作成 します：git checkout -b feature/amazing-feature
3. 変更を コミット します：git commit -m 'Add amazing feature'
4. ブランチに プッシュ します：git push origin feature/amazing-feature
5. プルリクエストを 作成 します

📄 ライセンス

元のプロジェクトと同じ MIT ライセンスです。詳細は LICENSE をご覧ください。

⚠️ 免責事項

このプロジェクトは Apple Inc. と提携しておらず、同社の推奨も受けていません。教育および開発を目的として、Apple が公開している開発者向けドキュメントを読み込みます。