本指南介绍了如何使用 MCP Toolbox for Databases 将 Cloud SQL 实例连接到支持模型上下文协议 (MCP) 的各种集成开发环境 (IDE) 和开发者工具。您可以使用这些工具运行 SQL 查询并与数据库互动。
模型上下文协议 (MCP) 是一种开放协议，用于将大语言模型 (LLM) 连接到 Cloud SQL 等数据源。支持的 IDE 有：
- Cursor
- Windsurf
- Visual Studio Code (Copilot)
- Cline（VS Code 扩展程序）
- Claude Desktop
- Claude 代码
- Gemini CLI
- Gemini Code Assist
准备工作
在 Google Cloud 控制台的项目选择器页面上，选择或创建 Google Cloud 项目。
验证是否已为 Cloud SQL 实例设置公共 IP。默认情况下，Cloud SQL 会为新实例分配公共 IP 地址。Toolbox 使用 Cloud SQL 语言连接器安全地连接。
配置完成此任务所需的角色和权限。您需要 Cloud SQL > Client 角色 (
roles/cloudsql.client) 或等效的 Identity and Access Management 权限才能连接到该实例。为您的环境配置应用默认凭证 (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 Desktop
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 服务器图标。
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. 服务器成功连接后，系统会显示绿色的活跃状态。
光标
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. 打开 Cursor，然后依次前往“设置”>“Cursor 设置”>“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"
}
}
}
}
}
Windsurf
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 语句