---
title: "安装 PostgreSQL 插件"
summary: "从 gemini-cli-extensions/postgres 安装 postgres@postgres，通过 POSTGRES_* 参数连接数据库。本地 MCP 服务名为 postgresql。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "PostgreSQL", "MCP", "postgres@postgres"]
canonical: /tips/postgres-codex-plugin/
---

# 安装 PostgreSQL 插件

从 gemini-cli-extensions/postgres 安装 postgres@postgres，通过 POSTGRES_* 参数连接数据库。本地 MCP 服务名为 postgresql。

从 gemini-cli-extensions/postgres 安装 postgres@postgres，通过 POSTGRES_* 参数连接数据库。本地 MCP 服务名为 postgresql。

这是 [gemini-cli-extensions/postgres](https://github.com/gemini-cli-extensions/postgres) 的 Codex 专节。插件把 MCP Toolbox 的预置 `postgres` 封装为插件，用数据库用户连任意 PostgreSQL 实例，用于查看 schema 和执行 SQL。认证是库用户，**不是** GCP ADC。

要 Codex **v0.150.0+**，本机有 Node / npx。先有一台能连的 PostgreSQL，再在启动 Codex 的同一 shell 里导出：

```bash
export POSTGRES_DATABASE=YOUR_POSTGRES_DATABASE
export POSTGRES_USER=YOUR_POSTGRES_USER
export POSTGRES_PASSWORD=YOUR_POSTGRES_PASSWORD
# 可选：POSTGRES_HOST（默认 localhost）、POSTGRES_PORT（默认 5432）、POSTGRES_QUERY_PARAMS
```

不要把密码写进 `http_headers`。该 stdio 服务 **不要** `mcp login`。

清单 `.claude-plugin/marketplace.json` 的 name 是 `postgres`，插件 name 也是 `postgres`（`plugin.json` 0.2.3）。Toolbox 预置是 `postgres`，MCP 表名却是 `postgresql`：

```bash
codex --version
codex plugin marketplace add gemini-cli-extensions/postgres
codex plugin add postgres@postgres
codex plugin list
codex mcp list
```

IDE 扩展没有 `/plugins`。

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


可选：`codex plugin marketplace upgrade postgres` 后再 `plugin add` 一次。0.154 起先看当前会话的 `/plugins` 和 `/mcp`；没有再新开。`codex mcp list` 里应有 `postgresql`。连接失败先看 `POSTGRES_DATABASE` / `POSTGRES_USER` / `POSTGRES_PASSWORD` 是不是进了同一进程，以及 npx 能不能拉到 Toolbox 1.10.0。发行仍是 Beta（pre-v1.0）。`execute_sql` 能改数据，保持工具调用审批。

## 来源

- [gemini-cli-extensions/postgres](https://github.com/gemini-cli-extensions/postgres)
- [MCP Toolbox · PostgreSQL prebuilt](https://mcp-toolbox.dev/integrations/postgres/prebuilt-configs/postgresql/)
- [MCP Toolbox · PostgreSQL using MCP](https://mcp-toolbox.dev/documentation/connect-to/ides/postgres_mcp/)