Apple Docs MCP Server

通过您的AI编码助手搜索Apple的完整开发者文档。

功能概述

此工具将您的AI助手（如Cursor）连接到Apple的整个开发者文档库。无需手动浏览developer.apple.com，您的AI可以搜索Apple的文档并提供带有来源链接的精确答案。

完整的文档覆盖：

• 所有Apple平台： iOS、macOS、watchOS、tvOS 和 visionOS — 从早期版本到当前的iOS 26、macOS 26、watchOS 26、tvOS 26、visionOS 26
• WWDC会议记录 从2019年到2025年（包括最新的WWDC 2025，包含Liquid Glass API、Foundation Models Framework）
• 所有框架的完整API参考 — 包括遗留API、当前API以及最新添加的API
• 所有版本的代码示例 — 带有上下文和解释
• 人机界面指南（HIG） — Apple针对所有平台的完整设计指南

工作原理： 自然语言搜索 — 使用普通英语提问。例如，输入“如何实现按钮按下的动画效果”或“iOS导航的最佳实践”，即可获得相关答案。搜索理解概念和上下文，而不仅仅是精确关键词匹配。

数据库： 超过16,253份文档，涵盖完整内容。

安装

npm install apple-docs-mcp-server

文档数据库（260MB）会在安装过程中自动下载。

使用Cursor设置

1. 在项目根目录创建.cursor/mcp.json：

{
  "schemaVersion": 1,
  "mcpServers": {
    "apple_docs": {
      "command": "/绝对路径/to/node_modules/apple-docs-mcp-server/run-mcp-safe.sh",
      "env": {
        "OPENAI_API_KEY": "在这里填写你的openai_api_key"
      },
      "autoStart": true,
      "alwaysAllow": ["search_docs", "get_doc", "get_code_examples", "get_stats"],
      "timeout": 30000
    }
  }
}

2. 查找正确的路径：

# 在您的项目目录中：
echo "$(pwd)/node_modules/apple-docs-mcp-server/run-mcp-safe.sh"

3. 完全重启Cursor

如何使用

向您的AI助手询问有关Apple开发的问题：

API及代码示例（任意版本）：

• “给我看一些SwiftUI动画代码示例”
• “如何使用Core Data与CloudKit同步？”
• “Foundation Models Framework的设置和使用示例”
• “iOS 26中UIKit的新特性是什么？”

设计及界面指南：

• “Apple在iOS应用中的按钮设计指南”
• “iPad上导航模式的最佳实践”
• “应用程序图标无障碍需求”

自然语言查询：

• “如何在SwiftUI中处理内存管理？”
• “如何在我的应用中实现Liquid Glass效果？”
• “支持暗模式的最佳方法”

您的AI会搜索Apple的完整文档，并提供带有来源链接的答案。当文档包含代码示例时，您的AI可以提取这些示例并附带完整的上下文和解释。

主要优势

全面的历史和当前覆盖： 这是最全面的Apple开发者文档集合。Apple发布的一切，从遗留API到前沿框架，所有2019年至2025年的WWDC会议，以及完整的人机界面指南，都在一个可搜索的数据库中。

自然语言搜索： 使用普通英语提问。无需知道确切的API名称或关键词。搜索理解您想要完成的任务。

实际工作的代码示例： 不仅仅是文档文本，而是带有解释和上下文的实际Swift代码，适用于所有平台版本。

快速且本地化： 所有文档都在您的机器上进行处理。搜索结果即时出现，无需调用API。

从遗留到最新： 无论您需要iOS 13的遗留API还是iOS 26的最新特性，如Liquid Glass API，这里都有完整的WWDC 2025内容。

故障排除

Cursor显示“没有工具”：

• 在.cursor/mcp.json中使用绝对路径
• 确保run-mcp-safe.sh是可执行的：chmod +x run-mcp-safe.sh
• 完全重启Cursor

OpenAI API密钥错误：

• 将您的API密钥放在mcp.json的env部分（推荐）
• 检查API密钥格式：应以sk-proj-或sk-开头

数据库错误：

• 如果数据库丢失，请重新安装：npm uninstall apple-docs-mcp-server && npm install apple-docs-mcp-server
• 检查数据库文件是否存在：ls -lh node_modules/apple-docs-mcp-server/embeddings.db

可用工具

• search_docs：搜索所有Apple文档和设计指南
• get_doc：根据ID获取完整文档内容
• get_code_examples：从文档中提取带有解释的工作Swift代码示例
• get_stats：数据库统计信息

要求

• Node.js 18或更高版本
• OpenAI API密钥
• Cursor或兼容的MCP客户端

许可证

MIT许可证 — 详情见LICENSE文件。

---

这是一个非官方工具，用于访问Apple开发者文档。与Apple Inc.无关联。