安装 Cloud SQL for MySQL 插件
安装 cloud-sql-mysql@data-agent-kit,配置 ADC 和 CLOUD_SQL_MYSQL_* 实例参数,通过本地 MCP 连接 Cloud SQL。
安装 cloud-sql-mysql@data-agent-kit,配置 ADC 和 CLOUD_SQL_MYSQL_* 实例参数,通过本地 MCP 连接 Cloud SQL。
这是 gemini-cli-extensions/cloud-sql-mysql 的 Codex 专节。插件把 MCP Toolbox 的预置 cloud-sql-mysql 封装为插件,用 ADC 加实例连接参数连 Cloud SQL for MySQL,用于管理实例、查看 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_MYSQL_PROJECT=YOUR_CLOUD_SQL_MYSQL_PROJECT
export CLOUD_SQL_MYSQL_REGION=YOUR_CLOUD_SQL_MYSQL_REGION
export CLOUD_SQL_MYSQL_INSTANCE=YOUR_CLOUD_SQL_MYSQL_INSTANCE
export CLOUD_SQL_MYSQL_DATABASE=YOUR_CLOUD_SQL_MYSQL_DATABASE
# 可选:CLOUD_SQL_MYSQL_USER、CLOUD_SQL_MYSQL_PASSWORD、CLOUD_SQL_MYSQL_IP_TYPE(PUBLIC / PRIVATE / PSC,默认 PUBLIC)
用户和密码可留空,默认走本机 IAM 数据库用户,实例里也要加这个 IAM 用户。私有网络必须把 Codex 跑在同一 VPC。不要把密码写进 http_headers。
清单 .agents/plugins/marketplace.json 的 name 是 data-agent-kit,插件 name 和 MCP 表名都是 cloud-sql-mysql:
codex --version
codex plugin marketplace add GoogleCloudPlatform/data-agent-kit
codex plugin add cloud-sql-mysql@data-agent-kit
codex plugin list
codex mcp list
IDE 扩展没有 /plugins。
插件会登记一台 stdio MCP,表名是 cloud-sql-mysql。command 是 npx,args 指定 @toolbox-sdk/server@1.9.0 --prebuilt cloud-sql-mysql --stdio。不要 codex mcp login cloud-sql-mysql。插件已经带 MCP 时,不要再 codex mcp add cloud-sql-mysql -- npx @toolbox-sdk/server 叠一张用户层表。
可选:codex plugin marketplace upgrade data-agent-kit 后再 plugin add 一次。0.154 起先看当前会话的 /plugins 和 /mcp;没有再新开。codex mcp list 里应有 cloud-sql-mysql。连接失败先看 ADC 和四个必填 CLOUD_SQL_MYSQL_* 是不是进了同一进程,以及 npx 能不能拉到 Toolbox 1.9.0。发行仍是 Beta(pre-v1.0)。保持工具调用审批。