---
title: "安装 Cloud SQL for SQL Server 插件"
summary: "安装 cloud-sql-sqlserver@data-agent-kit，配置 ADC、CLOUD_SQL_MSSQL_* 参数及必填的数据库用户名和密码。MCP 服务名为 cloud-sql-mssql。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "Cloud SQL", "SQL Server", "MCP", "Google Cloud", "data-agent-kit"]
canonical: /tips/cloudsql-sqlserver-codex-plugin/
---

# 安装 Cloud SQL for SQL Server 插件

安装 cloud-sql-sqlserver@data-agent-kit，配置 ADC、CLOUD_SQL_MSSQL_* 参数及必填的数据库用户名和密码。MCP 服务名为 cloud-sql-mssql。

安装 cloud-sql-sqlserver@data-agent-kit，配置 ADC、CLOUD_SQL_MSSQL_* 参数及必填的数据库用户名和密码。MCP 服务名为 cloud-sql-mssql。

这是 [gemini-cli-extensions/cloud-sql-sqlserver](https://github.com/gemini-cli-extensions/cloud-sql-sqlserver) 的 Codex 专节。插件把 MCP Toolbox 的预置 `cloud-sql-mssql` 封装为插件，用 ADC 加 SQL 用户连 Cloud SQL for SQL Server，用于管理实例、查看 schema 和执行 SQL。

要 Codex **v0.117.0+**，本机有 Node / npx。先开 Cloud SQL Admin API，IAM 至少 `roles/cloudsql.client`（管资源再加 `roles/cloudsql.admin`），再准备 ADC：

```bash
gcloud auth application-default login
export CLOUD_SQL_MSSQL_PROJECT=YOUR_CLOUD_SQL_MSSQL_PROJECT
export CLOUD_SQL_MSSQL_REGION=YOUR_CLOUD_SQL_MSSQL_REGION
export CLOUD_SQL_MSSQL_INSTANCE=YOUR_CLOUD_SQL_MSSQL_INSTANCE
export CLOUD_SQL_MSSQL_DATABASE=YOUR_CLOUD_SQL_MSSQL_DATABASE
export CLOUD_SQL_MSSQL_USER=YOUR_CLOUD_SQL_MSSQL_USER
export CLOUD_SQL_MSSQL_PASSWORD=YOUR_CLOUD_SQL_MSSQL_PASSWORD
# 可选：CLOUD_SQL_MSSQL_IP_TYPE（PUBLIC / PRIVATE / PSC，默认 PUBLIC）
```

插件仓 `plugin.json` 把用户和密码标成必填，不要按 Postgres / MySQL 那套省略成 IAM 数据库用户。私有网络必须把 Codex 跑在同一 VPC。不要把密码写进 `http_headers`。

清单 `.agents/plugins/marketplace.json` 的 name 是 `data-agent-kit`，插件 name 是 `cloud-sql-sqlserver`。MCP 表名和 Toolbox 预置都是 `cloud-sql-mssql`：

```bash
codex --version
codex plugin marketplace add GoogleCloudPlatform/data-agent-kit
codex plugin add cloud-sql-sqlserver@data-agent-kit
codex plugin list
codex mcp list
```

IDE 扩展没有 `/plugins`。

插件会登记一台 **stdio** MCP，表名是 `cloud-sql-mssql`。command 是 `npx`，args 指定 `@toolbox-sdk/server@1.9.0 --prebuilt cloud-sql-mssql --stdio`。**不要** `codex mcp login cloud-sql-mssql`。插件已经带 MCP 时，不要再 `codex mcp add cloud-sql-mssql -- npx @toolbox-sdk/server` 叠一张用户层表。


可选：`codex plugin marketplace upgrade data-agent-kit` 后再 `plugin add` 一次。0.154 起先看当前会话的 `/plugins` 和 `/mcp`；没有再新开。`codex mcp list` 里应有 `cloud-sql-mssql`。连接失败先看 ADC、六个必填 `CLOUD_SQL_MSSQL_*` 是不是进了同一进程，以及 npx 能不能拉到 Toolbox 1.9.0。发行仍是 Beta（pre-v1.0）。保持工具调用审批。

## 来源

- [gemini-cli-extensions/cloud-sql-sqlserver](https://github.com/gemini-cli-extensions/cloud-sql-sqlserver)
- [GoogleCloudPlatform/data-agent-kit](https://github.com/GoogleCloudPlatform/data-agent-kit)
- [Google Cloud · Use Cloud SQL for SQL Server with MCP](https://docs.cloud.google.com/sql/docs/sqlserver/pre-built-tools-with-mcp-toolbox)