作者 mihaelamj · mihaelamj/cupertino
讓你的 AI 助理隨時存取本機 Apple 文件 — 超過 302,000 頁、HIG、範例程式碼，全部以 SQLite FTS5 建立索引，搜尋速度不到 100ms。
cupertino（mihaelamj）會爬取 Apple 開發者文件，並透過本機 SQLite FTS5 索引提供給 MCP 客戶端。有效防止 Claude 憑空捏造 UIKit/SwiftUI API。完整語料庫約 2.4GB，涵蓋 307 個框架、HIG、範例專案及 Swift Evolution。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"cupertino": {
"command": "TODO",
"args": [
"See README: https://github.com/mihaelamj/cupertino"
],
"_inferred": true
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"cupertino": {
"command": "TODO",
"args": [
"See README: https://github.com/mihaelamj/cupertino"
],
"_inferred": true
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"cupertino": {
"command": "TODO",
"args": [
"See README: https://github.com/mihaelamj/cupertino"
],
"_inferred": true
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"cupertino": {
"command": "TODO",
"args": [
"See README: https://github.com/mihaelamj/cupertino"
],
"_inferred": true
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "cupertino",
"command": "TODO",
"args": [
"See README: https://github.com/mihaelamj/cupertino"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"cupertino": {
"command": {
"path": "TODO",
"args": [
"See README: https://github.com/mihaelamj/cupertino"
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add cupertino -- TODO 'See README: https://github.com/mihaelamj/cupertino'一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： Claude 一直捏造 API 簽名時，你希望它以真實文件為依據。
cupertino setup 以下載索引cupertino setup 後再執行 cupertino serve，確認 MCP 伺服器正在監聽。✓ 已複製結果： 大幅減少 API 幻覺情況。
何時使用： 在上線前，你希望對照 HIG 檢查使用流程是否符合規範。
結果： 無需親自閱讀整份文件，即可產出符合 HIG 的 UI。
何時使用： 你想了解「Apple 實際上是如何使用這個 API 的」。
結果： 取得真正由 Apple 認可的模式，而非論壇上的猜測。
在 Figma 中設計，並透過 cupertino 對照 HIG 進行驗證
將你的 SwiftUI 程式碼與 Apple 相同模式的範例進行比對
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| search_docs | query, framework? | 查詢參考 API | 0 |
| search_hig | query, platform? | 查詢設計指引 | 0 |
| list_frameworks | 瀏覽已建立索引的內容 | 0 | |
| read_document | uri | 展開搜尋結果的完整內容 | 0 |
| search_samples | query | 搜尋範例程式碼 | 0 |
| list_samples | 瀏覽範例列表 | 0 | |
| read_sample_file | sample, path | 讀取特定原始碼檔案 | 0 |
cupertino setup 僅在建立索引時向 developer.apple.com 發出一次請求Search returns nothing after installcupertino setup 未完整執行 — 重新執行並注意是否有網路錯誤
Database file size should be ~2.4GBStale docs after an OS release重新執行 cupertino setup 以更新爬取的文件
Index DB too large for machine使用框架範圍設定，只對需要的部分建立索引（例如僅限 SwiftUI）
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| DuckDuckGo / web search MCP | 你不在意幻覺風險，且需要取得最新資訊 | 非權威來源；可能回傳第三方部落格內容 |
| Apple Developer website directly | 由人工自行閱讀文件 | 無法自動化給 AI 助理使用 |