Appledeepdoc MCP

🚀 Apple Deep Docs MCP

Model Context Protocolを介して、隠されたXcodeドキュメントやApple開発者リソースにアクセスできます。

🚀 クイックスタート

このMCPサーバーを使用することで、Appleの開発ドキュメントエコシステムに包括的にアクセスできます。

✨ 主な機能

このMCPサーバーは、Appleの開発ドキュメントエコシステムへの包括的なアクセスを提供します。以下が含まれます：

• 隠されたXcodeドキュメント：Xcode.app内のAdditionalDocumentationフォルダを検索します。このフォルダには、高度なSwiftUIパターン、iOS 26+向けのLiquid Glassデザインガイド、Appleの公開開発者サイトでは入手できないフレームワーク固有の実装詳細が含まれています。
• Apple Developer API：developer.apple.comから構造化ドキュメントを取得して解析します。
• Swift Evolution Proposals：500以上の提案を検索して、言語機能の背景にある「理由」を理解します。
• Swift Open Source Repositories：すべてのApple/SwiftLang GitHubリポジトリを検索して、実装例を見つけます。
• WWDC Session Notes：パフォーマンス最適化やアーキテクチャパターンに関するコミュニティが作成したWWDCセッションの要約にアクセスします。

📦 インストール

必要条件

• Python 3.10以上
• Xcodeのインストール（ローカルドキュメント機能のため）

インストール手順

1. このリポジトリをクローンします：

git clone https://github.com/yourusername/appledeepdocs-mcp.git
cd appledeepdocs-mcp

2. Python環境をセットアップします：

# 仮想環境を作成
python3 -m venv venv

# 依存関係をインストール
./venv/bin/pip install fastmcp

📚 ドキュメント

設定

Claude Desktopの設定ファイルに以下を追加します：

{
  "mcpServers": {
    "apple-deep-docs": {
      "command": "/path/to/appledeepdocs-mcp/run.sh"
    }
  }
}

/path/to/appledeepdocs-mcpをこのリポジトリをクローンした完全なパスに置き換えてください。run.shスクリプトは自動的に仮想環境を処理します。

設定ファイルの場所：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

設定を更新した後、Claude Desktopを再起動してMCPサーバーを読み込みます。

プロジェクト構造

├── main.py               # MCPサーバーのエントリーポイント
├── config.py            # 設定とXcodeパスの検出
├── tools.py             # MCPツールの定義と入力検証
├── docs/                # ドキュメントアクセスモジュール
│   ├── local_docs.py    # Xcodeの隠されたローカルドキュメント
│   └── apple_docs.py    # Apple DeveloperウェブサイトAPIへのアクセス
├── evolution/           # Swift言語の進化
│   └── swift_evolution.py
├── repos/               # GitHubリポジトリの検索
│   └── swift_repos.py
├── suggestions/         # インテリジェントな提案システム
│   └── suggestions.py   # 集中的な提案エンジン
├── wwdc/                # WWDCセッションリソース
│   └── wwdc_notes.py
└── pyproject.toml       # パッケージ構成

利用可能なツール

ローカルドキュメント

• search_docs - Xcodeの隠されたドキュメントを検索します。
• get_document - 特定のドキュメントの完全な内容を取得します。
• list_documents - 利用可能なすべてのドキュメントファイルをリストします。
• get_xcode_versions - ドキュメントがあるインストール済みのXcodeバージョンを取得します。

Apple Developerリソース

• fetch_apple_documentation - developer.apple.comから構造化ドキュメントを取得します。
• search_apple_online - ローカルとオンラインの両方のAppleドキュメントを検索します。
• get_framework_info - 任意のフレームワークの直接のドキュメントURLを取得します。

Swift Evolution

• search_swift_evolution - Swift Evolutionの提案を検索します。
• get_swift_evolution_proposal - 特定の提案の詳細を取得します。

GitHubリソース

• search_swift_repos - すべてのApple/SwiftLangリポジトリを検索します。
• fetch_github_file - GitHubリポジトリからソースコードを取得します。

WWDCリソース

• search_wwdc_notes - WWDCセッションのノートと文字起こしを検索します。
• get_wwdc_session - セッションIDからWWDCセッションのURLを取得します。

環境変数

• XCODE_DOC_PATH: デフォルトのXcodeドキュメント検索パスを上書きします。

📄 ライセンス

MIT