Context7 是把程式庫文件提供給 AI 編碼工具的查詢服務,適合需要查證新版 API 的開發者;先辨識正確的程式庫與版本,再取得文件,仍需核對專案實際安裝版本與來源。
安裝與執行環境
工具版本 4.7.0;官方文件查閱日 2026-11-16。套件版本與官方文件快照分別固定,不把文件 commit 宣稱為套件發行 commit。
node --version
npx -y @upstash/context7-mcp@4.7.0 --help
以下依官方 stdio 設定格式整理,未在三個客戶端內本地實測。工具版本:4.7.0;客戶端文件查閱日:2026-11-16(滾動文件,不宣稱固定客戶端版本)。
Claude Code
claude mcp add --transport stdio context7 -- npx -y @upstash/context7-mcp@4.7.0
claude mcp get context7
進入 Claude Code 的 /mcp,確認連線狀態與工具清單。
Codex
codex mcp add context7 -- npx -y @upstash/context7-mcp@4.7.0
codex mcp list
開啟新工作階段,先確認 server 工具可見再操作。
Cursor
將以下內容合併到專案 .cursor/mcp.json,保留其他既有設定;在 Cursor 的 MCP 設定啟用並確認工具清單。
{
"mcpServers": {
"context7": {
"command": "npx",
"args": [
"-y",
"@upstash/context7-mcp@4.7.0"
]
}
}
}
Windows 若客戶端無法啟動 npx,依官方範例把 command 改為 cmd,args 最前方加 /c、npx,其後保留原參數;CLI 的啟動部分相應改成 -- cmd /c npx -y 加上原固定版套件。先排查啟動方式,不要同時換版本。
三個實際用途
1. 查目前專案的 API
先讀 package.json 與 lockfile,確認 Next.js 實際版本;用 Context7 找 middleware/proxy 文件,列出文件來源版本及最小範例,不直接修改程式。
預期結果:應回報安裝版、文件版與可用 API;版本不符要明講。
2. 查資料庫 SDK 用法
用 Context7 查 Supabase JavaScript SDK 的 email/password 登入方式,附官方文件連結、套件版本條件與錯誤處理;找不到指定版就回報,不套最新版。
預期結果:應取得附來源與版本條件的範例。
3. 先驗證再升級
比較專案目前套件版本與目標版本的官方遷移文件,列出三個會影響現有呼叫的差異,附來源;不要執行升級。use context7
預期結果:應得到能逐項查證的遷移清單。
實測發現:哪些已確認,哪些還沒測
既有測試取得不含帳戶資訊的公開 HTTP 文件,再以 4.7.0 MCP server 離線重播。指定版與 fallback 的來源 tag、Version note 不同,失敗回應的 isError 也不同。這不代表本次測過即時索引完整度、付費方案或三個客戶端連線。
測試由 Codex 以合成資料執行,不宣稱站長親測或審稿。上方新增操作若未落在上述範圍,均為依官方文件整理、未本地實測。
常見錯誤與解法
查到錯的同名程式庫
先檢查 resolve 結果的專案與文件網址,必要時在提示中指定完整 library ID。
指定版本沒有命中
檢查回傳 Version note 與來源 tag;fallback 不代表精確版本,改讀官方版本文件。
429、授權或連線錯誤
依回應減少重試並查官方方案;需要金鑰的環境由使用者自行設定,不能把本機安裝當成離線文件庫。
限制、費用與授權
MCP 程式碼 MIT;託管服務有獨立方案與限制,查閱當日官方定價,本頁不保證匿名額度或固定價格。查詢會送到外部服務,不要放入機密程式碼。
何時改用其他工具
-
文件就在自己的專案內:Filesystem MCP。
-
要整理整個專案上下文:Repomix。
常見問答
Context7 如何接 Claude Code?
可用下方本機 stdio 設定;若服務要求授權,依官方客戶端指引處理。
裝好 server 就能離線用嗎?
不會;本機 MCP 程式仍要向文件服務查詢。
Context7 回傳一定是 GitHub 指定版嗎?
不一定;需查看來源 tag 與版本說明,沒有就標成未確認。
官方來源
把文件查詢接進開發流程時,可搭配閱讀 FastMCP 的伺服器範例;若工具連線出錯,再用 MCP Inspector 的診斷流程核對。 若文件查詢由 Skill 呼叫,先用 SkillSpector 檢查 Skill 內容。