PostgreSQL MCP

crystaldba/postgres-mcp· Проверено 12.11.2026· 3,5 тыс.на GitHub

Подключает агента к базе PostgreSQL: смотреть схему, выполнять SQL, разбирать планы запросов. Postgres MCP Pro вдобавок ищет медленные запросы, подбирает индексы и проверяет здоровье базы.

2 реализации:

Только PostgreSQL, зато с подбором индексов, анализом нагрузки и проверкой здоровья базы.

Как подключить

Что сделать до подключения

Docker или Python 3.12 и новее (тогда установка через pipx install postgres-mcp или uv)

Для подбора индексов и анализа запросов — расширения pg_stat_statements и hypopg в базе

DATABASE_URI

строка подключения вида postgresql://пользователь:пароль@хост:5432/база; проверить доступ можно через psql или pgAdmin

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env DATABASE_URI=postgresql://username:password@localhost:5432/dbname --transport stdio postgres \
  -- docker run -i --rm -e DATABASE_URI crystaldba/postgres-mcp --access-mode=restricted

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.postgres]
command = "docker"
args = ["run", "-i", "--rm", "-e", "DATABASE_URI", "crystaldba/postgres-mcp", "--access-mode=restricted"]

[mcp_servers.postgres.env]
DATABASE_URI = "postgresql://username:password@localhost:5432/dbname"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URI",
        "crystaldba/postgres-mcp",
        "--access-mode=restricted"
      ],
      "env": {
        "DATABASE_URI": "postgresql://username:password@localhost:5432/dbname"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "postgres": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URI",
        "crystaldba/postgres-mcp",
        "--access-mode=restricted"
      ],
      "env": {
        "DATABASE_URI": "postgresql://username:password@localhost:5432/dbname"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URI",
        "crystaldba/postgres-mcp",
        "--access-mode=restricted"
      ],
      "env": {
        "DATABASE_URI": "postgresql://username:password@localhost:5432/dbname"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URI",
        "crystaldba/postgres-mcp",
        "--access-mode=restricted"
      ],
      "env": {
        "DATABASE_URI": "postgresql://username:password@localhost:5432/dbname"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "postgres": {
        "type": "local",
        "command": [
          "docker",
          "run",
          "-i",
          "--rm",
          "-e",
          "DATABASE_URI",
          "crystaldba/postgres-mcp",
          "--access-mode=restricted"
        ],
        "environment": {
          "DATABASE_URI": "postgresql://username:password@localhost:5432/dbname"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URI",
        "crystaldba/postgres-mcp",
        "--access-mode=restricted"
      ],
      "env": {
        "DATABASE_URI": "postgresql://username:password@localhost:5432/dbname"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URI",
        "crystaldba/postgres-mcp",
        "--access-mode=restricted"
      ],
      "env": {
        "DATABASE_URI": "postgresql://username:password@localhost:5432/dbname"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_schemasпоказывает схемы

list_objectsпоказывает таблицы и представления

get_object_detailsописывает колонки и индексы

execute_sqlвыполняет SQL

explain_queryпоказывает план запроса

get_top_queriesнаходит самые медленные запросы

analyze_workload_indexesподбирает индексы под нагрузку

analyze_query_indexesподбирает индексы под запросы

analyze_db_healthпроверяет здоровье базы

Один сервер для PostgreSQL, MySQL, MariaDB, SQL Server, Oracle и SQLite; по умолчанию 2 инструмента и мало токенов в контексте.

Как подключить

Что сделать до подключения

Node.js 22.5.0 или новее; без Node.js есть образ Docker

--dsn

строка подключения вида postgres://user:password@host:5432/dbname; для нескольких баз — файл dbhub.toml и флаг --config

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio dbhub \
  -- npx @bytebase/dbhub@latest --transport stdio --dsn postgres://user:password@localhost:5432/dbname

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.dbhub]
command = "npx"
args = ["@bytebase/dbhub@latest", "--transport", "stdio", "--dsn", "postgres://user:password@localhost:5432/dbname"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "@bytebase/dbhub@latest",
        "--transport",
        "stdio",
        "--dsn",
        "postgres://user:password@localhost:5432/dbname"
      ]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "dbhub": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@bytebase/dbhub@latest",
        "--transport",
        "stdio",
        "--dsn",
        "postgres://user:password@localhost:5432/dbname"
      ]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "@bytebase/dbhub@latest",
        "--transport",
        "stdio",
        "--dsn",
        "postgres://user:password@localhost:5432/dbname"
      ]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "@bytebase/dbhub@latest",
        "--transport",
        "stdio",
        "--dsn",
        "postgres://user:password@localhost:5432/dbname"
      ]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "dbhub": {
        "type": "local",
        "command": [
          "npx",
          "@bytebase/dbhub@latest",
          "--transport",
          "stdio",
          "--dsn",
          "postgres://user:password@localhost:5432/dbname"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "@bytebase/dbhub@latest",
        "--transport",
        "stdio",
        "--dsn",
        "postgres://user:password@localhost:5432/dbname"
      ]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "@bytebase/dbhub@latest",
        "--transport",
        "stdio",
        "--dsn",
        "postgres://user:password@localhost:5432/dbname"
      ]
    }
  }
}

