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

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

如要享有整合式體驗，建議使用專用的 PostgreSQL 適用的 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 網址、本機目錄或可設定的註冊資料庫載入擴充功能。這些 Gem 提供新工具、斜線指令、技能和提示，可協助你完成工作流程。

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

Cloud SQL Gemini CLI 擴充功能是以資料庫專用的 MCP Toolbox 為基礎。

與 Gemini CLI 整合時，您會使用專屬擴充功能，與標準 Toolbox 連線相比，這項擴充功能提供更多功能。這項擴充功能提供簡化的安裝程序，以及以 MCP 工具為基礎的一系列技能。

詳情請參閱 適用於 PostgreSQL 的 Cloud SQL 的 Gemini CLI 擴充功能 GitHub 說明文件。

Gemini CLI 擴充功能，適用於 Cloud SQL for PostgreSQL 資料庫

cloud-sql-postgresql 擴充功能包含查詢資料庫、管理 Cloud SQL 資源，以及監控資料庫健康狀態的技能。

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

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

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

PostgreSQL 資料庫的 Gemini CLI 擴充功能

如需這些作業的清單，請參閱「資料庫適用的 MCP Toolbox」和「Gemini CLI 擴充功能 for PostgreSQL」。

事前準備

連結至 Antigravity

您可以透過下列方式將 PostgreSQL 適用的 Cloud SQL 連線至 Antigravity：

  • 使用 MCP 商店
  • 使用自訂設定

MCP 商店

在 Antigravity 中連線至 PostgreSQL 適用的 Cloud SQL 時，最建議使用內建的 MCP 儲存庫。

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

在 MCP 商店安裝 PostgreSQL 適用的 Cloud SQL 後，伺服器的資源和工具就會自動提供給編輯器使用。

