如何在 macOS 上安裝 Context7 MCP 的詳細步驟說明

,
1

Context7 MCP (Mission Control Panel) 是您 Context7 專案的使用者介面 (UI)。安裝過程主要涉及下載原始碼、設定必要的環境變數，然後在本機電腦上運行它。

如何在 Mac 上安裝 Context7 MCP

此指南將引導您完成在 macOS 上設定並運行 Context7 MCP 的所有步驟。

第一步：安裝先決條件 (Prerequisites)

在開始之前，您需要確保您的 Mac 上已經安裝了以下工具。您可以在「終端機」(Terminal) 應用程式中檢查它們是否存在。

  1. Homebrew：這是 macOS 的套件管理器，可以讓您輕鬆安裝其他軟體。

    • 檢查是否已安裝：
      brew --version
    • 如果沒有安裝，請在終端機中貼上並執行以下指令來安裝 Homebrew：
      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  2. Node.js 和 npm：Context7 MCP 是一個 Node.js 專案，需要 Node.js 執行環境和 npm (Node Package Manager) 來管理其依賴套件。

    • 使用 Homebrew 安裝 Node.js (npm 會一併安裝)：
      brew install node
    • 檢查是否安裝成功：
      node -v
npm -v
      您應該會看到各自的版本號。

  3. Git：您需要 Git 來從 GitHub 下載專案的原始碼。macOS 通常內建了 Git。

    • 檢查是否已安裝：
      git --version
    • 如果沒有，可以透過 Homebrew 安裝：
      brew install git

  4. Upstash 帳戶：Context7 需要一個 Upstash Redis 資料庫來儲存資料。您需要：

    • 一個 Upstash 帳戶。
    • 一個已經創建好的 Redis 資料庫。
    • 您的 Redis 資料庫的 REST URL 和 REST TOKEN。

第二步：下載並安裝 Context7 MCP

現在，您的環境已經準備就緒，可以開始安裝 MCP 了。

  1. 複製 (Clone) 專案原始碼
    打開終端機，選擇一個您想要存放專案的資料夾（例如，您的家目錄或 Documents 資料夾），然後執行以下指令：

    git clone https://github.com/upstash/context7.git

    這會從 GitHub 下載專案並創建一個名為 context7 的資料夾。

  2. 進入專案目錄

    cd context7

  3. 安裝專案依賴
    執行以下指令，npm 會自動下載並安裝所有專案需要的函式庫。這個過程可能需要幾分鐘。

    npm install

第三步：設定環境變數

這是最關鍵的一步。您需要告訴 MCP 如何連接到您的 Upstash Redis 資料庫。

  1. 創建環境變數檔案
    在 context7 專案的根目錄下，創建一個名為 .env.local 的檔案。您可以使用 touch 指令創建，或直接用編輯器創建。

    touch .env.local

  2. 編輯 .env.local 檔案
    用您喜歡的文字編輯器（如 Visual Studio Code、Sublime Text 或 nano）打開 .env.local 檔案，並貼上以下內容：

    UPSTASH_REDIS_REST_URL="YOUR_UPSTASH_REDIS_REST_URL"
UPSTASH_REDIS_REST_TOKEN="YOUR_UPSTASH_REDIS_REST_TOKEN"
CONTEXT7_API_KEY="YOUR_CONTEXT7_API_KEY"

  3. 填入您的資訊

    • YOUR_UPSTASH_REDIS_REST_URL：替換成您在 Upstash 控制台中找到的 Redis 資料庫的 REST URL。
    • YOUR_UPSTASH_REDIS_REST_TOKEN：替換成您在 Upstash 控制台中找到的 Redis 資料庫的 Read-Write Token (讀寫權杖)。
    • YOUR_CONTEXT7_API_KEY：這是一個您 自己定義 的密鑰。這個密鑰將用於保護您的 Context7 API 端點。請設定一個強度足夠的密碼或隨機字串。在您的後端應用程式中，您也需要使用相同的 API 金鑰。

    範例：

    UPSTASH_REDIS_REST_URL="https://us1-shiny-dodo-12345.upstash.io"
UPSTASH_REDIS_REST_TOKEN="Abc...xyz"
CONTEXT7_API_KEY="a-very-strong-and-secret-key"

    完成後，儲存並關閉檔案。

第四步：啟動應用程式

所有設定都完成了，現在可以啟動 MCP 了。

  1. 運行開發伺服器
    在終端機中（確保您仍在 context7 目錄下），執行以下指令：

    npm run dev

  2. 查看結果
    您應該會看到類似以下的輸出，表示伺服器已經成功啟動：

    ✓ Ready in 1.2s
○ Compiling / ...
✓ Compiled / in 345ms
ready - started server on 0.0.0.0:3000, url: http://localhost:3000

  3. 打開瀏覽器
    打開您的網頁瀏覽器（如 Chrome、Safari 或 Firefox），並訪問以下網址：
    http://localhost:3000

如果一切順利，您現在應該能看到 Context7 MCP 的使用者介面了！

總結

  1. 安裝先決條件：Homebrew, Node.js, Git。
  2. 下載專案：git clone ...
  3. 安裝依賴：cd context7 然後 npm install。
  4. 設定金鑰：創建並編輯 .env.local 檔案，填入您的 Upstash 和自訂的 API 金鑰。
  5. 啟動服務：npm run dev。
  6. 訪問：在瀏覽器中打開 http://localhost:3000。

如果遇到問題，最常見的原因是 .env.local 檔案中的 URL 或 Token 不正確，請仔細檢查您從 Upstash 控制台複製的資訊是否完整無誤。

2