Context7 MCP - 即時更新的程式碼文件，適用於任何提示
❌ 沒有 Context7
大型語言模型（LLM）依賴過時或通用的函式庫資訊。你會遇到：
- ❌ 程式碼範例過時，僅根據一年前的訓練資料
- ❌ 產生不存在的 API
- ❌ 舊版套件的通用答案
✅ 有了 Context7
Context7 MCP 直接從來源拉取即時、特定版本的文件與程式碼範例，並直接放入你的提示中。
在 Cursor 的提示中加入 use context7：
建立一個使用 app router 的基本 Next.js 專案。use context7
根據 PostgreSQL 資訊，建立一個刪除 city 為 "" 的資料列的腳本。use context7
Context7 會將即時的程式碼範例與文件直接帶入你的 LLM 上下文。
- 1️⃣ 自然地撰寫你的提示
- 2️⃣ 告訴 LLM
use context7 - 3️⃣ 取得可執行的程式碼解答
不需切換分頁、不會產生不存在的 API、不會有過時的程式碼。
📚 新增專案
請參考我們的專案新增指南，學習如何將你喜愛的函式庫加入 Context7 或更新其內容。
🛠️ 安裝
系統需求
- Node.js >= v18.0.0
- Cursor、Windsurf、Claude Desktop 或其他 MCP 客戶端
透過 Smithery 安裝
要透過 Smithery 自動安裝 Context7 MCP Server：
npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>
你的 Smithery 金鑰可在 Smithery.ai 網頁 取得。
在 Cursor 安裝
前往：Settings -> Cursor Settings -> MCP -> Add new global MCP server
建議將下列設定貼到你的 Cursor ~/.cursor/mcp.json 檔案。你也可以在專案資料夾建立 .cursor/mcp.json 進行專案安裝。詳見 Cursor MCP 文件。
Cursor 遠端伺服器連線
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp"
}
}
}
Cursor 本地伺服器連線
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
替代方案：使用 Bun
{
"mcpServers": {
"context7": {
"command": "bunx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
替代方案：使用 Deno
{
"mcpServers": {
"context7": {
"command": "deno",
"args": ["run", "--allow-env", "--allow-net", "npm:@upstash/context7-mcp"]
}
}
}
在 Windsurf 安裝
將下列內容加入 Windsurf MCP 設定檔。詳見 Windsurf MCP 文件。
Windsurf 遠端伺服器連線
{
"mcpServers": {
"context7": {
"serverUrl": "https://mcp.context7.com/sse"
}
}
}
Windsurf 本地伺服器連線
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
在 VS Code 安裝
將下列內容加入 VS Code MCP 設定檔。詳見 VS Code MCP 文件。
VS Code 遠端伺服器連線
"mcp": {
"servers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
}
}
}
VS Code 本地伺服器連線
"mcp": {
"servers": {
"context7": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
在 Zed 安裝
可透過 Zed 擴充套件 安裝，或將下列內容加入 Zed settings.json。詳見 Zed Context Server 文件。
{
"context_servers": {
"Context7": {
"command": {
"path": "npx",
"args": ["-y", "@upstash/context7-mcp"]
},
"settings": {}
}
}
}
在 Claude Code 安裝
執行下列指令。詳見 Claude Code MCP 文件。
Claude Code 遠端伺服器連線
claude mcp add --transport sse context7 https://mcp.context7.com/sse
Claude Code 本地伺服器連線
claude mcp add context7 -- npx -y @upstash/context7-mcp
在 Claude Desktop 安裝
將下列內容加入 Claude Desktop claude_desktop_config.json。詳見 Claude Desktop MCP 文件。
{
"mcpServers": {
"Context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
在 BoltAI 安裝
打開應用程式的「Settings」頁面，前往「Plugins」，並輸入下列 JSON：
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
儲存後，在聊天中輸入 get-library-docs 並接上你的 Context7 文件 ID（例如 get-library-docs /nuxt/ui）。更多資訊請參考 BoltAI 文件網站。如在 iOS 上使用 BoltAI，請參考此指南。
使用 Docker
若你偏好在 Docker 容器中執行 MCP 伺服器：
-
建立 Docker 映像檔：
先在專案根目錄（或任意位置）建立
Dockerfile：點擊查看 Dockerfile 內容
FROM node:18-alpine WORKDIR /app # 全域安裝最新版 RUN npm install -g @upstash/context7-mcp # 如有需要可開放預設埠（視 MCP 客戶端互動而定） # EXPOSE 3000 # 預設啟動指令 CMD ["context7-mcp"]然後使用標籤（如
context7-mcp）建構映像檔。**請確保 Docker Desktop（或 Docker daemon）已啟動。**在存有Dockerfile的目錄執行：docker build -t context7-mcp . -
設定 MCP 客戶端：
更新 MCP 客戶端設定以使用 Docker 指令。
cline_mcp_settings.json 範例：
{ "mcpServers": { "Сontext7": { "autoApprove": [], "disabled": false, "timeout": 60, "command": "docker", "args": ["run", "-i", "--rm", "context7-mcp"], "transportType": "stdio" } } }注意：這是範例設定。請參考前述各 MCP 客戶端（如 Cursor、VS Code 等）的範例調整結構（如
mcpServers與servers）。同時確保args中的映像名稱與docker build使用的標籤一致。
在 Windows 安裝
Windows 的設定與 Linux 或 macOS 略有不同（範例以 Cline 為例）。其他編輯器同理，請參考 command 與 args 設定。
{
"mcpServers": {
"github.com/upstash/context7-mcp": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"],
"disabled": false,
"autoApprove": []
}
}
}
在 Augment Code 安裝
在 Augment Code 設定 Context7 MCP，請依下列步驟：
- 按 Cmd/Ctrl Shift P 或於 Augment 面板的漢堡選單中選擇
- 選擇 Edit Settings
- 於 Advanced 下點選 Edit in settings.json
- 將伺服器設定加入
augment.advanced物件的mcpServers陣列
"augment.advanced": {
"mcpServers": [
{
"name": "context7",
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
]
}
加入 MCP 伺服器後，請重啟編輯器。如遇錯誤，請檢查語法是否有遺漏括號或逗號。
🔧 環境變數
Context7 MCP 伺服器支援下列環境變數：
DEFAULT_MINIMUM_TOKENS：設定文件擷取的最小 token 數（預設：10000）
範例設定：
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"],
"env": {
"DEFAULT_MINIMUM_TOKENS": "6000"
}
}
}
}
🔨 可用工具
Context7 MCP 提供下列工具供 LLM 使用：
-
resolve-library-id：將一般函式庫名稱解析為 Context7 相容的函式庫 ID。libraryName（必填）：要查詢的函式庫名稱
-
get-library-docs：根據 Context7 相容的函式庫 ID 取得文件。context7CompatibleLibraryID（必填）：Context7 相容的函式庫 ID（如/mongodb/docs,/vercel/next.js）topic（選填）：聚焦於特定主題（如 "routing", "hooks"）tokens（選填，預設 10000）：最大回傳 token 數。小於預設或DEFAULT_MINIMUM_TOKENS的值會自動提升。
💻 開發
複製專案並安裝依賴：
bun i
建置：
bun run build
本地設定範例
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]
}
}
}
使用 MCP Inspector 測試
npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp
🚨 疑難排解
找不到模組錯誤
若遇到 ERR_MODULE_NOT_FOUND，請嘗試用 bunx 取代 npx：
{
"mcpServers": {
"context7": {
"command": "bunx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
這通常能解決 npx 無法正確安裝或解析套件的問題。
ESM 解析問題
若出現 Error: Cannot find module 'uriTemplate.js'，請嘗試加上 --experimental-vm-modules 參數：
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "--node-options=--experimental-vm-modules", "@upstash/context7-mcp@1.0.6"]
}
}
}
TLS/憑證問題
可加上 --experimental-fetch 參數繞過 TLS 問題：
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "--node-options=--experimental-fetch", "@upstash/context7-mcp"]
}
}
}
一般 MCP 客戶端錯誤
- 嘗試加上
@latest於套件名稱 - 改用
bunx取代npx - 或改用
deno - 請確認 Node.js 版本為 v18 或以上，以支援原生 fetch
⚠️ 免責聲明
Context7 專案由社群貢獻，雖然我們致力於維持高品質，但無法保證所有函式庫文件的正確性、完整性或安全性。Context7 上的專案由各自擁有者開發與維護，非 Context7 官方。若發現可疑、不當或潛在有害內容，請於專案頁面點選「檢舉」按鈕通知我們。我們會嚴肅處理所有檢舉，並盡快審查標記內容，以維護平台的完整性與安全。使用 Context7 即表示你同意自行承擔風險。
🤝 與我們聯繫
歡迎追蹤與加入社群：
- 📢 追蹤我們的 X 以獲取最新消息
- 🌐 造訪我們的 官方網站
- 💬 加入我們的 Discord 社群
📺 Context7 媒體報導
- Better Stack：「免費工具讓 Cursor 智慧提升 10 倍」
- Cole Medin：「這絕對是 AI 程式助理最強 MCP 伺服器」
- Income Stream Surfers：「Context7 + SequentialThinking MCPs：這是 AGI 嗎？」
- Julian Goldie SEO：「Context7：全新 MCP AI 代理更新」
- JeredBlu：「Context 7 MCP：即時獲取文件 + VS Code 設定」
- Income Stream Surfers：「Context7：將改變 AI 程式開發的新 MCP 伺服器」
- AICodeKing：「Context7 + Cline & RooCode：這個 MCP 伺服器讓 CLINE 效率提升 100 倍！」
- Sean Kochel：「5 個 MCP 伺服器讓你程式開發如虎添翼（即插即用）」
⭐ 星標歷史
📄 授權
MIT