Apple Docs MCP-苹果开发者文档模型上下文协议服务器
苹果开发者文档MCP服务器-通过模型上下文协议访问苹果官方开发者文档、框架、API、SwiftUI、UIKit和WWDC视频。使用人工智能驱动的自然语言查询搜索iOS、macOS、watchOS、tvOS和visionOS文档。直接在Claude、Cursor或任何兼容MCP的人工智能助手中获得Swift/Objective-C代码示例、API参考和技术指南的即时访问。
✨ 特性
- 🔍 智能搜索：在Apple开发者文档中智能搜索SwiftUI、UIKit、Foundation、CoreData、ARKit等
- 📚 完整的文档访问权限：完全访问适用于Swift、Objective-C和框架文档的Apple JSON API
- 🔧 框架索引：浏览iOS、macOS、watchOS、tvOS、visionOS框架的分层API结构
- 📋 技术目录：探索苹果技术，包括SwiftUI、UIKit、Metal、Core ML、Vision和ARKit
- 📰 文档更新：跟踪WWDC 2024/2025公告、iOS 26、macOS 26和最新SDK版本
- 🎯 技术概述：Swift、SwiftUI、UIKit和所有苹果开发平台的综合指南
- 💻 示例代码库：用于iOS、macOS和跨平台开发的Swift和Objective-C代码示例
- 🎥 WWDC视频库：使用成绩单、Swift/SwiftUI代码示例和资源搜索WWDC 2014-2025会话
- 🔗 相关API发现：查找SwiftUI视图、UIKit控制器和特定于框架的API关系
- 📊 平台兼容性：iOS 13+、macOS 10.15+、watchOS 6+、tvOS 13+、visionOS兼容性分析
- ⚡ 高性能：针对Xcode、Swift Playgrounds和AI驱动的开发环境进行了优化
- 🔄 智能用户代理池：智能UserAgent轮换系统，具有自动故障恢复和性能监控功能
- 🌐 多平台：完整的iOS、iPadOS、macOS、watchOS、tvOS和visionOS文档支持
- 🏷️ 测试版和状态跟踪：iOS 26测试版API，弃用的UIKit方法，新的SwiftUI功能跟踪
🚀 快速开始
克劳德桌面（推荐）
将此添加到您的Claude Desktop配置中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\ 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}备注：如果您在使用旧版本时遇到问题，请添加@latest要强制使用最新版本： ``json "args": ["-y", "@kimsungwhee/apple-docs-mcp@latest"]``
重新启动Claude Desktop并开始询问Apple API！
📦 安装
📱 Claude Code
claude mcp add apple-docs -- npx -y @kimsungwhee/apple-docs-mcp@latest🖱️ Cursor
通过设置：设置→ 光标设置→ MCP → 添加新的全局MCP服务器
通过配置文件：添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}🔷 VS Code
添加到您的VS代码MCP配置中：
{
"mcp": {
"servers": {
"apple-docs": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}
}🌊 Windsurf
添加到您的Windsurf MCP配置中：
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}⚡ Zed
添加到您的Zed settings.json:
{
"context_servers": {
"Apple Docs": {
"command": {
"path": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
},
"settings": {}
}
}
}🔧 Cline
通过市场:
- 开放式诊所→ 菜单（☰）→MCP服务器→ 市场
- 搜索“苹果文档MCP”→ 安装
通过配置：添加到 cline_mcp_settings.json:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"],
"disabled": false,
"autoApprove": []
}
}
}Amazon A Developer CLI
通过配置文件：添加到 ~/.aws/amazonq/mcp.json:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}📖 Amazon A Developer CLI MCP文档
🪟 Windows
对于Windows系统，请使用：
{
"mcpServers": {
"apple-docs": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@kimsungwhee/apple-docs-mcp"],
"disabled": false,
"autoApprove": []
}
}
}⚙️ Advanced Installation
全球安装:
# Using pnpm (recommended)
pnpm add -g @kimsungwhee/apple-docs-mcp
# Using npm
npm install -g @kimsungwhee/apple-docs-mcp直接使用:
npx @kimsungwhee/apple-docs-mcp --help开发环境设置:
git clone https://github.com/kimsungwhee/apple-docs-mcp.git
cd apple-docs-mcp
# Using pnpm (recommended)
pnpm install && pnpm run build
# Using npm
npm install && npm run build💬 使用示例
🔍 智能搜索
"Search for SwiftUI animations"
"Find withAnimation API documentation"
"Look up async/await patterns in Swift"
"Show me UITableView delegate methods"
"Search Core Data NSPersistentContainer examples"
"Find AVFoundation video playback APIs"📚 文档访问
"Get detailed information about the SwiftUI framework"
"Show me withAnimation API with related APIs"
"Get platform compatibility for SwiftData"
"Access UIViewController documentation with similar APIs"
"Show me NSManagedObjectContext documentation"
"Get URLSession async/await methods"🔧 框架探索
"Show me SwiftUI framework API index"
"List all UIKit classes and methods"
"Browse ARKit framework structure"
"Get WeatherKit API hierarchy"
"Explore Core ML model loading APIs"
"Show Vision framework image analysis APIs"🔗 API发现
"Find APIs related to UIViewController"
"Show me similar APIs to withAnimation"
"Get all references from SwiftData documentation"
"Discover alternatives to Core Data NSManagedObject"📋 技术与平台分析
"List all Beta frameworks in iOS 26"
"Show me Graphics & Games technologies"
"What machine learning frameworks are available?"
"Analyze platform compatibility for Vision framework"📰 文档更新
"Show me the latest WWDC updates"
"What's new in SwiftUI?"
"Get technology updates for iOS"
"Show me release notes for Xcode"
"Find beta features in the latest updates"🎯 技术概述
"Show me technology overviews for app design and UI"
"Get comprehensive guides for games development"
"Explore AI and machine learning overviews"
"Show me iOS-specific technology guides"
"Get data management technology overviews"💻 示例代码库
"Show SwiftUI sample code projects"
"Find sample code for machine learning"
"Get UIKit example projects"
"Show featured WWDC sample code"
"Find Core Data sample implementations"
"Show only beta sample code projects"🎥 WWDC视频搜索
"Search WWDC videos about SwiftUI"
"Find WWDC sessions on machine learning"
"Show me WWDC 2024 videos"
"Search for async/await WWDC talks"
"Find WWDC videos about Swift concurrency"
"Show accessibility-focused WWDC sessions"📺 WWDC视频详情
"Get details for WWDC session 10176"
"Show me the transcript for WWDC23 session on SwiftData"
"Get code examples from WWDC video 10019"
"Show resources from Vision Pro WWDC session"
"Get transcript for 'Meet async/await in Swift' session"📋 WWDC主题和年份
"List all WWDC topics"
"Show me Swift topic WWDC videos"
"Get WWDC videos about developer tools"
"List WWDC videos from 2023"
"Show all SwiftUI and UI frameworks sessions"
"Get machine learning WWDC content"🛠️ 高级用法
"Find related APIs for @State with platform analysis"
"Resolve all references from SwiftUI documentation"
"Get platform compatibility analysis for Vision framework"
"Find similar APIs to UIViewController with deep search"🛠️ 可用工具
| 工具 | 描述 | 主要功能 |
|---|---|---|
search_apple_docs | 搜索Apple开发者文档 | 官方搜索API，查找特定的API、类、方法 |
get_apple_doc_content | 获取详细文档内容 | JSON API访问，可选增强分析（相关/类似API，平台兼容性） |
list_technologies | 浏览所有Apple技术 | 类别筛选、语言支持、测试状态 |
search_framework_symbols | 在特定框架中搜索符号 | 类、结构、协议、通配符模式、类型过滤 |
get_related_apis | 查找相关API | 继承、一致性、“另请参阅”关系 |
resolve_references_batch | 批量解析API引用 | 从文档中提取并解析所有引用 |
get_platform_compatibility | 平台兼容性分析 | 版本支持、测试状态、弃用信息 |
find_similar_apis | 发现类似的API | 苹果官方推荐，主题分组 |
get_documentation_updates | 跟踪Apple文档更新 | WWDC公告、技术更新、发行说明 |
get_technology_overviews | 获取技术概述和指南 | 全面的指南、分层导航、平台过滤 |
get_sample_code | 浏览Apple示例代码项目 | 框架过滤（有限制）、关键字搜索、测试状态 |
search_wwdc_videos | 搜索WWDC视频会话 | 关键字搜索、主题/年份过滤、会话元数据 |
get_wwdc_video_details | 通过成绩单获取WWDC视频详细信息 | 完整成绩单、代码示例、资源、平台信息 |
list_wwdc_topics | 列出所有可用的WWDC主题 | 从Swift到空间计算的19个主题类别 |
list_wwdc_years | 列出所有可用的WWDC年份 | 带视频计数的会议年份 |
🏗️ Apple开发人员文档访问的技术架构
apple-docs-mcp/
├── 🔧 src/
│ ├── index.ts # MCP server entry point with all tools
│ ├── tools/ # MCP tool implementations
│ │ ├── search-parser.ts # HTML search result parsing
│ │ ├── doc-fetcher.ts # JSON API documentation fetching
│ │ ├── list-technologies.ts # Technology catalog handling
│ │ ├── get-documentation-updates.ts # Documentation updates tracking
│ │ ├── get-technology-overviews.ts # Technology overviews and guides
│ │ ├── get-sample-code.ts # Sample code library browser
│ │ ├── get-framework-index.ts # Framework structure indexing
│ │ ├── get-related-apis.ts # Related API discovery
│ │ ├── resolve-references-batch.ts # Batch reference resolution
│ │ ├── get-platform-compatibility.ts # Platform analysis
│ │ ├── find-similar-apis.ts # Similar API recommendations
│ │ └── wwdc/ # WWDC video tools
│ │ ├── wwdc-handlers.ts # WWDC tool handlers
│ │ ├── content-extractor.ts # Video content extraction
│ │ ├── topics-extractor.ts # Topic listing
│ │ └── video-list-extractor.ts # Video list parsing
│ └── utils/ # Utility functions and helpers
│ ├── cache.ts # Memory cache with TTL support
│ ├── constants.ts # Application constants and URLs
│ ├── error-handler.ts # Error handling and validation
│ ├── http-client.ts # HTTP client with performance tracking
│ ├── user-agent-pool.ts # Smart UserAgent rotation system
│ ├── http-headers-generator.ts # Dynamic browser headers generation
│ └── url-converter.ts # URL conversion utilities
├── 📦 dist/ # Compiled JavaScript
├── 📄 package.json # Package configuration
└── 📖 README.md # This file🚀 性能特点
- 基于内存的缓存：具有自动清理和TTL支持的自定义缓存实现
- 智能用户代理池：具有自动故障恢复和性能监测功能的智能旋转系统
- 动态标头：真实的浏览器标头生成（接受、接受语言、用户代理）
- 智能搜索：苹果官方搜索API，具有增强的结果格式
- 增强分析：可选的相关API、平台兼容性和相似性分析
- 差错恢复：优雅的降级，全面的错误处理
- 类型安全：带有Zod v4.0.5运行时验证的完整TypeScript
- 最新依赖关系：MCP SDK v1.15.1，优化了软件包占用空间
💾 缓存策略
| 内容类型 | 缓存持续时间 | 缓存大小 | 原因 |
|---|---|---|---|
| API文档 | 30分钟 | 500个条目 | 经常访问的中等更新 |
| 搜索结果 | 10分钟 | 200个条目 | 动态内容，用户特定 |
| 框架索引 | 1小时 | 100条 | 结构稳定，更改频率较低 |
| 技术列表 | 2小时 | 50个条目 | 很少变化，内容丰富 |
| 文档更新 | 30分钟 | 100条记录 | 定期更新，WWDC公告 |
📦 WWDC数据
所有WWDC视频数据（2014-2025）为 直接捆绑在npm包中，提供：
- ✅ 零网络延迟 -WWDC内容不需要API调用
- ✅ 100%离线访问 -无需互联网连接即可工作
- ✅ 无费率限制 -无限制的WWDC搜索和浏览
- ✅ 即时响应 -所有数据都在本地可用
该套餐包括：
- 📹 1260+WWDC会议视频 有完整的成绩单
- 🏷️ 20个主题类别 用于有组织的浏览
- 📅 13年内容 (2012-2025)
- 💾 35MB优化的JSON数据
备注：保持您的软件包更新，以获取最新的WWDC内容添加。
⚙️ 配置
🔄 UserAgent池配置
MCP服务器包括一个智能UserAgent轮换系统，以提高API的可靠性：
环境变量
| 变量 | 描述 | 默认值 | 示例 |
|---|---|---|---|
USER_AGENT_ROTATION_ENABLED | 启用/禁用旋转 | true | true |
USER_AGENT_POOL_STRATEGY | 轮换策略 | random | smart |
USER_AGENT_MAX_RETRIES | 最大重试次数 | 3 | 5 |
USER_AGENT_POOL_CONFIG | 自定义池配置（JSON） | 内置代理 | 见下文 |
自定义池配置
# Configure custom UserAgent pool
export USER_AGENT_POOL_CONFIG='[
{"userAgent": "MyApp/1.0 (compatible)", "weight": 3, "maxUsageCount": 1000},
{"userAgent": "MyApp/2.0 (advanced)", "weight": 2, "maxUsageCount": 800}
]'
# Set rotation strategy (random/sequential/smart)
export USER_AGENT_POOL_STRATEGY=smart
# Enable debugging
export NODE_ENV=development可用策略
random：快速随机选择（最佳性能）sequential：循环轮换（可预测顺序）smart：成功率优化（最佳可靠性）
内置用户代理
服务器包括12个以上预配置的UserAgent字符串，包括：
- Chrome（Mac英特尔/苹果硅、Windows、Linux）
- Firefox（Mac英特尔/苹果硅、Windows、Linux）
- Safari浏览器（Mac英特尔/苹果硅，最新版本）
- Edge（Windows、Mac、英特尔/苹果硅）
🧪 发展
快速命令
# Development with auto-reload
pnpm run dev # or: npm run dev
# Build for production
pnpm run build # or: npm run build
# Type checking
pnpm exec tsc --noEmit # or: npx tsc --noEmit
# Clean build artifacts
pnpm run clean # or: npm run clean本地测试
# Test the MCP server directly
node dist/index.js
# Test with sample queries
npx @kimsungwhee/apple-docs-mcp --test🤝 贡献
欢迎投稿！以下是如何开始：
- 分叉 存储库
- 创建 特征分支：
git checkout -b feature/amazing-feature - 提交 您的更改：
git commit -m 'Add amazing feature' - 推 到分行：
git push origin feature/amazing-feature - 打开 拉取请求
📄 许可证
MIT许可证-请参阅 许可证 了解详情。
⚠️ 免责声明
本项目不隶属于苹果股份有限公司，也不受其认可。它使用公开的苹果开发者文档API进行教育和开发。
______________________________________________________________________
由以下材料制成❤️ 苹果开发者社区
搜索苹果开发者文档| iOS开发| macOS开发| Swift编程| SwiftUI | UIKit | Xcode | WWDC视频|模型上下文协议| MCP服务器