自訂設定

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

  1. 開啟 Antigravity，然後開啟編輯器的代理程式面板。
  2. 按一下面板頂端的「...」圖示，然後選取「MCP Servers」(MCP 伺服器)。
  3. 依序點選「管理 MCP 伺服器」>「查看原始設定」，開啟 mcp_config.json 檔案。
  4. 新增下列設定，將環境變數換成您的值，然後儲存。
{
  "mcpServers": {
    "cloud-sql-postgres": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-postgres","--stdio"],
      "env": {
          "CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_POSTGRES_REGION": "REGION",
          "CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
          "CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_POSTGRES_USER": "USER_ID",
          "CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

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

安裝 MCP Toolbox

<div>
<devsite-selector>
<section>
<h3 id="linux-amd64">linux/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox</pre>
</section>
<section>
<h3 id="darwin-arm64">darwin/arm64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox</pre>
</section>
<section>
<h3 id="darwin-amd64">darwin/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox</pre>
</section>
<section>
<h3 id="windows-amd64">windows/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox</pre>
</section>
</devsite-selector>
</div>

  • 將該二進位檔設為可執行：

    ```bash
chmod +x toolbox
```

  • 使用下列指令驗證安裝作業：

    ```bash
./toolbox --version
```

    • 設定 MCP 用戶端

    本節說明如何設定各種開發人員工具，使用 Toolbox 連線至 Cloud SQL 執行個體。Toolbox 可做為開放原始碼的模型上下文協定 (MCP) 伺服器，位於 IDE 和資料庫之間，為 AI 工具提供安全有效率的控制層。選取特定工具的分頁標籤，即可查看設定操作說明。

    適用於 PostgreSQL 適用的 Cloud SQL 的 Gemini CLI


    1. 安裝 Gemini CLI。
    2. 使用下列指令，從 GitHub 存放區安裝 Gemini CLI 的 PostgreSQL 適用的 Cloud SQL 擴充功能：
            gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-postgresql
      安裝擴充功能時，請取代下列項目：
      • 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 指令查看工具。

    PostgreSQL 適用的 Gemini CLI


    1. 安裝 Gemini CLI。
    2. 使用下列指令，從 GitHub 存放區安裝 Gemini CLI 的 PostgreSQL 軟體擴充功能： 
            gemini extensions install https://github.com/gemini-cli-extensions/postgres
      安裝擴充功能時，請替換下列內容： 
            export POSTGRES_HOST="HOST"
      export POSTGRES_PORT="PORT"
      export POSTGRES_DATABASE="DATABASE"
      export POSTGRES_USER="USER"
      export POSTGRES_PASSWORD="PASSWORD"
      export POSTGRES_QUERY_PARAMETERS="QUERY_PARAMETERS"
      更改下列內容：
      • HOST：PostgreSQL 伺服器的主機名稱或 IP 位址。
      • PORT：PostgreSQL 伺服器的通訊埠號碼。
      • DATABASE：要連線的資料庫名稱。
      • USER：資料庫使用者名稱。
      • PASSWORD：資料庫使用者的密碼。
      • QUERY_PARAMETERS：(選填) 要加入 db 連線字串的原始查詢。
    3. 在互動模式下啟動 Gemini CLI： 
            gemini

      CLI 會自動載入 PostgreSQL 適用的 Gemini CLI 擴充功能及其工具，您可以使用這些工具與資料庫互動。

    Gemini Code Assist


    1. 在 Visual Studio Code 中安裝 Gemini Code Assist 擴充功能。
    2. 在 Gemini Code Assist 對話中啟用 Agent 模式。
    3. 在工作目錄中，建立名為 .gemini 的資料夾。在其中建立 settings.json 檔案。
    4. 新增下列設定，將環境變數替換為您的值，然後儲存： 
      
{
  "mcpServers": {
    "cloud-sql-postgres": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-postgres","--stdio"],
      "env": {
        "CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_POSTGRES_REGION": "REGION",
        "CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_POSTGRES_USER": "USER_ID",
        "CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
      }
    }
  }
}

    Claude 程式碼


    1. 安裝 Claude Code。
    2. 設定環境變數，連線至 Cloud SQL 執行個體： 
            export CLOUD_SQL_POSTGRES_PROJECT="PROJECT_NAME"
      export CLOUD_SQL_POSTGRES_REGION="REGION"
      export CLOUD_SQL_POSTGRES_INSTANCE="INSTANCE_NAME"
      export CLOUD_SQL_POSTGRES_DATABASE="DATABASE_NAME"
      export CLOUD_SQL_POSTGRES_USER="DATABASE_USER_NAME"
      export CLOUD_SQL_POSTGRES_PASSWORD="PASSWORD"
      export CLOUD_SQL_POSTGRES_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. 前往 PostgreSQL 適用的 Cloud SQL Skills 存放區尋找最新發布版本，然後新增市集：
            /plugin marketplace add https://github.com/gemini-cli-extensions/cloud-sql-postgresql.git#VERSION
    5. 安裝外掛程式： 
            /plugin install cloud-sql-postgresql@cloud-sql-postgresql-marketplace

    Claude 電腦版


    1. 開啟 Claude Desktop，然後前往「設定」。
    2. 在「開發人員」分頁下方，輕觸「編輯設定」開啟設定檔。
    3. 新增下列項目，連線至 MCP 伺服器並設定環境變數： 
      
{
  "mcpServers": {
    "cloud-sql-postgres": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-postgres","--stdio"],
      "env": {
        "CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_POSTGRES_REGION": "REGION",
        "CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_POSTGRES_USER": "USER_ID",
        "CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
    }
  }
}
}
    4. 重新啟動 Claude Desktop。新的即時通訊畫面會顯示 MCP 圖示，以及可用的新 MCP 伺服器。

    Cline


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

    Codex


    1. 在 PostgreSQL 適用的 Cloud SQL Skills 存放區中找到最新發布版本，然後複製該版本：
      git clone --branch VERSION git@github.com:gemini-cli-extensions/cloud-sql-postgresql.git
    2. 安裝外掛程式： 
      mkdir -p ~/.codex/plugins
cp -R /absolute/path/to/cloud-sql-postgresql ~/.codex/plugins/cloud-sql-postgresql
    3. 設定環境變數，連線至 Cloud SQL 執行個體： 
          export CLOUD_SQL_POSTGRES_PROJECT="PROJECT_NAME"
    export CLOUD_SQL_POSTGRES_REGION="REGION"
    export CLOUD_SQL_POSTGRES_INSTANCE="INSTANCE_NAME"
    export CLOUD_SQL_POSTGRES_DATABASE="DATABASE_NAME"
    export CLOUD_SQL_POSTGRES_USER="DATABASE_USER_NAME"
    export CLOUD_SQL_POSTGRES_PASSWORD="PASSWORD"
    export CLOUD_SQL_POSTGRES_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. 建立或更新 marketplace.json： 
      
{
  "name": "my-data-cloud-google-marketplace",
  "interface": {
    "displayName": "Google Data Cloud Skills"
  },
  "plugins": [
    {
      "name": "cloud-sql-postgresql",
      "source": {
        "source": "local",
        "path": "./plugins/cloud-sql-postgresql"
      },
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_INSTALL"
      },
      "category": "Database"
    }
  ]
}
    5. 執行 codex plugin list 或使用 plugins 互動式選單，驗證已安裝的外掛程式。

    Cline


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

    Cursor


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

    Visual Studio Code (Copilot)


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

    滑浪風帆


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