Apple Docs MCP安装配置指南：支持Claude、Cursor、VS Code等8大AI工具

【免费下载链接】apple-docs-mcpMCP server for Apple Developer Documentation - Search iOS/macOS/SwiftUI/UIKit docs, WWDC videos, Swift/Objective-C APIs & code examples in Claude, Cursor & AI assistants项目地址: https://gitcode.com/gh_mirrors/ap/apple-docs-mcp

Apple Docs MCP是一款功能强大的苹果开发者文档MCP服务器工具，让您能够在Claude、Cursor、VS Code等8大AI工具中直接搜索和访问苹果官方开发者文档。这款终极工具为iOS、macOS、watchOS、tvOS和visionOS开发者提供了前所未有的便捷体验，让您快速获取SwiftUI、UIKit、Swift、Objective-C等苹果开发框架的完整文档、API参考和代码示例。

🚀 什么是Apple Docs MCP？

Apple Docs MCP是基于Model Context Protocol（MCP）的苹果开发者文档服务器，它通过智能搜索功能让您能够：

• 🔍搜索苹果官方文档：包括SwiftUI、UIKit、Foundation、CoreData、ARKit等所有苹果框架
• 📚访问完整API文档：获取Swift和Objective-C的详细API参考
• 🎥浏览WWDC视频：搜索2014-2025年的WWDC会议视频及完整文字稿
• 💻查看代码示例：获取官方Swift和Objective-C代码示例
• 🔧分析平台兼容性：了解iOS、macOS、watchOS、tvOS、visionOS的版本支持情况

📦 快速安装方法

前置要求

确保您的系统已安装以下软件：

• Node.js 18+ 或更高版本
• npm、yarn或pnpm包管理器

一键安装命令

最简单的安装方式是使用npx：

npx -y @kimsungwhee/apple-docs-mcp@latest

全局安装（推荐）

如果您经常使用，建议全局安装：

# 使用pnpm（推荐） pnpm add -g @kimsungwhee/apple-docs-mcp # 使用npm npm install -g @kimsungwhee/apple-docs-mcp

🛠️ 8大AI工具配置指南

1. Claude Desktop配置（最推荐）

macOS系统：

1. 打开配置文件：~/Library/Application Support/Claude/claude_desktop_config.json
2. 添加以下配置：

{ "mcpServers": { "apple-docs": { "command": "npx", "args": ["-y", "@kimsungwhee/apple-docs-mcp@latest"] } } }

Windows系统：

1. 打开配置文件：%APPDATA%\Claude\claude_desktop_config.json
2. 添加相同的配置内容

2. Claude Code配置

在终端中运行以下命令：

claude mcp add apple-docs -- npx -y @kimsungwhee/apple-docs-mcp@latest

3. Cursor配置

方法一：通过设置界面

1. 打开Cursor → 设置 → Cursor Settings → MCP
2. 点击"Add new global MCP server"
3. 输入配置信息

方法二：通过配置文件

1. 编辑文件：~/.cursor/mcp.json
2. 添加配置：

{ "mcpServers": { "apple-docs": { "command": "npx", "args": ["-y", "@kimsungwhee/apple-docs-mcp"] } } }

4. VS Code配置

1. 打开VS Code设置
2. 搜索"MCP"配置
3. 添加以下配置：

{ "mcp": { "servers": { "apple-docs": { "type": "stdio", "command": "npx", "args": ["-y", "@kimsungwhee/apple-docs-mcp"] } } } }

5. Windsurf配置

1. 编辑Windsurf的MCP配置文件
2. 添加以下内容：

{ "mcpServers": { "apple-docs": { "command": "npx", "args": ["-y", "@kimsungwhee/apple-docs-mcp"] } } }

6. Zed编辑器配置

1. 打开Zed的settings.json文件
2. 添加配置：

{ "context_servers": { "Apple Docs": { "command": { "path": "npx", "args": ["-y", "@kimsungwhee/apple-docs-mcp"] }, "settings": {} } } }

7. Cline配置

方法一：通过市场安装

1. 打开Cline → 菜单（☰）→ MCP Servers → Marketplace
2. 搜索"Apple Docs MCP" → 点击安装

方法二：通过配置文件

1. 编辑cline_mcp_settings.json文件
2. 添加配置：

{ "mcpServers": { "apple-docs": { "command": "npx", "args": ["-y", "@kimsungwhee/apple-docs-mcp"], "disabled": false, "autoApprove": [] } } }

8. Amazon Q Developer CLI配置

1. 编辑配置文件：~/.aws/amazonq/mcp.json
2. 添加配置：

{ "mcpServers": { "apple-docs": { "command": "npx", "args": ["-y", "@kimsungwhee/apple-docs-mcp"] } } }

🎯 使用示例和技巧

智能搜索功能

在配置好的AI工具中，您可以尝试以下搜索：

