MCP-PostgreSQL-Ops MCP сервер

Профессиональный MCP сервер для операций с базами данных PostgreSQL, мониторинга и управления, который поддерживает PostgreSQL 12-17 с комплексным анализом баз данных, мониторингом производительности и интеллектуальными рекомендациями по обслуживанию через запросы на естественном языке.

Установка

PyPI

pip install mcp-postgresql-ops

UV Package Manager

uv add mcp-postgresql-ops

Из исходного кода

git clone https://github.com/call518/MCP-PostgreSQL-Ops.git
cd MCP-PostgreSQL-Ops
uv sync
uv run mcp-postgresql-ops --help

Быстрый старт с Docker

git clone https://github.com/call518/MCP-PostgreSQL-Ops.git
cd MCP-PostgreSQL-Ops
cp .env.example .env
docker-compose up -d

Конфигурация

Claude Desktop

{
  "mcpServers": {
    "mcp-postgresql-ops": {
      "command": "uvx",
      "args": ["--python", "3.12", "mcp-postgresql-ops"],
      "env": {
        "POSTGRES_HOST": "127.0.0.1",
        "POSTGRES_PORT": "15432",
        "POSTGRES_USER": "postgres",
        "POSTGRES_PASSWORD": "changeme!@34",
        "POSTGRES_DB": "ecommerce"
      }
    }
  }
}

Доступные инструменты

Инструмент	Описание
`get_server_info`	Получить информацию о версии PostgreSQL сервера и расширениях
`get_active_connections`	Мониторинг текущих активных подключений к базе данных
`get_postgresql_config`	Получить настройки конфигурации PostgreSQL
`get_database_list`	Список всех баз данных в экземпляре PostgreSQL
`get_table_list`	Получить таблицы в конкретной базе данных
`get_table_schema_info`	Получить детальную информацию о схеме таблиц
`get_database_schema_info`	Получить комплексную информацию о схеме базы данных
`get_table_relationships`	Анализ связей внешних ключей между таблицами
`get_user_list`	Список пользователей и ролей базы данных
`get_index_usage_stats`	Анализ статистики использования индексов
`get_database_size_info`	Получить информацию о размере базы данных
`get_table_size_info`	Получить информацию о размере таблиц
`get_vacuum_analyze_stats`	Получить статистику VACUUM и ANALYZE
`get_table_bloat_analysis`	Анализ раздувания таблиц и эффективности хранения
`get_database_bloat_overview`	Получить обзор раздувания по всей базе данных

Возможности

Нулевая конфигурация: Работает с PostgreSQL 12-17 из коробки с автоматическим определением версии
Естественный язык: Задавайте вопросы вроде 'Покажи медленные запросы' или 'Проанализируй раздувание таблиц'
Безопасность для продакшена: Операции только для чтения, совместимость с RDS/Aurora с обычными правами пользователя
Улучшенные расширения: Опциональные pg_stat_statements и pg_stat_monitor для продвинутой аналитики запросов
Комплексный мониторинг базы данных: Анализ производительности, обнаружение раздувания и рекомендации по обслуживанию
Умный анализ запросов: Выявление медленных запросов с интеграцией расширений
Обнаружение схем и связей: Исследование структуры базы данных с детальным картированием связей
Интеллект VACUUM и автовакуума: Мониторинг обслуживания в реальном времени и анализ эффективности
Многобазовые операции: Плавный анализ и мониторинг между базами данных
Готовность к энтерпрайзу: Безопасные операции только для чтения с совместимостью RDS/Aurora

Переменные окружения

Обязательные

POSTGRES_HOST - Имя хоста PostgreSQL сервера
POSTGRES_PORT - Порт PostgreSQL сервера
POSTGRES_USER - Имя пользователя PostgreSQL
POSTGRES_PASSWORD - Пароль PostgreSQL
POSTGRES_DB - База данных PostgreSQL по умолчанию для подключения

Примеры использования

Покажи мне текущие активные подключения

Какие самые медленные запросы в системе?

Проанализируй раздувание таблиц во всех базах данных

Покажи мне информацию о размере базы данных

Какие таблицы нуждаются в обслуживании VACUUM?

Ресурсы

GitHub Repository

Примечания

Сервер включает комплексную настройку быстрого старта с Docker Compose, которая предоставляет тестовое окружение PostgreSQL с примерами данных в нескольких базах данных (ecommerce, analytics, inventory, hr_system). Большинство функций работают независимо, но возможности продвинутого анализа запросов улучшаются при установке расширений pg_stat_statements и pg_stat_monitor. Сервер автоматически адаптируется к разным версиям PostgreSQL и предоставляет функциональность с учетом версии.