安装 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 的 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:
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:
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)。保持工具调用审批。