搭配 MCP、Gemini CLI 和其他代理程式使用 MySQL 適用的 Cloud SQL

本頁說明如何將 Cloud SQL 執行個體連結至各種 AI 開發人員輔助工具,包括:

如要享有整合式體驗,建議使用適用於 MySQL 適用的 Cloud SQL 的 Gemini CLI 擴充功能。

Gemini CLI 是 Cloud de Confiance by S3NS的新一代指令列介面,直接將基礎技能整合至擴充功能,簡化設定程序。您可以設定 Gemini Code Assist 使用 Gemini CLI,在 IDE 中享有類似的設定優勢。

如要使用其他支援 Model Context Protocol (MCP) 的開發人員工具,可以手動設定 MCP Toolbox for Databases (Toolbox) 來連線。Toolbox 是開放原始碼 MCP 伺服器,可管理驗證和連線集區等工作,將 AI 代理連結至資料。這樣一來,您就能直接在 IDE 中使用自然語言與資料互動。對這些工具來說,這個方法提供核心資料庫互動功能。

詳情請參閱「預建工具」和 GitHub 上的 MCP Toolbox for Databases。

關於 Gemini CLI 和擴充功能

Gemini CLI 是開放原始碼 AI 代理,可協助編寫程式碼、偵錯、探索資料和創作內容,進而輔助開發工作流程。提供代理介面,可與資料庫、數據分析服務和熱門開放原始碼資料庫互動。

擴充功能的運作方式

Gemini CLI 具備高度擴充性,可透過擴充功能新增工具和功能。您可以從 GitHub 網址、本機目錄或可設定的註冊資料庫載入擴充功能。提供新工具、斜線指令、技能和提示,協助您處理工作流程。

在 MySQL 適用的 Cloud SQL 中使用 Gemini CLI 擴充功能

Cloud SQL Gemini CLI 擴充功能是以 MCP Toolbox for Databases 為基礎。

與 Gemini CLI 的整合是透過專屬擴充功能進行,與標準 Toolbox 連線相比,可提供額外功能。這項擴充功能提供簡化的安裝程序,以及一組以 MCP 工具為基礎的技能。

詳情請參閱 GitHub 說明文件,瞭解 Gemini CLI 擴充功能 (適用於 MySQL 適用的 Cloud SQL)。

Gemini CLI 的 MySQL 適用的 Cloud SQL 資料庫擴充功能

cloud-sql-mysql 擴充功能包含查詢資料庫和監控資料庫健康狀態的技能。

如要查看所有可用技能,請參閱 GitHub 上的 Cloud SQL 技能

cloud-sql-mysql-observability 擴充功能提供統一介面,可直接從 Gemini CLI 管理及監控資料庫效能和健康狀態。

類別 工具
觀測能力
  • get_system_metrics:擷取 Cloud SQL 執行個體的系統指標。
  • get_query_metrics:擷取 Cloud SQL 執行個體的查詢相關指標。

MySQL 資料庫專用的 Gemini CLI 擴充功能

如需這些作業的清單,請參閱「MCP Toolbox for Databases」和「MySQL 專用 Gemini CLI 擴充功能」。

事前準備

連結 Data Agent Kit

您可以使用 Google Cloud Data Agent Kit 擴充功能,從 Visual Studio Code 或任何以 VS Code 為基礎的 IDE 連線及查詢 Cloud SQL。您可以透過 IDE 連線至 MCP 伺服器、查詢資料,以及執行資料工程工作負載。Data Agent Kit 也提供 CLI 外掛程式。

詳情請參閱「Data Agent Kit 總覽」。

連結 Antigravity

您可以透過下列方式,將 MySQL 適用的 Cloud SQL 連線至 Antigravity:

  • 使用 MCP 伺服器庫
  • 使用自訂設定

MCP 伺服器庫

如要在 Antigravity 中連線至 MySQL 適用的 Cloud SQL,最建議的方法是使用內建的 MCP 伺服器庫。

  1. 開啟 Antigravity,然後開啟編輯器的代理面板。
  2. 按一下面板頂端的「...」圖示,然後選取「MCP 伺服器」。
  3. 在可用伺服器清單中,找到 MySQL 適用的 Cloud SQL,然後點選 安裝。
  4. 按照畫面上的指示,安全地連結帳戶 (如適用)。

在 MCP 伺服器庫安裝 MySQL 適用的 Cloud SQL 後,編輯器會自動提供伺服器的資源和工具。

自訂設定

如要連線至自訂 MCP 伺服器,請按照下列步驟操作:

  1. 開啟 Antigravity,然後開啟編輯器的代理面板。
  2. 按一下面板頂端的「...」圖示,然後選取「MCP 伺服器」。
  3. 依序點選「管理 MCP 伺服器」>「查看原始設定」,開啟 mcp_config.json 檔案。
  4. 新增下列設定,將環境變數替換為您的值,然後儲存。
{
  "mcpServers": {
    "cloud-sql-mysql": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-mysql","--stdio"],
      "env": {
          "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MYSQL_REGION": "REGION",
          "CLOUD_SQL_MYSQL_INSTANCE": "INSTANCE_ID",
          "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MYSQL_USER": "USER_ID",
          "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

設定自訂 MCP 伺服器後,編輯器就能使用 MySQL 適用的 Cloud SQL 伺服器資源和工具。

安裝 MCP Toolbox

  1. 下載與作業系統和 CPU 架構對應的二進位檔。

    linux/amd64

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

    darwin/arm64

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

    darwin/amd64

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

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox
  2. 將該二進位檔設為可執行:
    chmod +x toolbox
  3. 使用下列指令確認安裝成功:
    ./toolbox --version

設定 MCP 用戶端

本節說明如何設定各種開發人員工具,以便使用 Toolbox 連線至 Cloud SQL 執行個體。Toolbox 是開放原始碼的 Model Context Protocol (MCP) 伺服器,位於 IDE 和資料庫之間,可為 AI 工具提供安全高效的控制層。選取特定工具的分頁標籤,查看設定操作說明。

MySQL 適用的 Cloud SQL 專用 Gemini CLI


  1. 安裝 Gemini CLI。
  2. 使用下列指令,從 GitHub 存放區安裝 Gemini CLI 的 MySQL 適用的 Cloud SQL 擴充功能:
    gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-mysql
    
    安裝擴充功能時,請替換下列內容:
    export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME"
    export CLOUD_SQL_MYSQL_REGION="REGION"
    export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME"
    export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME"
    export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME"
    export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD"
    export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
    
    更改下列內容:
    • PROJECT_NAME: Cloud de Confiance 專案 ID。
    • REGION:Cloud SQL 執行個體的區域。
    • INSTANCE_NAME:Cloud SQL 執行個體的 ID。
    • DATABASE_NAME:要連線的資料庫名稱。
    • DATABASE_USER_NAME::選用:資料庫使用者名稱。如未指定,則預設為 IAM 驗證。
    • PASSWORD:選用:資料庫使用者的密碼。如未指定,則預設為 IAM 驗證。
    • IP_TYPE:選用。IP 類型,例如「Public」(預設) 或「Private」。
  3. 在互動模式下啟動 Gemini CLI:
    gemini

    CLI 會自動載入 Cloud SQL 的 Gemini CLI 擴充功能和工具,您可以使用這些工具與資料庫互動。

    在 Gemini CLI 中,使用 /extensions 指令確認擴充功能已安裝,並使用 /mcp list 指令查看工具。

MySQL 適用的 Gemini CLI


  1. 安裝 Gemini CLI。
  2. 使用下列指令,從 GitHub 存放區安裝 Gemini CLI 的 MySQL 軟體擴充功能:
    gemini extensions install https://github.com/gemini-cli-extensions/mysql
    安裝擴充功能時,請替換下列項目:
    export MYSQL_HOST="HOST"
    export MYSQL_PORT="PORT"
    export MYSQL_DATABASE="DATABASE"
    export MYSQL_USER="USER"
    export MYSQL_PASSWORD="PASSWORD"
    export MYSQL_QUERY_PARAMETERS="QUERY_PARAMETERS"
    
    更改下列內容:
    • HOST:MySQL 伺服器的主機名稱或 IP 位址。
    • PORT:MySQL 伺服器的通訊埠編號。
    • DATABASE:要連線的資料庫名稱。
    • USER:資料庫使用者名稱。
    • PASSWORD:資料庫使用者的密碼。
    • QUERY_PARAMETERS:選用。要新增至 db 連線字串的原始查詢。
  3. 在互動模式下啟動 Gemini CLI:
    gemini

    CLI 會自動載入 Gemini CLI 的 MySQL 擴充功能和工具,您可以使用這些工具與資料庫互動。

Gemini Code Assist


  1. 在 Visual Studio Code 中安裝 Gemini Code Assist 擴充功能。
  2. 在 Gemini Code Assist 對話中啟用代理模式。
  3. 在目前使用的目錄中,建立名為 .gemini 的資料夾。在其中建立 settings.json 檔案。
  4. 新增下列設定,將環境變數替換為您的值,然後儲存:

    {
      "mcpServers": {
        "cloud-sql-mysql": {
          "command": "./PATH/TO/toolbox",
          "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
          "env": {
              "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
              "CLOUD_SQL_MYSQL_REGION": "REGION",
              "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
              "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
              "CLOUD_SQL_MYSQL_USER": "USER_ID",
              "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
          }
        }
      }
    }
    

Claude Code


  1. 安裝 Claude Code。
  2. 設定環境變數,連線至 Cloud SQL 執行個體:
    export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME"
    export CLOUD_SQL_MYSQL_REGION="REGION"
    export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME"
    export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME"
    export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME"
    export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD"
    export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
    
    更改下列內容:
    • PROJECT_NAME: Cloud de Confiance 專案 ID。
    • REGION:Cloud SQL 執行個體的區域。
    • INSTANCE_NAME:Cloud SQL 執行個體的 ID。
    • DATABASE_NAME:要連線的資料庫名稱。
    • DATABASE_USER_NAME::選用:資料庫使用者名稱。如未指定,則預設為 IAM 驗證。
    • PASSWORD:選用:資料庫使用者的密碼。如未指定,則預設為 IAM 驗證。
    • IP_TYPE:選用。IP 類型,例如「Public」(預設) 或「Private」。
  3. 啟動代理:
    claude
  4. 安裝外掛程式:
    /plugin install cloud-sql-mysql@claude-plugins-official

Claude 電腦版


  1. 開啟 Claude Desktop,然後前往「設定」。
  2. 在「開發人員」分頁下方,輕觸「編輯設定」開啟設定檔。
  3. 新增下列內容,連至 MCP 伺服器並設定環境變數:

    {
      "mcpServers": {
        "cloud-sql-mysql": {
          "command": "./PATH/TO/toolbox",
          "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
          "env": {
            "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
            "CLOUD_SQL_MYSQL_REGION": "REGION",
            "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
            "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
            "CLOUD_SQL_MYSQL_USER": "USER_ID",
            "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
          }
        }
      }
    }
    
  4. 重新啟動 Claude Desktop。新的對話畫面會顯示 MCP 圖示,以及可用的新 MCP 伺服器。

Codex


  1. 安裝 Data Cloud 外掛程式市集:
    codex plugin marketplace add GoogleCloudPlatform/data-cloud-plugins
  2. 安裝外掛程式:
    codex plugin install cloud-sql-mysql@data-cloud-plugins
  3. 設定環境變數,連線至 Cloud SQL 執行個體:
    export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME"
    export CLOUD_SQL_MYSQL_REGION="REGION"
    export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME"
    export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME"
    export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME"
    export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD"
    export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
    更改下列內容:
    • PROJECT_NAME: Cloud de Confiance 專案 ID。
    • REGION:Cloud SQL 執行個體的區域。
    • INSTANCE_NAME:Cloud SQL 執行個體的 ID。
    • DATABASE_NAME:要連線的資料庫名稱。
    • DATABASE_USER_NAME::選用:資料庫使用者名稱。如未指定,則預設為 IAM 驗證。
    • PASSWORD:選用:資料庫使用者的密碼。如未指定,則預設為 IAM 驗證。
    • IP_TYPE:選用。IP 類型,例如「Public」(預設) 或「Private」。
  4. 選用。更新市集:
    codex plugin marketplace upgrade data-agent-plugins
  5. 執行 codex plugin list 或使用 plugins 互動式選單,驗證已安裝的外掛程式。

Cline


  1. 在 VS Code 開啟 Cline 擴充功能,然後輕觸「MCP 伺服器」圖示。
  2. 輕觸「設定 MCP 伺服器」,開啟設定檔。
  3. 新增下列設定,將環境變數替換為您的值,然後儲存:
    {
      "mcpServers": {
        "cloud-sql-mysql": {
          "command": "./PATH/TO/toolbox",
          "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
          "env": {
            "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
            "CLOUD_SQL_MYSQL_REGION": "REGION",
            "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
            "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
            "CLOUD_SQL_MYSQL_USER": "USER_ID",
            "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
          }
        }
      }
    }
    
    伺服器連線成功後,會顯示綠色的「有效」狀態。

Cursor


  1. 如果專案根目錄中沒有 .cursor 目錄,請建立該目錄。
  2. 如果 .cursor/mcp.json 檔案不存在,請建立並開啟該檔案。
  3. 新增下列設定,將環境變數替換為您的值,然後儲存:
    {
      "mcpServers": {
        "cloud-sql-mysql": {
          "command": "./PATH/TO/toolbox",
          "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
          "env": {
            "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
            "CLOUD_SQL_MYSQL_REGION": "REGION",
            "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
            "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
            "CLOUD_SQL_MYSQL_USER": "USER_ID",
            "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
          }
        }
      }
    }
    
  4. 開啟 Cursor,然後依序前往「Settings」>「Cursor Settings」>「MCP」。伺服器連線後,會顯示綠色的「有效」狀態。

Visual Studio Code (Copilot)


  1. 開啟 VS Code,並在專案根目錄中建立 .vscode 目錄 (如果尚未建立)。
  2. 如果 .vscode/mcp.json 檔案不存在,請建立並開啟該檔案。
  3. 新增下列設定,將環境變數替換為您的值,然後儲存:
    {
      "servers": {
        "cloud-sql-mysql": {
          "command": "./PATH/TO/toolbox",
          "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
          "env": {
            "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
            "CLOUD_SQL_MYSQL_REGION": "REGION",
            "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
            "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
            "CLOUD_SQL_MYSQL_USER": "USER_ID",
            "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
          }
        }
      }
    }
    
    

風浪板


  1. 開啟 Windsurf,然後前往 Cascade 助理。
  2. 輕觸 MCP 圖示,然後輕觸「設定」開啟設定檔。
  3. 新增下列設定,將環境變數替換為您的值,然後儲存:
    {
      "mcpServers": {
        "cloud-sql-mysql": {
          "command": "./PATH/TO/toolbox",
          "args": ["--prebuilt","cloud-sql-mysql","--stdio"],
          "env": {
              "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
              "CLOUD_SQL_MYSQL_REGION": "REGION",
              "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
              "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
              "CLOUD_SQL_MYSQL_USER": "USER_ID",
              "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
          }
        }
      }
    }