Apple Docs 2.0 MCP

English · 日本語 · 한국어 · 简体中文

Apple Docs 2.0 MCP

一个 MCP，涵盖 Apple 开发者文档、设计指南和 WWDC 会议。

正在使用 Agent 构建下一个 iOS 应用？先让它阅读 Apple 官方文档：减少重写，也减少中断。

快速开始 · 新增内容 · 安装 · 使用示例 · 工具 · 架构 · 开发

npx -y apple-docs-2.0-mcp

通过 Model Context Protocol 为 AI 助手提供 Apple 开发者文档：API 参考、文章、示例 代码、教程、人机界面指南、App Store Connect 帮助、Web 服务 API（App Store Connect API、App Store Server API 等），以及 1,700 场附带文字记录和代码的 WWDC 会议；可在 Claude、Cursor、VS Code 或任何 MCP 客户端中使用。

Apple Docs 2.0 MCP 是 kimsungwhee 的 Apple Docs MCP 分支， 加入了新增功能、修复和一个新工具。

🚀 快速开始

Claude Desktop（推荐）

将以下内容添加到 Claude Desktop 配置中：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

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

注意：如果遇到使用旧版本的问题，请添加 @latest 以强制使用最新版本：

"args": ["-y", "apple-docs-2.0-mcp@latest"]

重启 Claude Desktop，然后开始询问 Apple API！

Claude Code

claude mcp add apple-docs -- npx -y apple-docs-2.0-mcp

向你的 Agent 提问

Look up NavigationStack in Apple's docs, then show me the WWDC code that uses it.

🆕 2.0 版新增内容

Apple Docs 2.0 MCP 保留了 Apple Docs MCP 1.0.26 的全部功能，并修复了失效或返回不完整内容的问题， 让助手基于 Apple 官方文档回答，而不是凭空猜测。

🔍 搜索现在能返回结果

search_apple_docs 已修复：现在使用与 Apple 网站相同的搜索服务，因此助手能获取你在 developer.apple.com 上看到的 结果：API 参考、文章、示例代码、设计指南、App Store Connect 帮助和 WWDC 视频。原版的搜索会返回空结果，因为 Apple 更改了其搜索页面。

询问 API、设计指南或 App Store 流程时，助手会先进行搜索，再阅读找到的页面。

🗺️ 按名称查找任意页面

新增工具 search_docs_map，可离线按名称或名称片段查找 336,723 个页面中的任意一个：

• API 符号：类型、方法、属性、枚举项、宏
• 文章和示例代码
• Info.plist 和授权键
• Web 服务端点，例如 App Store Connect API 的端点
• 人机界面指南和 App Store Connect 帮助页面

如果你已从代码或错误消息中得知名称，可使用此工具直接打开对应页面。

📄 完整文档页面

页面内容完整呈现，如同 Apple 网站上的页面：每个方法和属性都包含完整签名 （var view: UIView!，而不只是 view）、类型继承自什么以及遵循哪些协议、相关 API，以及支持该 API 的 OS 版本。2.0 还会读取《人机界面指南》、教程、App Store Connect 帮助，以及包含参数和响应的 App Store Connect API 端点。

询问任何 API、指南或 App Store Connect 主题，助手都会先读取完整页面，再作答或编写代码。

🎥 2014–2026 年 WWDC，包含代码

内置 1,700 场 session，包括 WWDC26，并支持离线使用：其中 1,416 场提供逐字稿，每段都标注开始时间；480 场提供章节；715 场提供代码示例，每个示例都标注其在视频中出现的时间。Session 按照 Apple 网站上的相同主题分类。

询问某个新 API 的工作原理，助手可以引用介绍该 API 的 WWDC session 及其代码。

📋 完整的框架列表

原版的技术列表在 200 项后就停止了，因此 Graphics and Games、Media、System、Web 等整个类别都没有出现，而且符号搜索会混入带有损坏链接的标题。2.0 列出所有内容，标记 Beta 框架，并可按主题查找框架：“机器学习”会返回 Core ML、Create ML、Foundation Models、Vision 等。

询问哪些框架适合某项任务（例如机器学习或音频），助手会比较完整列表中的框架。

🛠️ 持续可靠运行

依赖项保持最新；请求看起来与普通浏览器的请求无异，并会等待轮到自己（Apple 在请求过快时会返回空的搜索结果）；请求失败时自动重试；并包含 207 项自动化测试。原版 README 中的全部 63 个用法示例均可无错误运行。

