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许可证。