Appledeepdoc MCP

🚀 Apple Deep Docs MCP

通過模型上下文協議（Model Context Protocol）訪問隱藏的Xcode文檔和蘋果開發者資源。本項目提供了全面的蘋果開發文檔生態系統訪問途徑，幫助開發者更高效地獲取所需信息。

🚀 快速開始

本MCP服務器提供了對蘋果開發文檔生態系統的全面訪問，具體包括：

• 隱藏的Xcode文檔：搜索Xcode.app內的AdditionalDocumentation文件夾，其中包含高級SwiftUI模式、iOS 26+的液態玻璃設計指南，以及蘋果公共開發者網站上未提供的特定框架實現細節。
• 蘋果開發者API：從developer.apple.com獲取並解析結構化文檔。
• Swift進化提案：搜索500多個提案，以瞭解語言特性背後的“原因”。
• Swift開源倉庫：在所有蘋果/SwiftLang GitHub倉庫中搜索實現示例。
• 全球開發者大會（WWDC）會議記錄：訪問社區整理的WWDC會議摘要，以獲取性能優化和架構模式方面的信息。

✨ 主要特性

• 全面覆蓋蘋果開發文檔生態系統，包括隱藏文檔、開發者API、Swift進化提案、開源倉庫和WWDC會議記錄。
• 提供多種工具，方便開發者搜索和獲取所需信息。
• 可通過環境變量自定義Xcode文檔搜索路徑。

📦 安裝指南

環境要求

• 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    # 蘋果開發者網站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版本

蘋果開發者資源

• fetch_apple_documentation - 從developer.apple.com獲取結構化文檔
• search_apple_online - 搜索本地和在線的蘋果文檔
• get_framework_info - 獲取任何框架的直接文檔URL

Swift進化

• search_swift_evolution - 搜索Swift進化提案
• get_swift_evolution_proposal - 獲取特定提案的詳細信息

GitHub資源

• search_swift_repos - 在所有蘋果/SwiftLang倉庫中搜索
• fetch_github_file - 從GitHub倉庫獲取源代碼

WWDC資源

• search_wwdc_notes - 搜索WWDC會議記錄和轉錄內容
• get_wwdc_session - 根據會議ID獲取WWDC會議URL

環境變量

• XCODE_DOC_PATH：覆蓋默認的Xcode文檔搜索路徑

📄 許可證

本項目採用MIT許可證。