postgresai — плагин
Плагин для Claude Code разворачивает мониторинг PostgreSQL и приносит отчет с проблемами и точными исправлениями.
- 140 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Работает с учетными данными базы данных, создает на ней роль мониторинга и ведет к оплате подписки сервиса.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/postgresaiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Работает с учетными данными базы данных, создает на ней роль мониторинга и ведет к оплате подписки сервиса.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин pgai подключает к Claude Code скилл `postgresai` и команды `/pgai:checkup` и `/pgai:issues`. По просьбе проверить базу агент разворачивает мониторинг PostgresAI, находит проблемы и перечисляет их от самой тяжелой к легкой, к каждой дает конкретное исправление. Под капотом работает CLI `postgresai`: экспресс-проверка `npx postgresai checkup` прогоняет более 45 проверок индексов, раздувания таблиц, запросов, настроек и безопасности и отдает отчет в JSON, удобном для модели. Полный стек собирает метрики через pgwatch и показывает 13 дашбордов Grafana. Отдельный MCP-сервер, `npx postgresai mcp install`, открывает агенту задачи и действия из консоли console.postgres.ai.
Для кого. Разработчикам и DBA на PostgreSQL 14–18, которые просят агента выяснить, почему база тормозит, и получить исправления вместо сырых метрик.
Подходит, если
- Запросы замедлились, и нужен разбор базы с приоритетами.
- Перед релизом проверяют индексы и раздувание таблиц.
- Отчет в JSON отдают модели через `claude -p`, чтобы она предложила `DROP INDEX` или миграцию.
- Задачи по базе ведут в console.postgres.ai, а агент работает с ними через MCP.
Не подходит, если
- Нет разрешения передавать реквизиты базы стороннему сервису.
- База не PostgreSQL или версия вне диапазона 14–18.
- На сервере нельзя поставить Docker для полного стека мониторинга.
Пример запроса к агенту
Проверь здоровье базы `postgresql://app@db.internal:5432/main`, покажи проблемы от самой серьезной и предложи исправления.Ограничения
Для экспресс-проверки нужен Node.js 18 или новее и сетевой доступ к базе. Полному стеку нужны Linux с Docker и расширение `pg_stat_statements`. Сценарий скилла `postgresai` спрашивает, где живет база, проверяет подключение и подтверждает платную подписку PostgresAI на кластер. Без регистрации работает только экспресс-проверка и ручная установка стека. Пароль безопаснее передавать через `~/.pgpass`, а не через `PGPASSWORD`. Команда `prepare-db` создает на базе роль для мониторинга.
Как отключить. Удалите плагин командой `claude plugin uninstall pgai@postgresai`. Мониторинг на сервере останавливают командами CLI `postgresai mon`, а роль для мониторинга удаляют в самой базе.
Частые вопросы
Как поставить postgresai в Claude Code?
Выполните `claude plugin marketplace add postgres-ai/postgresai` и `claude plugin install pgai@postgresai`. Другим агентам скилл ставится командой `npx skills add postgres-ai/postgresai --skill postgresai`.
Нужна ли регистрация на console.postgres.ai?
Для экспресс-проверки и самостоятельного развертывания стека нет: оба режима открыты. Скилл и задачи из консоли работают через аккаунт PostgresAI.
Что делает команда /pgai:checkup?
Она запускает `postgresai checkup` с вашей строкой подключения и добавляет к отчету краткий вывод о самых серьезных проблемах и следующих шагах.
Как подключить MCP-сервер postgresai?
Команда `npx postgresai mcp install` настраивает сервер для Claude Code, Cursor или Windsurf. Он открывает агенту задачи и действия из консоли.
Какие версии PostgreSQL поддерживаются?
С 14 по 18. Для экспресс-проверки нужен Node.js 18 или новее и сетевой доступ к базе.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныMCP PostgreSQL Ops выбирает метрики под версию PostgreSQL: администратор получает показатели, которые доступны его установке.
MCP-сервер на Rust для pgmoneta: агент спрашивает у менеджера резервных копий PostgreSQL состояние бэкапов и управляет ими
Локальная панель для Claude Code, Codex CLI, Gemini CLI, Copilot и OpenCode: токены, стоимость, задержки и ошибки
Плагины Diffinery для Claude Code и Codex подключают агента к самохостингу Git, пул-реквестов и CI на Cloudflare через MCP-сервер
BetterDB MCP
BetterDB Monitor
MCP-сервер BetterDB: агент читает метрики, медленные команды, горячие ключи и аномалии Valkey и Redis и разбирает инциденты по сохраненной истории
Официальный плагин Railway: скилл use-railway и облачный MCP-сервер для деплоя, переменных, доменов, логов и трассировки прямо из агента
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| postgresai (эта карточка) | нет | 140 | ||
| Postgres MCP Pro | нет | API-ключ | 3 460 | MCP-сервер для запросов, планов EXPLAIN и индексов; postgresai разворачивает мониторинг и отдает отчет с исправлениями |
| MCP PostgreSQL Ops | нет | не нужна | 164 | подбирает метрики под версию PostgreSQL; postgresai ведет полный цикл от проверки до списка исправлений |
Коротко о README
Репозиторий входит в инициативу Self-Driving Postgres и опирается на опыт команды PostgresAI. Короткий псевдоним `pgai` работает как `postgresai`, а `bunx` заменяет `npx`, если стоит Bun.