← 返回目录

Apple Docs MCP Server

社区

AI 助手无缝访问 Apple 开发者文档、WWDC 视频与 Swift/Objective-C 代码示例。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 133 / 438
Stars: ★ 1.4k 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: MIT
最近提交: 6 个月前 ⚠
工具数: 15

59FMRS · C

该服务器功能丰富，提供全面的 Apple 文档和 WWDC 访问，适合 Apple 开发者集成到 AI 工作流。但需注意它非官方，依赖第三方 API，且 WWDC 数据可能不是最新。

最强项 · 文档质量 15/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

13/20

维护活跃度

10/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 7/20: README 描述了 15 个工具、TypeScript/Zod 实现、缓存、错误处理与 UserAgent 故障转移，声明工具与工具表内部保持一致。但本次仅做静态审查，未提供源码、CI 工作流或已提交测试；'npm run build'、'--test' 及 MCP init/工具列表握手均无法核实。仓库有 14 个未关闭 issue。扣分：无任何可验证的执行证据，分数必须低于 12 分的静态上限；按 README 判断快乐路径可行，但未经测试佐证。
安全与权限 13/20: 无需也不处理任何凭据（无 API 密钥）；仅访问 Apple 公开的文档/搜索 JSON 接口，无删除、支付、部署等不可逆操作，故无需危险操作确认。安装示例中无真实密钥。扣分：'Smart UserAgent Pool' 轮换伪造浏览器 User-Agent 并自动故障恢复，本质上是对 Apple 端点的反爬规避，README 未披露相关服务条款风险；数据流向（哪些查询发给 Apple）仅隐式说明；无出站请求最小化策略。未发现红线风险（无恶意代码、无凭据窃取、无隐蔽外传）。
维护活跃度 10/20: 可见证据：MIT 许可证、仓库未归档、存在 npm 版本徽章、README 提及较新版本（MCP SDK v1.15.1、Zod v4.0.5）与 WWDC 2025 数据。扣分：所提供的材料中没有提交历史、发布记录、依赖更新策略或安全响应渠道；14 个开放 issue 未见处理状态；npm 徽章与版本号均来自 README，属于不可信证据，无法确认持续维护的节奏。
文档质量 15/20: README 分层且全面：Claude Desktop 快速开始、8 个客户端配置示例（含 Windows）、15 个工具描述与关键特性表格、架构树、缓存策略表、环境变量配置（含默认值）、自定义 UserAgent 池示例、开发命令、免责声明，并有多语言版本。扣分：缺少每个工具的参数 JSON schema 与输入输出示例；除 '@latest' 旧版本提示外无专门故障排查章节；未披露 Apple 非官方 API 的稳定性或速率限制风险，反而声称通过内置数据与代理轮换'无速率限制'；无变更日志；全部证据仅来自 README，无法核验。
安装易用性 14/20: 安装路径非常短：在客户端配置中添加 npx stdio 服务器并重启即可，且给出了 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Zed、Cline、Amazon Q 及 Windows cmd 的完整 JSON 示例；另有全局安装与开发构建方式；无需 API 密钥或环境变量即可起步。扣分：静态上限为 15（缺少已提交 CI 与测试）；npx -y 实际下载与各客户端兼容性无法在此执行验证；npm 包内置 35MB WWDC 数据可能拖慢首次启动。配置示例语法完整但仅为 README 证据。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

Apple 开发者
iOS/macOS 开发人员
使用 AI 编程助手（如 Claude、Cursor）的开发者

不适合谁

非 Apple 平台开发者
需要实时 WWDC 最新数据（但包内数据为 2014-2025 年）的用户
需要本地文档离线镜像的用户（但 WWDC 数据可离线访问）

所需权限

需要网络访问以获取 Apple 开发者文档（WWDC 数据除外，已内置）
无文件系统访问权限，但通过 MCP 协议与客户端通信

风险与副作用

依赖公共 Apple 开发者 API，可能受速率限制或不可用
缓存可能导致文档更新延迟（最长 2 小时）
非官方项目，不保证与未来 Apple API 变更的兼容性

安装接入

准备工作

运行环境：Node.js

其他可选配置项（5 个）

USER_AGENT_ROTATION_ENABLED 可选启用/禁用 UserAgent 轮换，默认 true，可选设置。

USER_AGENT_POOL_STRATEGY 可选轮换策略（random/sequential/smart），默认 random，可选设置。

USER_AGENT_MAX_RETRIES 可选最大重试次数，默认 3，可选设置。

USER_AGENT_POOL_CONFIG 可选自定义 UserAgent 池的 JSON 配置，可选设置。

NODE_ENV 可选设为 development 可启用调试输出，可选设置。

在 Claude Desktop 的配置文件中添加以下 JSON（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json；Windows: %APPDATA%\Claude\claude_desktop_config.json），然后重启 Claude Desktop。其他客户端（Claude Code、Cursor、VS Code 等）的配置方法详见项目 README。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

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

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置中添加 npx -y @kimsungwhee/apple-docs-mcp 并重启，检查工具列表中是否出现 search_apple_docs 等工具，然后提问“搜索 SwiftUI animations”验证连接。

常见排障

确保 npx 已安装且在 PATH 中
如果使用旧版本，尝试将 args 中的包名添加 @latest 后缀
检查网络连接和防火墙设置
查看 README 中的高级配置（如 UserAgent 池）

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索 SwiftUI 动画相关的 Apple 文档
获取 UIViewController 的平台兼容性信息
搜索关于 Swift 并发的 WWDC 视频
列出 iOS 26 中的所有 Beta 框架

工具能力 15

search_apple_docs 只读

在 Apple 开发者文档中搜索 API、类和方法。

get_apple_doc_content 只读

获取详细文档内容，可包含关联 API 和平台兼容性分析。

list_technologies 只读

浏览 Apple 技术目录，支持分类和 beta 状态筛选。

search_framework_symbols 只读

在特定框架中搜索符号（类、结构体、协议等）。

get_related_apis 只读

查找指定 API 的关联 API（继承、协议遵循等）。

resolve_references_batch 只读

批量解析文档中的引用。

get_platform_compatibility 只读

分析 API 的平台兼容性、beta 状态和弃用信息。

find_similar_apis 只读

发现与给定 API 相似的 API。

展开其余 7 个工具

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 主题类别。

list_wwdc_years 只读

列出所有 WWDC 年份。

使用场景

在 AI 编程环境中快速查找 SwiftUI、UIKit 等 API 文档。

搜索并浏览 WWDC 视频，获取会话文字记录和代码示例。

分析 API 的平台兼容性和弃用状态。

发现相关或相似的 API，辅助代码重构和 API 选择。

支持客户端

Claude Desktop

Claude Code

Cursor

VS Code

Windsurf

Zed

Cline

Amazon Q Developer CLI

依据项目文档列出，未经本站实测。

详细介绍

Apple Docs MCP 服务器通过 Model Context Protocol 提供对 Apple 官方开发者文档的全面访问。它支持搜索 iOS/macOS/watchOS/tvOS/visionOS 的框架、API 和文档，支持浏览框架索引、技术目录和文档更新，并提供丰富的 WWDC 视频库（2014-2025 年）及完整文字记录和代码示例。该服务器内置智能缓存、UserAgent 轮换和高性能优化，适合在 Claude、Cursor 等 AI 编程环境中快速查阅 Apple 开发资源。