---
title: "安装 Dataproc 插件"
summary: "安装 dataproc@data-agent-kit，配置 ADC、DATAPROC_PROJECT 和 DATAPROC_REGION，用于查询集群及作业状态。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "Dataproc", "MCP", "Google Cloud", "data-agent-kit"]
canonical: /tips/dataproc-codex-plugin/
---

# 安装 Dataproc 插件

安装 dataproc@data-agent-kit，配置 ADC、DATAPROC_PROJECT 和 DATAPROC_REGION，用于查询集群及作业状态。

安装 dataproc@data-agent-kit，配置 ADC、DATAPROC_PROJECT 和 DATAPROC_REGION，用于查询集群及作业状态。

这是 [gemini-cli-extensions/dataproc](https://github.com/gemini-cli-extensions/dataproc) 的 Codex 专节。插件把 MCP Toolbox 的预置 `dataproc` 封装为插件，用 ADC 连 Dataproc，去列集群、看作业、排查失败任务。

要 Codex **v0.117.0+**，本机有 Node / npx。先开 Dataproc API，IAM 至少 `roles/dataproc.viewer`（改集群再加 `roles/dataproc.editor`），再准备 ADC：

```bash
gcloud auth application-default login
export DATAPROC_PROJECT=YOUR_DATAPROC_PROJECT
export DATAPROC_REGION=YOUR_DATAPROC_REGION
```

区域必填，不要指望默认 `us-central1`。不要把密钥写进 `http_headers`。README 配置节还残留一句 Cloud SQL 私网 VPC 说明，那是拷贝痕迹，**不是** Dataproc 安装条件。

清单 `.agents/plugins/marketplace.json` 的 name 是 `data-agent-kit`，插件 name 是 `dataproc`（`plugin.json` 0.1.0）。MCP 表名和 Toolbox 预置都是 `dataproc`：

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

IDE 扩展没有 `/plugins`。

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


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

## 来源

- [gemini-cli-extensions/dataproc](https://github.com/gemini-cli-extensions/dataproc)
- [GoogleCloudPlatform/data-agent-kit](https://github.com/GoogleCloudPlatform/data-agent-kit)
- [MCP Toolbox · Dataproc prebuilt](https://mcp-toolbox.dev/integrations/dataproc/prebuilt-configs/dataproc/)