---
title: "安装 AlloyDB Omni 插件"
summary: "安装 alloydb-omni@data-agent-kit，使用 ALLOYDB_OMNI_* 参数连接实例。数据库名和用户名必填，密码要求取决于实例配置。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "AlloyDB Omni", "MCP", "Google Cloud", "data-agent-kit"]
canonical: /tips/alloydb-omni-codex-plugin/
---

# 安装 AlloyDB Omni 插件

安装 alloydb-omni@data-agent-kit，使用 ALLOYDB_OMNI_* 参数连接实例。数据库名和用户名必填，密码要求取决于实例配置。

安装 alloydb-omni@data-agent-kit，使用 ALLOYDB_OMNI_* 参数连接实例。数据库名和用户名必填，密码要求取决于实例配置。

这是 [gemini-cli-extensions/alloydb-omni](https://github.com/gemini-cli-extensions/alloydb-omni) 的 Codex 专节。插件把 MCP Toolbox 的预置 `alloydb-omni` 封装为插件，用数据库用户连本机 / 容器 / RPM 上的 AlloyDB Omni，用于查看 schema 和执行 SQL、看复制和列存。

要 Codex **v0.117.0+**，本机有 Node / npx，并且已经有一台在跑的 Omni 实例。这不是 Cloud AlloyDB，**不要** `gcloud auth application-default login`，也**不要**发明 `ALLOYDB_OMNI_PROJECT`：

```bash
export ALLOYDB_OMNI_DATABASE=YOUR_ALLOYDB_OMNI_DATABASE
export ALLOYDB_OMNI_USER=YOUR_ALLOYDB_OMNI_USER
export ALLOYDB_OMNI_PASSWORD=YOUR_ALLOYDB_OMNI_PASSWORD
# 可选：ALLOYDB_OMNI_HOST（默认 localhost）、ALLOYDB_OMNI_PORT（默认 5432）、ALLOYDB_OMNI_QUERY_PARAMS
```

`DATABASE` 和 `USER` 必填。`PASSWORD` 看实例（Toolbox 文档标可选）。不要把密码写进 `http_headers`。不要抄 `POSTGRES_HOST` / `POSTGRES_DATABASE`。

清单 `.agents/plugins/marketplace.json` 的 name 是 `data-agent-kit`，插件 name 和 MCP 表名都是 `alloydb-omni`：

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

IDE 扩展没有 `/plugins`。

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


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

## 来源

- [gemini-cli-extensions/alloydb-omni](https://github.com/gemini-cli-extensions/alloydb-omni)
- [GoogleCloudPlatform/data-agent-kit](https://github.com/GoogleCloudPlatform/data-agent-kit)
- [Google Cloud · Use AlloyDB Omni with MCP](https://docs.cloud.google.com/alloydb/omni/linux/current/docs/connect-ide-using-mcp-toolbox)