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

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

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

事前準備

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

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

  3. 啟用 AlloyDB Admin API。

    啟用 API

必要的角色

如要管理 AlloyDB 資源，請要求管理員授予您專案的下列身分與存取權管理角色：

  • 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 Toolbox 將 IDE 連線至 AlloyDB for PostgreSQL」。使用指定的控制層工具，以公開 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 換成產生的權杖，然後儲存。

{
  "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-create-user：為 AlloyDB 叢集建立 ALLOYDB_BUILT_IN 或 IAM 型使用者。
  • alloydb-get-operation：輪詢 Operations API，直到作業完成為止。
  • alloydb-list-clusters：列出指定專案和位置的叢集。
  • alloydb-list-instances：列出指定專案和位置的執行個體。
  • alloydb-list-users：列出特定專案和位置的使用者。

連結至資料

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