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