/ 目錄 / 演練場 / apple-docs-mcp
● 社群 kimsungwhee ⚡ 即開即用

apple-docs-mcp

作者 kimsungwhee · kimsungwhee/apple-docs-mcp

從聊天介面搜尋 Apple 開發者文件、WWDC 影片逐字稿(2014-2025)與範例程式碼,獲得有根據的 iOS/macOS/Swift 解答。

kimsungwhee/apple-docs-mcp 透過 developer.apple.com 內容與 1,260+ 支 WWDC 影片逐字稿提供 15 個工具。可有效避免你的 AI 代理產生 UIKit/SwiftUI API 的幻覺答案。

為什麼要用

核心特性

即時演示

實際使用效果

apple-docs.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "apple-docs",
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "apple-docs": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "apple-docs-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

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

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: apple-docs-mcp

如何阻止 AI 代理產生不存在的 SwiftUI API

👤 使用 Claude/Cursor 的 iOS 開發者 ⏱ ~10 min beginner

何時使用: AI 代理建議了你目標 iOS 版本中根本不存在的 API。

前置條件
  • Node 18+ — nvm install 20
步驟
  1. 安裝
    透過以下指令安裝:npx -y @kimsungwhee/apple-docs-mcp@latest(或加入 MCP 設定)。✓ 已複製
    → 工具出現在清單中
  2. 為問題找到依據
    使用 search_apple_docs 搜尋 'navigationDestination',再用 get_platform_compatibility 確認它在 iOS 16+ 可用。✓ 已複製
    → 官方文件條目 + 最低部署目標版本
  3. 在程式碼中引用
    現在依據你剛讀到的文件撰寫導覽程式碼。✓ 已複製
    → 程式碼 + 引用來源

結果: 可針對你的部署目標版本成功編譯的程式碼。

注意事項
  • WWDC 展示的 API 在正式發布前出現 — 使用 get_platform_compatibility 確認——測試版 API 會有標記
搭配使用: github

如何找到說明某功能的 WWDC 場次

👤 正在採用新功能的 iOS 開發者 ⏱ ~10 min beginner

何時使用: 官方文件說明太簡略,詳細脈絡藏在你沒看過的 WWDC 演講中。

步驟
  1. 搜尋 WWDC
    search_wwdc_videos 'Observation framework Swift macro' years=[2023,2024]。✓ 已複製
    → 場次清單
  2. 取得逐字稿與程式碼
    對排名最高的結果執行 get_wwdc_video_details,並擷取程式碼範例。✓ 已複製
    → 逐字稿 + 程式碼片段

結果: 不用觀看影片,直接獲得完整脈絡與可運作的程式碼。

如何規劃從棄用 API 遷移的計畫

👤 維護舊版程式碼庫的 iOS 開發者 ⏱ ~10 min intermediate

何時使用: 出現「deprecated in iOS 17」警告,你需要找到替代方案。

步驟
  1. 確認棄用狀態
    對 UIActivityIndicatorView.startAnimating 執行 get_platform_compatibility。✓ 已複製
    → 可用性時間軸
  2. 找到建議的替代方案
    使用 find_similar_apis——SwiftUI 的對應寫法是什麼?✓ 已複製
    → ProgressView() 及適當的參數

結果: 附有參考來源的明確遷移計畫。

搭配使用: github

組合

與其他 MCP 搭配,撬動十倍槓桿

apple-docs + github

為遷移 PR 加入文件與 WWDC 參考來源作為依據

找到我們 UIKit ActivityViewController 用法的 SwiftUI 替代方案,引用 Apple 文件與 WWDC 場次,並草擬一個遷移 PR。✓ 已複製
apple-docs + filesystem

掃描本地程式碼中的棄用 API 並建議替代方案

用 apple-docs-mcp 標記的棄用 API 掃描我的 Sources/ 目錄,並產生一份遷移檢查清單。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
search_apple_docs query: str, platform?: str 依名稱或主題搜尋任何 API free
get_apple_doc_content url_or_id 搜尋後讀取完整文件頁面 free
list_technologies category?, include_beta?: bool 瀏覽所有框架 free
search_framework_symbols framework, query 限定框架範圍的符號查詢 free
get_related_apis symbol 追蹤繼承關係或協定遵從關係 free
get_platform_compatibility symbol 確認 API 可用性 free
find_similar_apis symbol 尋找棄用 API 的替代方案 free
get_sample_code topic? 尋找 Apple 官方範例專案 free
search_wwdc_videos query, years?: int[], topics?: str[] 搜尋 WWDC 演講場次 free
get_wwdc_video_details session_id 取得完整場次內容與脈絡 free

成本與限制

運行它的成本

API 配額
developer.apple.com 有合理使用的速率限制;工具會快取結果以減少呼叫次數
每次呼叫 Token 數
文件:500-3000 個 token。長場次逐字稿:最多 20k 個 token
費用
免費
提示
使用 search_framework_symbols 取代範圍較廣的 search_apple_docs,可節省 token 用量。

安全

權限、密鑰、影響範圍

最小權限: None — public docs only
憑證儲存: 無需任何憑證
資料出站: developer.apple.com + 離線內建索引
切勿授予: Nothing to grant

故障排查

常見錯誤與修復

Search returns no results

查詢條件可能過於具體——試著只輸入類別名稱,或使用 list_technologies 瀏覽框架。

Doc content looks truncated

部分頁面內容較長,工具會自動截斷——請將 URL 傳入 get_apple_doc_content,該工具支援分頁處理。

WWDC video not found

部分較舊的場次尚未提供逐字稿。請使用 search_wwdc_videos 並搭配 years 篩選器。

替代方案

apple-docs-mcp 對比其他方案

替代方案何時用它替代權衡
apple-docs via firecrawl你需要原始網頁抓取功能無 WWDC 索引,也無結構化資料
context7 MCP你需要查詢一般函式庫文件,而非 Apple 專屬文件對 Apple 生態系的涵蓋範圍較弱

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills