Postgres plugin
Плагин Google для Gemini CLI, Claude Code и Codex подключает агента к PostgreSQL: схемы, запросы, индексы и планы выполнения.
- 95 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Инструмент `execute_sql` выполняет любой SQL, который разрешен роли, включая запись и удаление.
- Пароль базы хранится в переменных окружения или настройках плагина.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/postgres-pluginОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструмент `execute_sql` выполняет любой SQL, который разрешен роли, включая запись и удаление.
- Пароль базы хранится в переменных окружения или настройках плагина.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин подключает агента к вашему экземпляру PostgreSQL через MCP-сервер, который запускается командой `npx` из пакета `@toolbox-sdk/server`. Агент перечисляет таблицы, схемы, представления и последовательности, выполняет SQL-запросы и показывает план запроса через `get_query_plan`. Отдельные инструменты читают состояние сервера: активные запросы, статистику баз, настройки памяти и автовакуума, раздутые таблицы, битые индексы, слоты репликации и роли. Подходит для вопросов на обычном языке вроде «сколько заказов за 30 дней» и для генерации классов данных по схеме таблицы. Подключение задают переменные `POSTGRES_DATABASE`, `POSTGRES_USER` и `POSTGRES_PASSWORD`.
Для кого. Разработчикам и администраторам PostgreSQL, которые хотят разбирать схему и нагрузку базы из Gemini CLI, Claude Code или Codex.
Подходит, если
- Нужно быстро понять незнакомую схему: таблицы, столбцы, представления.
- Запрос тормозит, и агент должен показать план и найти недостающий индекс.
- В базе подозревают раздутые таблицы или битые индексы после миграции.
- Для таблицы требуется сгенерировать дата-класс на Python или другом языке.
Не подходит, если
- Нужна работа с облачными экземплярами Cloud SQL: для них у Google отдельное расширение.
- Подключение должно меняться внутри сессии: в Gemini CLI оно задается до запуска.
- Агенту запрещена запись в базу, но роль только на чтение создать нельзя.
Пример запроса к агенту
Покажи топ-5 самых заказываемых товаров за последние 30 дней и план этого запроса.Ограничения
Плагин в бете до версии 1.0, возможны несовместимые изменения. Нужны Node.js для `npx`, работающий PostgreSQL и пользователь с правами на запросы. Инструмент `execute_sql` выполняет любой SQL, который разрешает роль, поэтому выдайте роль только на чтение. Подключение к базе задается до запуска и в Gemini CLI не меняется в ходе сессии. При первом запуске `npx` скачивает пакет, нужен интернет. Манифест Gemini CLI требует версию 0.6.0 или новее, для Codex нужна версия 0.150.0 и выше.
Как отключить. В Claude Code выполните `/plugin` и удалите плагин, в Gemini CLI — `gemini extensions uninstall postgres`. Пароль из переменных окружения удалите отдельно.
Частые вопросы
Как поставить плагин в Claude Code?
Выполните `claude plugin marketplace add GoogleCloudPlatform/postgres-plugin`, затем `claude plugin install postgres@postgres`. Параметры подключения передайте флагами `--config KEY=VALUE`.
Какие переменные нужны для подключения?
Обязательны `POSTGRES_DATABASE`, `POSTGRES_USER` и `POSTGRES_PASSWORD`. Необязательны `POSTGRES_HOST` (по умолчанию `localhost`), `POSTGRES_PORT` (5432) и `POSTGRES_QUERY_PARAMS`.
Что делать при ошибке «spawn npx ENOENT»?
Установите Node.js: MCP-сервер запускается через `npx`. Если ошибка «Connection closed», проверьте переменные окружения подключения.
Какие агенты поддерживаются?
Gemini CLI от версии 0.6.0, Claude Code, Codex от 0.150.0 и Antigravity CLI. Плагин один на все четыре.
Может ли агент изменять данные?
Инструмент `execute_sql` выполняет любые запросы, которые разрешены роли. Для разбора схемы выдайте пользователю базы права только на чтение.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныpgEdge Postgres MCP
pgEdge Postgres MCP Server
Postgres MCP на Go с запросами в режиме чтения, планами EXPLAIN, поиском по смыслу, несколькими базами, чат-клиентом и веб-интерфейсом
MCP-сервер для PostgreSQL с несколькими базами сразу, описаниями таблиц из каталога, подсказками по PostGIS и pgvector и планами запросов
MCP-сервер и скиллы от TigerData, с которыми агент пишет схемы и запросы PostgreSQL по актуальной документации и практикам
Каталог плагинов Google Cloud для баз и аналитики: AlloyDB, Spanner, Bigtable, Firestore, Cloud SQL и Looker.
MCP-сервер для PostgreSQL: агент выполняет SQL, видит таблицы и схемы, запись в базу выключена, пока ее не разрешат явно
pgcli, терминальный клиент PostgreSQL, подсказывает имена по контексту SQL: таблицы после FROM и столбцы после WHERE.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Postgres plugin (эта карточка) | да | 95 | ||
| Postgres MCP Pro | нет | API-ключ | 3 469 | сторонний MCP-сервер с анализом индексов и здоровья; здесь официальный плагин Google для четырех агентов |
| Postgres MCP (Microsoft) | нет | ключ необязателен | 86 | сервер Microsoft для Azure Database for PostgreSQL; плагин Google работает с обычным PostgreSQL |
Коротко о README
Расширение входит в семейство расширений Gemini CLI от Google Cloud. В каталоге репозитория лежат манифесты для Gemini CLI, Claude Code и Codex, а сервер подключается одним описанием `.mcp.json`.