苹果文档AI助手集成 Apple Doc MCP

Apple Doc MCP项目是一个模型上下文协议（MCP）服务器，能将苹果开发者文档无缝集成到AI编码助手中，核心功能包括提供智能搜索，支持通配符和高级过滤以查找符号和浏览苹果框架结构，能获取详尽的符号文档及示例。

智能搜索：支持通配符（*、?），可跨所有Apple框架查找符号

框架浏览：能探索任何Apple框架结构（如SwiftUI、UIKit、Foundation等）

详细文档：提供包含示例的全面符号文档

高级筛选：可按平台（iOS、macOS等）、符号类型或框架进行筛选

实时数据：始终与Apple最新文档保持同步

自动更新提醒：有仓库更新时会自动通知

AI优化：输出清晰的markdown格式，非常适合AI助手

安装步骤

1、克隆此仓库：

git clone https://github.com/MightyDillah/apple-doc-mcp.git
cd apple-doc-mcp

2、准备使用！（已包含预构建分发版） 无需构建步骤，只需配置你的MCP客户端

快速设置

第一步：配置AI助手

不同AI助手的配置位置如下：

• Claude Desktop：编辑 ~/.config/claude/claude_desktop_config.json

• Cursor：设置（Cmd/Ctrl + ,）→ 扩展 → MCP

• Continue.dev：编辑 ~/.continue/config.json

• VS Code（Claude）：设置 → MCP服务器

配置内容：

{
  "mcpServers": {
    "apple-doc-mcp": {
      "command": "node",
      "args": ["/path/to/apple-doc-mcp/dist/index.js"]
    }
  }
}

将 /path/to/apple-doc-mcp 替换为你克隆仓库的实际路径。

第二步：重启并测试

• 重启AI助手

• 尝试输入：“列出可用的Apple技术”

• 你应该能看到4个新工具

• 服务器启动时会自动检查更新，有更新会通知你

使用方法

配置完成后，你可以自然地与AI助手交流。以下是一些示例：

浏览可用技术

"用apple-doc-mcp列出所有当前的Apple框架"
"从Apple文档中获取最新的可用Apple技术"
"搜索Apple文档中的所有可用框架"

探索框架

"用apple-doc-mcp浏览SwiftUI框架结构"
"从Apple文档中获取当前的UIKit主题"
"在Apple文档中搜索Foundation框架的详细信息"

搜索特定API

"在Apple的SwiftUI文档中搜索拖放API"
"用apple-doc-mcp在ReplayKit中查找RPBroadcast*类"
"在Apple框架中查找所有*View*符号"
"用Apple文档查找UIKit中的所有*Controller类"

获取详细文档

"从Apple获取最新的SwiftUI View协议文档"
"用apple-doc-mcp查找UIViewController文档"
"在Apple当前文档中搜索NSURLSession的详细信息"

AI会自动使用MCP工具获取当前的Apple文档，并提供全面的答案。

可用工具

list_technologies

浏览所有可用的Apple框架和技术。

get_documentation

获取符号或框架的详细文档（自动检测类型）。

参数：• path（必填）：文档路径（如“documentation/SwiftUI/View”）或框架名称（如“SwiftUI”）

示例：

{"path": "SwiftUI"}
{"path": "documentation/SwiftUI/View"}
{"path": "Foundation"}

search_symbols

通过高级筛选跨Apple框架搜索符号。

参数：

• query（必填）：支持通配符的搜索查询

• framework（可选）：在特定框架内搜索

• symbolType（可选）：按符号类型筛选（类、协议、结构体等）

• platform（可选）：按平台筛选（iOS、macOS等）

• maxResults（可选）：最大结果数（默认：20）

示例：

{"query": "RPBroadcast*"}
{"query": "*Controller", "framework": "UIKit"}
{"query": "*View*", "platform": "iOS", "maxResults": 5}

check_updates

检查git仓库的可用更新。

无参数要求，会显示当前分支状态、可用更新和更新说明。

注意：服务器启动时会自动检查更新并显示通知。

故障排除

服务器无法启动

• 确保安装了Node.js 18+

• 验证MCP配置中的路径指向正确的 dist/index.js 位置

• 检查MCP配置语法

• 更改配置后重启AI助手

显示“0个工具”

• 通常意味着服务器未正常启动

• 检查配置中的文件路径是否正确且为绝对路径

• 已包含 dist 目录，无需构建步骤

• 尝试直接测试服务器：node /path/to/apple-doc-mcp/dist/index.js

未找到结果

• 尝试更宽泛的搜索词

• 使用通配符模式：用 "*View*" 代替 "View"

• 移除筛选条件以扩大搜索范围

性能问题

• 首次搜索可能较慢（构建缓存）

• 后续搜索会快很多

• 减少 maxResults 可加快响应速度