Инструменты сервера

execute_sqlвыполняет SQL

search_objectsищет таблицы, колонки и индексы

explain_sqlпоказывает план без выполнения (включается в dbhub.toml)

health_checkпоказывает пул соединений и кэш (включается в dbhub.toml)

Что попросить агента

«Проверь здоровье моей базы и найди проблемы»Агент вызовет analyze_db_health: кэш, соединения, вакуум, неиспользуемые индексы

«Какие запросы в базе самые медленные и как их ускорить?»Агент вызовет get_top_queries, затем analyze_query_indexes для найденных запросов

«Разбери нагрузку на базу и предложи индексы»Агент вызовет analyze_workload_indexes и покажет рекомендации

«Помоги ускорить запрос: <SQL>»Агент вызовет explain_query, при необходимости проверит план с гипотетическим индексом и предложит правку

«Сколько заказов было за прошлый месяц по каждому городу?»Агент изучит схему через list_objects и get_object_details (в DBHub — search_objects) и выполнит execute_sql

Для каких задач

Найти самые медленные запросы и подобрать под них индексы

Проверить, как изменится план запроса с гипотетическим индексом, без его создания

Проверить здоровье базы: кэш, соединения, вакуум, неиспользуемые индексы

Написать SQL с учётом реальной схемы таблиц

Подключить к одному агенту сразу несколько баз через DBHub

Ограничения

В Postgres MCP Pro режим unrestricted даёт агенту полный доступ на запись; для рабочей базы ставьте --access-mode=restricted

Без расширений pg_stat_statements и hypopg подбор индексов и анализ запросов не работают

Postgres MCP Pro тестируют на PostgreSQL 15, 16 и 17

В DBHub режим только чтения задаётся в файле dbhub.toml (readonly = true) и не защищает от функций, доступных привилегированной роли

Если не работает

Подбор индексов и разбор медленных запросов не работают

Нужны расширения pg_stat_statements и hypopg: выполните CREATE EXTENSION под ролью с правами. На своём сервере pg_stat_statements сначала добавьте в shared_preload_libraries.

DBHub подключается, но запросы к базе падают

Проверьте строку DSN, подключитесь к базе обычным клиентом и проверьте права пользователя. Ошибки DBHub пишет в stderr.

Клиент не подключается к DBHub по HTTP

Проверьте, что DBHub запущен с --transport http и порт совпадает (по умолчанию 8080). Адрес проверяется командой curl http://localhost:8080/mcp.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Postgres MCP Pro	Crystal DBA	3,5 тыс.	локально	не нужен	9	17 августа 2026
DBHub	Bytebase	3,8 тыс.	локально	не нужен	4	12 ноября 2026

Частые вопросы

Какой вариант выбрать?

Если нужна именно настройка производительности PostgreSQL — Postgres MCP Pro. Если нужно просто смотреть схему и выполнять запросы, особенно к нескольким СУБД, — DBHub: он занимает около 1,4 тыс. токенов в контексте.

Как подключиться к базе на этом же компьютере из Docker?

Образ Postgres MCP Pro сам заменяет localhost: на macOS и Windows на host.docker.internal, на Linux на адрес хоста вроде 172.17.0.1.

Как включить расширения на облачной базе?

На AWS RDS, Azure и Google Cloud SQL расширения уже есть, достаточно выполнить CREATE EXTENSION IF NOT EXISTS pg_stat_statements и CREATE EXTENSION IF NOT EXISTS hypopg от роли с нужными правами.

Можно ли зайти в базу через SSH-туннель?

В DBHub — да, флагами --ssh-host, --ssh-user и --ssh-key или через алиас из ~/.ssh/config.

Работает ли сервер из России?

Оба сервера работают на вашем компьютере и подключаются напрямую к вашей базе, ключи и аккаунты не нужны.

PostgreSQL MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы