在 IDE 中使用 MCP Toolbox 建立 AlloyDB 資料庫

本頁說明如何使用 MCP Toolbox for Databases，從整合式開發環境 (IDE) 建立及管理 PostgreSQL 適用的 AlloyDB 叢集和執行個體。您可以使用支援模型上下文協定 (MCP) 的開發人員工具。

Model Context Protocol (MCP) 是一種開放通訊協定，可將大型語言模型 (LLM) 連線至資料來源和 API，例如 AlloyDB Admin API。AI 助理是 IDE 中的 LLM 驅動對話介面，可協助您達成目標及完成工作。本頁說明如何使用 MCP Toolbox for Databases，透過下列 IDE 將開發人員助理工具公開給 AlloyDB 執行個體：

事前準備

  1. 在 Google Cloud 控制台的專案選擇器頁面中，選取或建立 Google Cloud 專案。

  2. 請確認您已為 Google Cloud 專案啟用計費功能。瞭解如何檢查專案是否已啟用計費功能。

  3. 啟用 AlloyDB Admin API。

    啟用 API

必要的角色

如要管理 AlloyDB 資源，請要求管理員授予您專案的下列 Identity and Access Management 角色：

  • AlloyDB 管理員 (roles/alloydb.admin)。
  • 服務使用情形消費者 (roles/serviceusage.serviceUsageConsumer)。

安裝 MCP Toolbox

  1. 以二進位檔形式下載最新版 MCP Toolbox。選取與作業系統 (OS) 和 CPU 架構對應的二進位檔。您必須使用 MCP Toolbox V0.10.0 以上版本。

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/linux/amd64/toolbox

    darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/darwin/arm64/toolbox

    darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/darwin/amd64/toolbox

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/windows/amd64/toolbox

  2. 將二進位檔設為可執行檔。

    chmod +x toolbox

  3. 驗證安裝。

    ./toolbox --version

設定 MCP 用戶端

您可以設定 IDE，使用控制平面工具建立及管理 AlloyDB 叢集和執行個體。如果您已有 AlloyDB 執行個體，請略過這個步驟，並前往「使用 MCP 工具箱將 IDE 連線至 PostgreSQL 適用的 AlloyDB」。使用指定的控制層工具建立執行個體時，會一併建立公開 IP 位址。在 IDE 的 MCP 設定檔中新增下列設定。這種做法會將 alloydb-postgres-admin 工具提供給 AI 助理。

Claude 代碼

  1. 安裝 Claude Code。
  2. 在專案根目錄中建立 .mcp.json 檔案 (如果不存在)。
  3. 執行 gcloud auth print-access-token，產生要當做 API_KEY 使用的存取權杖。
  1. 新增下列設定，將 API_KEY 換成產生的權杖，然後儲存。
{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Claude 電腦版

  1. 開啟 Claude Desktop，然後前往「設定」。
  2. 在「開發人員」分頁中，按一下「編輯設定」開啟設定檔。
  3. 執行 gcloud auth print-access-token，產生要當做 API_KEY 使用的存取權杖。

  1. 新增下列設定，將 API_KEY 換成產生的權杖，然後儲存。

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Cline

  1. 在 VS Code 中開啟 Cline 擴充功能，然後輕觸「MCP Servers」圖示。
  2. 輕觸「設定 MCP 伺服器」開啟設定檔。
  3. 執行 gcloud auth print-access-token，產生要當做 API_KEY 使用的存取權杖。

  1. 新增下列設定，將 API_KEY 換成產生的權杖，然後儲存。

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Cursor

  1. 如果專案根目錄中沒有 .cursor 目錄，請建立該目錄。
  2. 如果 .cursor/mcp.json 檔案不存在，請建立並開啟該檔案。
  3. 執行 gcloud auth print-access-token，產生要當做 API_KEY 使用的存取權杖。
  1. 新增下列設定，將 API_KEY 換成產生的權杖，然後儲存：

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Visual Studio Code (Copilot)

  1. 開啟 VS Code，並在專案根目錄中建立 .vscode 目錄 (如果不存在)。
  2. 如果 .vscode/mcp.json 檔案不存在，請建立並開啟該檔案。
  3. 執行 gcloud auth print-access-token，產生要當做 API_KEY 使用的存取權杖。
  1. 新增下列設定，將 API_KEY 換成產生的權杖，然後儲存。

{
  "mcp":{
    "servers": {
      "alloydb-admin": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
        "env": {
          "API_KEY": "API_KEY"
        }
      }
    }
  }
}

滑浪風帆

  1. 開啟 Windsurf，然後前往 Cascade 助理。
  2. 按一下 MCP 圖示，然後點選「設定」開啟設定檔。
  3. 執行 gcloud auth print-access-token，產生要當做 API_KEY 使用的存取權杖。

  1. 新增下列設定，將 API_KEY 換成產生的權杖，然後儲存。

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Gemini CLI

  1. 安裝 Gemini CLI。
  2. 在工作目錄中，建立名為 .gemini 的資料夾。在其中建立 settings.json 檔案。
  3. 執行 gcloud auth print-access-token，產生要當做 API_KEY 使用的存取權杖。

  1. 新增下列設定，將 API_KEY 替換為產生的權杖，然後儲存。
{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Gemini Code Assist

  1. 在 Visual Studio Code 中安裝 Gemini Code Assist 擴充功能。
  2. 在 Gemini Code Assist 對話中啟用代理程式模式。
  3. 在工作目錄中，建立名為 .gemini 的資料夾。在其中建立 settings.json 檔案。
  4. 執行 gcloud auth print-access-token，產生要當做 API_KEY 使用的存取權杖。

  1. 新增下列設定，將 API_KEY 換成產生的權杖，然後儲存：

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

現在，您的 AI 工具已透過 MCP 連線至 PostgreSQL 適用的 AlloyDB 控制平面。要求 AI 助理建立叢集或執行個體。

使用管理員工具

LLM 可使用下列工具：

  • alloydb-create-cluster：建立 AlloyDB 叢集。
  • alloydb-create-instance：建立 AlloyDB 執行個體 (PRIMARY、READ_POOL 或 SECONDARY)。
  • alloydb-get-operation：輪詢 Operations API，直到作業完成為止。

連結至資料

設定 AlloyDB 叢集和執行個體後，即可將 IDE 連線至資料庫，查詢資料。詳情請參閱「使用 MCP Toolbox 將 IDE 連線至 AlloyDB」。