Apple Deep Docs MCP

通过模型上下文协议访问隐藏的Xcode文档和Apple开发者资源。

概述

现代Apple文档使用DocC渲染系统，该系统需要JavaScript动态加载内容，使得某些LLM无法访问。此MCP服务器绕过了这一限制，提供了对Apple开发文档生态系统的全面访问，包括：

• 隐藏的Xcode文档：搜索Xcode.app中的AdditionalDocumentation文件夹，包含高级SwiftUI模式、iOS 26+的Liquid Glass设计指南以及框架特定的实现细节，这些内容在Apple的公共开发者网站上不可用。
• Apple开发者API：从developer.apple.com获取并解析结构化文档。
• Swift演进提案：搜索500多个提案以了解语言特性的“为什么”。
• Swift开源仓库：搜索Apple/SwiftLang的所有GitHub仓库以获取实现示例。
• WWDC会议笔记：访问社区整理的WWDC会议总结，用于性能优化和架构模式。
• 人机交互指南：搜索人机交互指南。

要求

• Python 3.10+
• 安装了Xcode（用于本地文档特性）

安装

1. 克隆这个仓库：

git clone https://github.com/Ahrentlov/appledeepdoc-mcp.git
cd appledeepdoc-mcp

2. 设置Python环境：

# 创建虚拟环境
python3 -m venv venv

# 安装依赖
./venv/bin/pip install fastmcp

配置

Claude Code

对于Claude Code，你需要使用以下CLI命令添加MCP服务器：

确保run.sh可执行

chmod +x /path/to/appledeepdoc-mcp/run.sh

将MCP服务器添加到本地Claude Code项目配置中

导航到你将激活Claude Code的项目文件夹，然后运行以下命令来注册MCP服务器：

claude mcp add --transport stdio apple-deep-docs /path/to/appledeepdoc-mcp/run.sh

验证是否已添加

claude mcp list

现在当你在这个文件夹中激活claude时，它将具有可用的MCP服务器。

Claude Desktop

添加到你的Claude Desktop配置文件中：

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

GPT-Codex

添加到~/.codex/config.toml：

[mcp_servers.apple-deep-docs]
"command" = "/path/to/appledeepdoc-mcp/run.sh"

将/path/to/appledeepdoc-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开发者网站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开发者资源

• fetch_apple_documentation - 从developer.apple.com获取结构化文档
• search_apple_online - 搜索本地和在线Apple文档
• get_framework_info - 获取任何框架的直接文档URL

Swift演进

• search_swift_evolution - 搜索Swift演进提案
• get_swift_evolution_proposal - 获取特定提案的详细信息

GitHub资源

• search_swift_repos - 搜索Apple/SwiftLang的所有GitHub仓库
• fetch_github_file - 从GitHub仓库获取源代码

WWDC资源

• search_wwdc_notes - 搜索WWDC会议笔记和记录
• get_wwdc_session - 根据会议ID获取WWDC会议URL

人机交互指南

• search_human_interface_guidelines - 搜索Apple的HIG以查找设计模式和最佳实践
• list_human_interface_guidelines_platforms - 列出所有可用平台及其HIG链接

环境变量

• XCODE_DOC_PATH: 覆盖默认的Xcode文档搜索路径

贡献

该项目按现状提供。虽然我已经尽力使其成为访问Apple更深层次文档的有效工具，但仍可能存在粗糙边缘或改进空间。

欢迎提出建议和拉取请求！如果你有新功能的想法、发现错误或希望贡献改进，请随时打开问题或提交PR。

许可证

MIT