本頁面由 Cloud Translation API 翻譯而成。

將 IDE 連線至 Cloud SQL

MySQL | PostgreSQL | SQL Server

本指南說明如何使用 MCP Toolbox for Databases，將 Cloud SQL 執行個體連線至支援模型上下文協定 (MCP) 的各種整合開發環境 (IDE) 和開發人員工具。使用這些工具執行 SQL 查詢，並與資料庫互動。

模型上下文協定 (MCP) 是一種開放式通訊協定，可將大型語言模型 (LLM) 連線至 Cloud SQL 等資料來源。支援的 IDE 如下：

Cursor
Windsurf
Visual Studio Code (Copilot)
Cline(VS Code 擴充功能)
Claude 電腦版
Claude 程式碼
Gemini CLI
Gemini Code Assist

事前準備

在 Google Cloud 控制台的專案選擇器頁面中，選取或建立 Google Cloud 專案。
確認您已為 Google Cloud專案啟用計費功能。
在 Google Cloud專案中啟用 Cloud SQL Admin API。
確認 Cloud SQL 執行個體已設定公開 IP。根據預設，Cloud SQL 會為新執行個體指派公開 IP 位址。Toolbox 會使用 Cloud SQL 語言連接器安全連線。
設定完成這項工作所需的角色和權限。您需要 Cloud SQL > 用戶端角色 (roles/cloudsql.client) 或同等的身分與存取權管理權限，才能連線至執行個體。
為環境設定應用程式預設憑證 (ADC)。
建立或重複使用資料庫使用者，並準備好使用者名稱和密碼。

安裝 MCP Toolbox

如要安裝工具箱，請下載與作業系統和 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

將二進位檔設為可執行檔：
```
chmod +x toolbox
```
使用下列指令驗證安裝作業：
```
./toolbox --version
```

設定 MCP 用戶端

Claude 代碼

1. 安裝 Claude Code。
2. 如果專案根目錄中沒有 .mcp.json 檔案，請建立該檔案。
3. 新增設定、將環境變數換成您的值，然後儲存：


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Claude 電腦版

1. 開啟 Claude Desktop，然後前往「設定」。
2. 在「開發人員」分頁下方，輕觸「編輯設定」開啟設定檔。
3. 新增設定、將環境變數換成您的值，然後儲存：


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

5. 重新啟動 Claude Desktop。
6. 新的即時通訊畫面會顯示槌子 (MCP) 圖示，表示有新的 MCP 伺服器可用。

Cline

1. 在 VS Code 中開啟 Cline 擴充功能，然後輕觸「MCP Servers」圖示。
2. 輕觸「設定 MCP 伺服器」開啟設定檔。
3. 新增下列設定，將環境變數替換為您的值，然後儲存：


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

4. 伺服器連線成功後，會顯示綠色的「有效」狀態。

Cursor

1. 如果專案根目錄中沒有 .cursor 目錄，請建立該目錄。
2. 如果 .cursor/mcp.json 檔案不存在，請建立並開啟該檔案。
3. 新增下列設定，將環境變數替換為您的值，然後儲存：


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

4. 開啟「游標」，然後依序前往「設定」>「游標設定」>「MCP」。伺服器連線後，會顯示綠色的「有效」狀態。

Visual Studio Code (Copilot)

1. 開啟 VS Code，並在專案根目錄中建立 .vscode 目錄 (如果不存在)。
2. 如果 .vscode/mcp.json 檔案不存在，請建立並開啟該檔案。
3. 新增下列設定，將環境變數替換為您的值，然後儲存：


{
  "mcp" : {
    "servers": {
      "cloud-sql-sqlserver": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
        "env": {
          "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MSSQL_REGION": "REGION",
          "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
          "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
          "CLOUD_SQL_MSSQL_USER": "USER_ID",
          "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
        }
      }
    }
  }
}

滑浪風帆

1. 開啟 Windsurf，然後前往 Cascade 助理。
2. 輕觸 MCP 圖示，然後輕觸「設定」開啟設定檔。
3. 新增下列設定，將環境變數替換為您的值，然後儲存：


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Gemini CLI

1. 安裝 Gemini CLI。
2. 在工作目錄中，建立名為 .gemini 的資料夾。在其中建立 settings.json 檔案。
3. 新增下列設定，將環境變數替換為您的值，然後儲存：


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Gemini Code Assist

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


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

使用工具

您的 AI 工具現已透過 MCP 連線至 Cloud SQL。你可以要求 AI 助理列出資料表、建立資料表，或是定義及執行其他 SQL 陳述式。

LLM 可使用下列工具：

list_tables：列出資料表和說明
execute_sql：執行任何 SQL 陳述式