安装 BigQuery 插件

安装 bigquery-data-analytics@data-agent-kit,配置 ADC 和 BIGQUERY_PROJECT。插件通过 Toolbox 1.10.0 提供本地 bigquery MCP。

安装 bigquery-data-analytics@data-agent-kit,配置 ADC 和 BIGQUERY_PROJECT。插件通过 Toolbox 1.10.0 提供本地 bigquery MCP。

这是 gemini-cli-extensions/bigquery-data-analytics 的 Codex 专节。插件把 MCP Toolbox 的预置 bigquery 封装为插件,用 ADC 连项目,去搜表、跑 SQL、做贡献分析和预测。

要 Codex v0.117.0+,本机有 Node / npx。先开 BigQuery API,IAM 至少 roles/bigquery.user。要用内置 AI/ML 技能再开 Vertex AI API,并加 roles/bigquery.connectionUserroles/aiplatform.user。然后准备 ADC:

gcloud auth application-default login
export BIGQUERY_PROJECT=YOUR_BIGQUERY_PROJECT
# 可选:BIGQUERY_LOCATION

BIGQUERY_PROJECT 填 GCP 项目 ID,不要填项目号。位置可留空。密钥不要写进 http_headers

清单 .agents/plugins/marketplace.json 的 name 是 data-agent-kit。目录条目的 name 写成 bigquery,指向 gemini-cli-extensions/bigquery-data-analytics;插件仓 plugin.json 的 name 才是 bigquery-data-analytics。Codex 命令跟插件仓 README,不要按目录短名写成 plugin add bigquery@data-agent-kit

codex --version
codex plugin marketplace add GoogleCloudPlatform/data-agent-kit
codex plugin add bigquery-data-analytics@data-agent-kit
codex plugin list
codex mcp list

IDE 扩展没有 /plugins

插件会登记一台 stdio MCP,表名是 bigquery。command 是 npx,args 指定 @toolbox-sdk/server@1.10.0 --prebuilt bigquery --stdio(这份比 Looker / AlloyDB 的 1.9.0 新一档)。不要 codex mcp login bigquery。插件已经带 MCP 时,不要再 codex mcp add bigquery -- npx @toolbox-sdk/server 叠一张用户层表。

可选:codex plugin marketplace upgrade data-agent-kit 后再 plugin add 一次。目录条目可能钉旧 ref(当前常见是 0.2.1),插件仓 plugin.json 可能已经 0.2.5;升级后重新安装。0.154 起先看当前会话的 /plugins/mcp;没有再新开。codex mcp list 里应有 bigquery。连接失败先看 ADC 和 BIGQUERY_PROJECT 是不是进了同一进程,以及 npx 能不能拉到 Toolbox 1.10.0。发行仍是 Beta(pre-v1.0)。保持工具调用审批。

来源