"搜索SwiftUI动画相关文档" "查找withAnimation API的详细说明" "查看async/await在Swift中的使用模式" "获取UITableView代理方法的完整列表" "搜索Core Data NSPersistentContainer的示例" "查找AVFoundation视频播放API"

WWDC视频搜索

"搜索关于SwiftUI的WWDC视频" "查找机器学习相关的WWDC会议" "显示WWDC 2024的所有视频" "搜索关于async/await的WWDC演讲" "查找Swift并发相关的WWDC内容" "显示关于无障碍功能的WWDC会议"

API文档访问

"获取SwiftUI框架的详细信息" "显示withAnimation API及相关API" "获取SwiftData的平台兼容性信息" "访问UIViewController文档及相似API" "查看NSManagedObjectContext文档" "获取URLSession的async/await方法"

⚙️ 高级配置选项

用户代理池配置

Apple Docs MCP包含智能用户代理轮换系统，提高API可靠性：

# 启用/禁用轮换 export USER_AGENT_ROTATION_ENABLED=true # 设置轮换策略（random/sequential/smart） export USER_AGENT_POOL_STRATEGY=smart # 最大重试次数 export USER_AGENT_MAX_RETRIES=3

自定义用户代理配置

# 配置自定义用户代理池 export USER_AGENT_POOL_CONFIG='[ {"userAgent": "MyApp/1.0 (compatible)", "weight": 3, "maxUsageCount": 1000}, {"userAgent": "MyApp/2.0 (advanced)", "weight": 2, "maxUsageCount": 800} ]'

🔧 故障排除指南

常见问题解决

问题1：配置后无法使用

• 确保已重启AI工具应用
• 检查Node.js版本是否为18+
• 验证配置文件语法是否正确

问题2：搜索无结果

• 检查网络连接
• 确认Apple开发者网站可访问
• 尝试清除缓存或重启服务

问题3：Windows系统问题对于Windows系统，使用以下配置：

{ "mcpServers": { "apple-docs": { "command": "cmd", "args": ["/c", "npx", "-y", "@kimsungwhee/apple-docs-mcp"], "disabled": false, "autoApprove": [] } } }

性能优化建议

1. 启用缓存：MCP服务器内置内存缓存，可显著提高响应速度
2. 使用最新版本：定期更新到最新版本获取性能改进
3. 调整轮换策略：使用"smart"策略获得最佳可靠性
4. 限制并发请求：避免同时发起过多搜索请求

📊 支持的搜索类型

Apple Docs MCP支持以下搜索类型：

🚀 开发环境搭建

如果您想从源代码构建：

# 克隆仓库 git clone https://gitcode.com/gh_mirrors/ap/apple-docs-mcp.git cd apple-docs-mcp # 使用pnpm（推荐） pnpm install && pnpm run build # 使用npm npm install && npm run build # 开发模式（自动重载） pnpm run dev

💡 使用技巧和最佳实践

高效搜索技巧

1. 使用具体关键词：越具体的关键词返回结果越精确
2. 组合搜索：结合框架名称和功能进行搜索
3. 利用过滤功能：按平台、框架或技术进行筛选
4. 查看相关API：使用相关API发现功能探索更多可能性

离线数据优势

Apple Docs MCP内置了完整的WWDC数据（2014-2025），提供：

• ✅零网络延迟- WWDC内容无需API调用
• ✅100%离线访问- 无需网络连接即可使用
• ✅无速率限制- 无限次搜索和浏览
• ✅即时响应- 所有数据本地可用

定期更新建议

建议定期更新Apple Docs MCP以获取：

• 最新的苹果API文档
• 新增的WWDC会议内容
• 性能改进和bug修复
• 新功能和搜索优化

📈 性能特点

Apple Docs MCP具有以下性能优势：

• 内存缓存系统：自定义缓存实现，自动清理和TTL支持
• 智能用户代理轮换：智能轮换系统，自动故障恢复和性能监控
• 动态请求头：真实的浏览器请求头生成
• 错误恢复能力：优雅降级和全面的错误处理
• 类型安全：完整的TypeScript支持，Zod运行时验证
• 最新依赖：使用MCP SDK v1.15.1，优化的包大小

🎉 开始使用

现在您已经完成了Apple Docs MCP的安装和配置，可以开始在您喜欢的AI工具中享受快速、准确的苹果开发者文档搜索体验了！无论是SwiftUI开发、UIKit编程，还是需要查找WWDC会议内容，Apple Docs MCP都能为您提供强大的支持。

记住，定期更新工具以获取最新的苹果开发资源，并尝试不同的搜索技巧来最大化您的开发效率！🚀

注意：本项目与苹果公司无任何关联，仅用于教育和开发目的。所有文档内容均来自苹果公开的开发者文档API。

【免费下载链接】apple-docs-mcpMCP server for Apple Developer Documentation - Search iOS/macOS/SwiftUI/UIKit docs, WWDC videos, Swift/Objective-C APIs & code examples in Claude, Cursor & AI assistants项目地址: https://gitcode.com/gh_mirrors/ap/apple-docs-mcp