---
title: "安装 Oracle Database 插件"
summary: "安装 oracledb@data-agent-kit，通过 ORACLE_CONNECTION_STRING、用户名和密码连接 Oracle。默认使用薄客户端，钱包模式需要额外配置。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "Oracle", "MCP", "data-agent-kit"]
canonical: /tips/oracledb-codex-plugin/
---

# 安装 Oracle Database 插件

安装 oracledb@data-agent-kit，通过 ORACLE_CONNECTION_STRING、用户名和密码连接 Oracle。默认使用薄客户端，钱包模式需要额外配置。

安装 oracledb@data-agent-kit，通过 ORACLE_CONNECTION_STRING、用户名和密码连接 Oracle。默认使用薄客户端，钱包模式需要额外配置。

这是 [gemini-cli-extensions/oracledb](https://github.com/gemini-cli-extensions/oracledb) 的 Codex 专节。插件把 MCP Toolbox 的预置 `oracledb` 封装为插件，用连接串加用户密码连 Oracle，去跑 SQL、列会话、看执行计划和表空间。

要 Codex **v0.117.0+**，本机有 Node / npx。库权限至少 `CREATE SESSION`（看 `V$` / `DBA_` 再加 `SELECT`）。认证是数据库用户，**不是** GCP ADC：

```bash
export ORACLE_CONNECTION_STRING=YOUR_ORACLE_CONNECTION_STRING
export ORACLE_USERNAME=YOUR_ORACLE_USERNAME
export ORACLE_PASSWORD=YOUR_ORACLE_PASSWORD
# 可选：ORACLE_WALLET（钱包目录）
# 可选：ORACLE_USE_OCI=true（厚客户端；钱包要 Instant Client）
```

连接串填 `host:port/service_name` 或 TNS 别名，不要把密码写进 `http_headers`。开钱包时才设 `ORACLE_USE_OCI=true`，并装 Instant Client；默认走薄客户端。

清单 `.agents/plugins/marketplace.json` 的 name 是 `data-agent-kit`，插件 name 是 `oracledb`（`plugin.json` 0.2.7）。MCP 表名和 Toolbox 预置都是 `oracledb`，不要按 IDE 文档写成表名 `oracle`：

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

IDE 扩展没有 `/plugins`。

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


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

## 来源

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