无需任何设置：不需要 API 密钥或账户。

✨ 功能

• 🔍 搜索：在一次搜索中查找 Apple 文档、设计指南、示例代码、App Store Connect 帮助和 WWDC session，也可只搜索其中一项
• 🗺️ 文档地图：无需网络请求，即可按标题查找任何页面，甚至包括方法或属性名称
• 📚 文档页面：以 Markdown 格式呈现 Swift 和 Objective-C API、文章、教程及 Web 服务参考
• 🎨 人机界面指南：可搜索并阅读所有 HIG 页面
• 🏪 App Store Connect 帮助：产品页面字段、审核、TestFlight、定价
• 🔧 框架符号：通过通配符浏览框架中的类、结构体、协议和成员
• 🔗 API 关系：相关、相似及引用的 API，以及已弃用 API 的替代项
• 📊 平台兼容性：API 在各个平台引入和弃用的版本
• 📋 技术目录：按类别列出所有 Apple 框架和技术，并标记 Beta 项
• 📰 文档更新：发行说明、框架更新和 WWDC「新增内容」页面
• 🎯 技术概览：Apple 关于应用设计、游戏、AI 和机器学习、数据等方面的指南
• 💻 示例代码：所有示例项目按 Apple 搜索结果排名；还可按框架或章节查看示例代码库，其中包含摘要和下载链接
• 🎥 WWDC 资料库：2014 至 2026 年的 1,700 场 session，包含逐字稿、带时间戳的代码示例、资源和相关 session，支持离线使用

📦 安装

claude mcp add apple-docs -- npx -y apple-docs-2.0-mcp

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

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

{
  "context_servers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "apple-docs-2.0-mcp"],
      "env": {}
    }
  }
}

💬 使用示例

🔍 搜索

"Search for SwiftUI animations"
"Find withAnimation API documentation"
"Search the Human Interface Guidelines for tab bars"
"Search App Store Connect Help for TestFlight external testers"
"Find sample code for Core Data"

🗺️ 文档地图

"Find the page for accessibilityInputLabels"
"Which SwiftUI pages have gauge in their title?"
"Find the App Store Connect API endpoint to create an auto-renewable subscription"

📚 访问文档

"Get detailed information about the SwiftUI framework"
"Show me withAnimation API with related APIs"
"Show me NSManagedObjectContext documentation"
"Read the Human Interface Guidelines page on tab bars"
"Show the steps of the SwiftUI tutorial"

🔧 探索框架

"Show me SwiftUI views"
"List all UIKit delegate protocols"
"Get WeatherKit API hierarchy"
"Explore Core ML model loading APIs"

🔗 API 发现

"Find APIs related to UIViewController"
"Discover alternatives to UIAlertView"
"Get all references from SwiftData documentation"
"Get platform compatibility for SwiftData"

📋 技术、更新与概览

"What machine learning frameworks are available?"
"Which technologies are in beta?"
"What's new in SwiftUI?"
"Show me release notes for Xcode"
"Get data management technology overviews"

💻 示例代码

"Show SwiftUI sample code projects"
"Find sample code for machine learning"
"Get the Food Truck sample"

🎥 WWDC

"Search WWDC videos about SwiftUI"
"Find WWDC sessions on machine learning"
"Show me WWDC 2026 videos"
"Search WWDC transcripts for async/await"
"Show me the transcript for WWDC23 Meet SwiftData"
"Get code examples from WWDC sessions that use SwiftData"
"Find sessions related to WWDC23 Meet SwiftData"
"List all WWDC topics"

🛠️ 可用工具

文档工具会从 developer.apple.com 获取内容；WWDC 工具读取内置数据，search_docs_map 读取文档地图，这两者都不会发起网络请求。

🏗️ 架构

