
為什麼 AI 寫程式總是「瞎掰」?
使用 AI 輔助寫程式時,你是否遇過以下痛點?
- API 幻覺:AI 自信地呼叫了一個根本不存在的函式(例如
function_that_does_not_exist())。 - 版本過時:你在用 Next.js 15,AI 卻還在寫 Next.js 12 的語法。
- 除錯地獄:因為 AI 不知道最新的庫變更,導致你花更多時間在修正它的錯誤。
這就是 Context7 登場的時刻。它是一個由 Upstash 開發的 MCP (Model Context Protocol) 伺服器,簡單來說,它是 AI 的「即時技術文件圖書館」。當你詢問某個套件用法時,Context7 會即時抓取最新的官方文件並注入給 AI,讓 AI 根據「現在的事實」寫程式,而不是依賴「過去的訓練資料」。
如何在 Google Antigravity 上安裝 Context7
Google Antigravity 是一款 Agent-first 的 IDE,原生支援 MCP 協議,設定 Context7 非常簡單:步驟一:開啟 MCP 設定
- 打開 Antigravity IDE。
- 找到右側的 Agent 面板(對話視窗)。
- 點擊面板上方的 ... (更多選項) 按鈕,選擇 "MCP Servers"。
- 點擊 "Manage MCP Servers",接著選擇 "View raw config" 來編輯
mcp_config.json檔案。
步驟二:加入 Context7 設定
在設定檔的 mcpServers 區塊中,貼上以下 JSON 程式碼:
{
"mcpServers": {
"context7": {
"command": "npx",
"args": [
"-y",
"@upstash/context7-mcp",
"--api-key",
"<YOUR_CONTEXT7_API_KEY>"
]
}
}
}
小提醒:你需要先去 Context7 官網註冊取得 API Key。雖然有免費額度,但填入 Key 能確保更穩定的體驗。
設定檔解析:要不要填 API Key?
在設定 args 參數時,你可能會看到兩種寫法。這兩者的差異主要在於「穩定性」與「安全性」,請根據你的使用場景選擇:
設定 A:包含 API Key(推薦個人開發)
寫法: "args": [ "-y", "@upstash/context7-mcp", "--api-key", "<YOUR_KEY>" ]
- 穩定性:高。享有專屬的使用配額,請求經過驗證,不易被阻擋。
- 安全性:低。Key 直接寫死在檔案中,若上傳到 GitHub 會導致洩漏。
- 適合場景:個人本地開發、不公開原始碼的專案。
設定 B:省略 API Key(適合公開專案)
寫法: "args": [ "-y", "@upstash/context7-mcp" ]
- 穩定性:低。會以「匿名模式」運行,通常配額極低,容易因為太多人使用而遇到 429 (Too Many Requests) 錯誤。
- 安全性:高。檔案內沒有敏感資訊。
- 進階技巧:雖然設定檔沒寫,但若你在電腦系統環境變數中設定了
CONTEXT7_API_KEY,程式通常也能自動讀取。這是最推薦的「安全且穩定」做法。
實際使用方式
安裝完畢後,Context7 會在背景待命。你只需要在對話框中使用關鍵字即可:
方法:手動觸發 在 Prompt 結尾加上 use context7。
範例:「幫我寫一個 Next.js 15 的 Middleware 來處理身分驗證,use context7。」
此時,你會看到 Antigravity 的思考過程出現 resolve-library-id 和 get-library-docs 的動作,代表它正在查閱最新文件。這能確保你拿到的程式碼是現在可以用的,大幅減少試錯時間。
現在就去試試看,讓你的 AI 助手升級為「連網版」的超級工程師吧!

















