PostgreSQL performance Tuner MCP Server — MCP-сервер для Claude Code
MCP-сервер анализирует медленные запросы в PostgreSQL и тестирует гипотетические индексы через HypoPG без записи на диск.
claude mcp add pgtuner-mcp -- uvx pgtuner-mcpЧто делает PostgreSQL performance Tuner MCP Server
Сервер подключается к базе по строке DATABASE_URI и опрашивает системные представления. Он выявляет тяжёлые запросы в pg_stat_statements и разбирает планы EXPLAIN ANALYZE. Параллельно инструмент отслеживает конфликты блокировок и транзакции, зависшие в состоянии ожидания. Отдельный блок следит за autovacuum и временными файлами, возникающими при нехватке памяти work_mem.
Для подбора индексов используется расширение HypoPG. Оно создаёт виртуальные структуры в оперативной памяти сессии, благодаря чему можно оценить план оптимизатора до запуска миграций. Для поиска раздувания таблиц понадобится расширение pgstattuple.
Без прав на системные каталоги или роли pg_read_all_stats сервер не сможет прочитать статистику активности.
Какие задачи решает
- найти проблемные запросы в базе через
pg_stat_statements - проверить гипотетический индекс через
HypoPGбез расхода диска - отследить зависшие транзакции и конфликты блокировок
- выявить таблицы с раздуванием и оценить работу autovacuum
Примеры запросов агенту
- Найди медленные запросы в
pg_stat_statementsи покажи проблемные места в планах - Протестируй виртуальный индекс для таблицы orders через
HypoPG - Проверь статус autovacuum и покажи таблицы с сильным раздуванием
Как установить PostgreSQL performance Tuner MCP Server
Командой платформы
claude mcp add pgtuner-mcp -- uvx pgtuner-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from pgtuner-mcp <команда>
Командой платформы
codex mcp add postgresql-performance-tuner-mcp-server -- uvx pgtuner-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from pgtuner-mcp <команда>
Файл настроек
{
"mcpServers": {
"postgresql-performance-tuner-mcp-server": {
"command": "uvx",
"args": [
"pgtuner-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from pgtuner-mcp <команда>
Файл настроек
{
"servers": {
"postgresql-performance-tuner-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"pgtuner-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from pgtuner-mcp <команда>
Командой платформы
gemini mcp add postgresql-performance-tuner-mcp-server uvx pgtuner-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from pgtuner-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о PostgreSQL performance Tuner MCP Server
Как установить PostgreSQL performance Tuner MCP Server в Claude Code?
Выполните в терминале команду claude mcp add pgtuner-mcp -- uvx pgtuner-mcp и настройте переменную окружения DATABASE_URI со строкой подключения к вашей базе.
Что делает этот MCP-сервер?
Он предоставляет модели инструменты для диагностики PostgreSQL: поиск медленных запросов, аудит конфигурации и оценку эффективности кэша.
Обязательно ли устанавливать HypoPG?
Основной сбор метрик и анализ планов работают без него, однако проверка виртуальных индексов требует наличия расширения hypopg на сервере базы.