Apple-Docs-2.0-MCP/
├── src/
│   ├── index.ts                    # MCP server and its search guide
│   ├── tools/
│   │   ├── handlers.ts             # Tool registration
│   │   ├── search-api.ts           # Apple's search API
│   │   ├── search-docs-map.ts      # Docs map search
│   │   ├── doc-fetcher.ts          # Pages from Swift-DocC JSON
│   │   ├── doc-formatter.ts        # Markdown rendering
│   │   ├── help-pages.ts           # App Store Connect Help (jsdom, turndown)
│   │   ├── list-technologies.ts    # Technology catalog
│   │   ├── search-framework-symbols.ts
│   │   ├── get-related-apis.ts, find-similar-apis.ts, resolve-references-batch.ts, get-platform-compatibility.ts
│   │   ├── get-documentation-updates.ts, get-technology-overviews.ts, get-sample-code.ts
│   │   └── wwdc/                   # WWDC tools and the session, topic and year extractors
│   ├── types/                      # Generated from Swift-DocC's specs and captured responses
│   └── utils/                      # HTTP client, caches, constants, URL conversion
├── scripts/
│   ├── add-wwdc-year.ts            # Adds or refreshes a WWDC year in data/wwdc
│   ├── build-docs-map.ts           # Builds api-map/apple-docs-map.tsv
│   └── capture-responses.ts        # Captures responses to type them
├── data/wwdc/                      # The bundled WWDC sessions
├── api-map/                        # The docs map, Apple's search API (OpenAPI) and captured responses
└── tests/                          # Vitest

🌐 请求与缓存

每个请求都通过一个 HTTP 客户端发出：使用 Safari 的标头调用 fetch，每分钟最多 100 个请求；搜索逐个进行，间隔 15 秒，因为 Apple 对间隔更短的搜索会返回无结果。每次尝试的超时时间为 2 分钟；遇到网络错误、超时和 5xx 响应时，最多重试 3 次并采用退避策略。

Apple 的 JSON 会按 URL 原样缓存，并由所有工具共享：其他工具刚读取过的页面不会再次下载，同时对同一 URL 的并发请求会共用一次下载。

📦 WWDC 数据

WWDC 会议内容打包在 data/wwdc/ 中，因此 WWDC 工具可离线使用，且不受速率限制：

• 📹 1,700 场会议，涵盖 2014 至 2026 年；其中 1,416 场附有文字稿，每段均标注时间（Apple 不再列出的仅有 6 场）；715 场附有代码示例，480 场附有章节
• 🏷️ 19 个主题，取自 Apple 的主题页面
• 💾 48 MB 的 JSON

npx tsx scripts/add-wwdc-year.ts <year> 可从 Apple 页面添加或刷新某一年的数据；对于 Apple 不再列出的会议，会保留其已存储的数据。

🗺️ 文档映射

api-map/apple-docs-map.tsv 列出了 336,723 个页面（URL、标题、类型、技术、分组、树、技术 ID、Beta 或 Deprecated 标记，以及侧边栏中列出该页面的其他技术），数据来自 Apple 的导航索引、《人机界面指南》和 App Store Connect 帮助的导航内容。search_docs_map 会在使用期间将其保留在内存中。运行 npx tsx scripts/build-docs-map.ts api-map/apple-docs-map.tsv，约 10 分钟即可重新生成。

🧪 开发

git clone https://github.com/mishafyi/Apple-Docs-2.0-MCP.git
cd Apple-Docs-2.0-MCP
npx pnpm@10 install
npx pnpm@10 run build          # tsc into dist/

# Run your build in Claude Code in place of the npm package
claude mcp add apple-docs -- node "$PWD/dist/index.js"

# Checks: types (server and scripts), lint and tests
npx tsc --noEmit && npx tsc -p scripts && npx eslint src scripts && npx vitest run

# Call the built server without an MCP client
npx -y @modelcontextprotocol/inspector --cli node dist/index.js --method tools/call \
  --tool-name search_apple_docs --tool-args-json '{"query":"tab bars","type":"design"}'

# Regenerate the types of Apple's JSON
npm run types:docc             # from Swift-DocC's RenderNode and RenderIndex specs
npm run types:captured         # from captured responses (quicktype)

构建完成后，在 MCP 客户端中重启或重新连接服务。

🙏 致谢

Apple Docs 2.0 MCP 基于 Apple Docs MCP 构建。该项目最初采用了 kimsungwhee 提供的工具、WWDC 数据和结构。

🤝 参与贡献

欢迎贡献：

1. Fork 此仓库
2. 创建 功能分支：git checkout -b feature/amazing-feature
3. 提交 更改：git commit -m 'Add amazing feature'
4. 推送 到分支：git push origin feature/amazing-feature
5. 发起 Pull Request

📄 许可证

MIT 许可证，与原项目相同：请参阅 LICENSE。

⚠️ 免责声明

本项目与 Apple Inc. 无关，也未获得其认可。本项目读取 Apple 公开提供的开发者文档，仅用于教育和开发目的。