
最近在玩 Claude 的 MCP(Model Context Protocol)功能,分享一個超級實用的工具 —— Context7 MCP。它可以讓 Claude 在回答框架、SDK、API 相關問題時,自動去抓最新版本的官方文件,不會再給你過時或錯誤的寫法。還在煩惱 Claude 給的程式碼套用過期 API?設定好 MCP,它就會主動幫你查官方文件!
這篇文章會帶你用幾個指令快速安裝 Context7 MCP,並透過 CLAUDE.md 設定使用規則,讓 AI 不再使用過時方法,成為總是參考最新穩定版本的開發助手。
一、什麼是 MCP?
MCP 全名是 Model Context Protocol,由 Anthropic 提出,簡單說就是讓 Claude 能夠外掛「工具」的協定。透過 MCP,Claude 可以執行終端機指令、查資料庫、讀取外部文件等等。
而 Context7 MCP 是一個專門用來查詢第三方函式庫、框架、API 官方文件的工具。它會根據你指定的套件版本,回傳對應的正確用法。
二、安裝與管理 Context7 MCP
所有操作都在終端機中完成。以下是常用的 MCP 指令:
1. 新增 Context7 MCP(使用者層級)
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp@latest
--scope user:對目前使用者生效,不用每個專案都重設。context7:這個 MCP 的名稱。- 後面的
npx -y @upstash/context7-mcp@latest則是執行的命令。
2. 查看所有已安裝的 MCP
claude mcp list確認 context7 有沒有在清單內。
3. 取得某個 MCP 的詳細資訊
claude mcp get context7
可以用來檢查設定或版本。
4. 移除 Context7 MCP
claude mcp remove context7不需要的時候直接移除,乾淨俐落。
三、在 VS Code 中啟用 MCP 面板
如果你是用 VS Code 搭配 Claude 擴充功能,可以直接輸入指令:
text
/mcp
就會叫出 MCP 管理介面,可以用圖形化方式查看、啟用或停用各個 MCP 工具。
四、設定 CLAUDE.md,讓 Claude 自動使用 Context7
MCP 安裝好之後,還需要告訴 Claude 什麼時候該主動查文件。只要在專案根目錄建立 CLAUDE.md 檔案,寫入以下規則:
markdown
# CLAUDE.md
## 工具使用規則
### Context7 MCP
當任務涉及第三方函式庫、框架、SDK、API、CLI 工具、設定檔、專案初始化、依賴安裝、版本差異或官方文件查詢時,請優先使用 Context7 MCP 取得最新且對應版本的文件,再進行回答或產生程式碼。
在以下情境中,即使我沒有明確要求,也應主動使用 Context7 MCP:
- 查詢函式庫或 API 的正確用法
- 生成依賴特定框架、SDK 或工具的程式碼
- 建立專案架構、初始化專案或撰寫配置步驟
- 判斷不同版本之間的 API 差異
- 回答安裝、設定、整合、遷移相關問題
若任務只涉及本專案既有程式碼、純語法修正、命名調整、註解撰寫、簡單重構或不依賴外部文件的邏輯推理,則不需要強制使用 Context7。
這份設定的效果:
- 當你問 「Next.js 15 的 App Router 怎麼寫 middleware?」
→ Claude 會先用 Context7 抓 Next.js 15 官方文件,再回答。 - 當你問 「幫我把這個元件改成箭頭函式」
→ 只涉及純語法調整,Claude 不會浪費時間查文件。
這樣就能兼顧準確性與回應速度。
五、實際情境舉例
情境一:使用新版的 Prisma
你問:「Prisma 5 要怎麼定義複合唯一約束?」
沒有 Context7 時,Claude 可能給你 Prisma 4 的寫法(@@unique([fields]) 其實兩版一樣,但有些 API 確實會變)。
有了 Context7,它會先去確認 Prisma 5 文件,再回傳正確的 schema 語法。
情境二:初始化一個 Vite + Vue 專案
你問:「幫我建立一個 Vite + Vue 3 的專案,並安裝 ESLint 9。」
Claude 會主動用 Context7 查 Vite 的最新初始指令、Vue 3 的設定方式,以及 ESLint 9 的 flat config 寫法(因為 ESLint 9 預設使用新的設定格式)。
情境三:升級 React 18 到 19
你問:「React 19 的 ref 用法有什麼改變?」
Claude 會比對兩個版本的官方文件,告訴你例如 forwardRef 是否還需要,以及新的 ref 作為 prop 的寫法。
六、結語
Context7 MCP 是一個非常貼近開發者日常的工具。以前我們總是抱怨 AI 給的程式碼「看起來對但跑不起來」,多半是因為它參考到舊版文件。現在只要花一分鐘安裝 MCP 並寫好 CLAUDE.md,就能大幅提升回答的正確率。
而且 MCP 的生態越來越豐富,未來可能還會有查 GitHub Issue、看 Stack Overflow 的 MCP。趁現在先學會這套流程,以後 Claude 就能真正成為你的最新技術文檔隨身顧問。















