苹果文档MCP服务器
](https://www.npmjs.com/package/apple-docs-mcp-server)  ](https://nodejs.org/)
使用您的AI编码助手搜索Apple的完整开发人员文档。
这有什么作用
此工具将您的AI助手（如Cursor）连接到Apple的整个开发人员文档。你的人工智能可以搜索苹果的文档，并通过源链接提供精确的答案，而不是手动浏览developer.apple.com。
完整的文件覆盖范围：
- 所有苹果平台： 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导航的最佳实践”，并获得相关答案。搜索理解概念和上下文，而不仅仅是精确的关键字匹配。
数据库： 16253+份内容完整的文件。
安装
npm install apple-docs-mcp-server文档数据库（260MB）在安装过程中会自动下载。
使用光标进行设置
1.创建 .cursor/mcp.json 在项目根目录中：
{
"schemaVersion": 1,
"mcpServers": {
"apple_docs": {
"command": "/absolute/path/to/node_modules/apple-docs-mcp-server/run-mcp-safe.sh",
"env": {
"OPENAI_API_KEY": "your_openai_api_key_here"
},
"autoStart": true,
"alwaysAllow": ["search_docs", "get_doc", "get_code_examples", "get_stats"],
"timeout": 30000
}
}
}2.找到正确的道路：
# In your project directory:
echo "$(pwd)/node_modules/apple-docs-mcp-server/run-mcp-safe.sh"3.完全重新启动Cursor
如何使用
向您的AI助手询问有关Apple开发的问题：
API代码示例（任何版本）：
- “显示SwiftUI动画代码示例”
- “如何将核心数据与CloudKit同步？”
- “基础模型框架设置和使用示例”
- “iOS 26的UIKit有什么新功能？”
设计和接口指南：
- “苹果iOS应用程序按钮设计指南”
- “iPad上导航模式的最佳实践”
- “应用程序图标的可访问性要求”
自然语言查询：
- “如何在SwiftUI中处理内存管理？”
- “如何在我的应用程序中实现Liquid Glass效果？”
- “实现暗模式支持的最佳方式”
你的AI会搜索苹果的完整文档，并提供源链接的答案。当文档包含代码示例时，您的AI可以提取这些示例，并提供完整的上下文和解释。
主要优势
完整的历史和当前报道： 这是目前最全面的苹果开发者文档集。苹果曾经发布并将继续发布的所有内容——从传统API到尖端框架，2019-2025年的所有WWDC会议，完整的人机界面指南——都在一个可搜索的数据库中。
自然语言搜索： 用简单的英语提问。不需要知道确切的API名称或关键字。搜索会理解你想要实现的目标。
工作代码示例： 不仅仅是文档文本，还有所有平台版本的实际Swift代码及其解释和上下文。
快速和本地： 所有文件都在您的机器上处理。搜索结果在没有API调用的情况下立即显示。
从传统到最新： 无论您需要传统的iOS 13 API还是Liquid Glass API等最新的iOS 26功能，这里都有完整的WWDC 2025内容。
故障排除
光标显示“无工具”：
- 在中使用绝对路径
.cursor/mcp.json - 确保
run-mcp-safe.sh可执行：chmod +x run-mcp-safe.sh - 完全重新启动游标
OpenAI API关键错误：
- 将API密钥放入
env……的部分mcp.json（推荐） - 检查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密钥
- 游标或兼容的MCP客户端
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
______________________________________________________________________
这是一个用于访问Apple开发人员文档的非官方工具。与苹果股份有限公司无关联。