context7-mcp

當使用者詢問關於函式庫、框架或需要程式碼範例時，請使用 Context7 擷取最新文件，而非依賴訓練資料。

何時使用此技能

當使用者有以下情況時，啟用此技能：

• 詢問設定或配置問題（例如「如何設定 Next.js 中介軟體？」）
• 要求涉及函式庫的程式碼（例如「寫一個 Prisma 查詢來...」）
• 需要 API 參考（例如「Supabase 的驗證方法有哪些？」）
• 提及特定框架（React、Vue、Svelte、Express、Tailwind 等）

如何擷取文件

步驟 1：解析函式庫 ID

呼叫 resolve-library-id，並提供：

• libraryName：從使用者問題中提取的函式庫名稱
• query：使用者的完整問題（可提升相關性排名）

步驟 2：選擇最佳匹配

從解析結果中，根據以下條件選擇：

• 與使用者詢問的名稱完全或最接近匹配
• 較高的基準分數表示更好的文件品質
• 如果使用者提及版本（例如「React 19」），優先選擇特定版本的 ID

步驟 3：擷取文件

呼叫 query-docs，並提供：

• libraryId：選定的 Context7 函式庫 ID（例如 /vercel/next.js）
• query：使用者的具體問題，範圍限於單一概念

如果使用者的問題涵蓋多個不同概念（例如路由、驗證和快取），請針對每個概念使用相同的 libraryId 分別呼叫 query-docs，除非問題是關於這些概念如何互動——合併查詢會稀釋排名，並對每個主題回傳淺層結果。

步驟 4：使用文件

將擷取的文件整合到你的回應中：

• 使用當前準確的資訊回答使用者的問題
• 包含文件中的相關程式碼範例
• 在相關時引用函式庫版本

指南

• 具體明確：將使用者的完整問題作為查詢以獲得更好的結果，但每個查詢應限於單一概念
• 每個查詢一個主題：將多主題問題拆分為多個 query-docs 呼叫——先解析一次函式庫 ID，然後針對每個概念查詢，除非問題是關於這些概念如何互動
• 版本感知：當使用者提及版本（「Next.js 15」、「React 19」）時，如果解析步驟中有可用的版本特定函式庫 ID，請使用它們
• 優先使用官方來源：當有多個匹配時，優先選擇官方/主要套件而非社群分支