Postgres MCP (Microsoft)

Установка

Работает в

• Claude Code
• Claude Desktop
• Cursor
• Codex
• GitHub Copilot
• VS Code
• OpenCode
• SourceCraft
• Koda
• Coddy

npx skillfoxx add mcp/postgres-mcp-server-microsoft

Что делает

Postgres MCP от Microsoft — сервер для PostgreSQL, который клиент запускает командой `npx -y @microsoft/postgres-mcp run`. Установка не нужна: это готовый бинарник в npm-пакете, он говорит с клиентом по stdio. Подключение к базе описывается профилем. Команда `connection add` записывает адрес и параметры в `~/.postgres-mcp/connections.yaml`, а `connection set-password` кладет пароль в связку ключей ОС, и в конфиг клиента он не попадает. Агент сам находит сохраненные профили и открывает пул соединений. Сервер дает 13 инструментов. Для подключений это список, добавление и удаление профилей, `postgres_mcp_connect` и список баз. `postgres_mcp_db_context` возвращает скрипты `CREATE` для таблиц, индексов, функций и последовательностей. `postgres_mcp_query` выполняет одиночный запрос только на чтение, а `postgres_mcp_modify` — DDL и DML. Для данных есть описание CSV-файла и загрузка его в таблицу через `COPY`, для диагностики — проверка доступных возможностей сервера и сбор групп метрик производительности. Для баз Azure Database for PostgreSQL без сохраненного пароля сервер входит через Microsoft Entra ID: берет учетные данные из переменных Azure, из рабочей идентичности или из `az login`. Для Amazon RDS и Aurora, Google Cloud SQL и AlloyDB, локальной и своей установки используется обычный пароль.

Для кого. Для разработчиков и администраторов, которые работают с PostgreSQL из Claude Code, Codex, OpenCode, Cursor, VS Code или Copilot CLI и держат базы локально или в облаках Azure, Amazon и Google. Особенно удобен командам на Azure с входом через Entra ID.

Пример запроса к агенту

Покажи 10 последних заказов из моей базы PostgreSQL и скажи, какой запрос сейчас сильнее всего нагружает сервер

MCP

Транспорт

stdio

Авторизация

ключ необязателен

Ограничения

• Это предварительная версия: в журнале изменений значится 0.1.0.
• Профиль, созданный командой `connection add`, разрешает инструменты записи, пока не задан `access_mode: ro`. Для автономных агентов нужен и профиль только на чтение, и роль базы с теми же правами.
• Сервер собирает псевдонимизированную телеметрию: идентификаторы машины и сессии, названия инструментов, длительность и исход, без текста запросов. Отключается флагом `run --no-telemetry`.
• На хостах без связки ключей, например в Docker и CI, строку подключения с паролем передают в `POSTGRES_MCP_CONNECTION_STRING`, и она видна другим процессам среды.
• Режим `sslmode=require` шифрует соединение, но сертификат не проверяет. Проверка включается значениями `verify-ca` и `verify-full`.
• Для входа через `az login` нужен Azure CLI 2.54.0 или новее.
• Лицензия MIT.

Как отключить. Удалите запись postgres из конфигурации клиента и перезапустите агента. Профили и пароли убираются командой `npx -y @microsoft/postgres-mcp connection remove <имя>`, а список разрешенных папок для CSV лежит в `~/.postgres-mcp/approved_paths.yaml`.

Коротко о README

Короткая инструкция ведет от сохранения профиля подключения к настройке клиента и первому вопросу агенту. Большое руководство USAGE.md разбирает настройку для GitHub Copilot CLI, Claude Code, Cursor, Claude Desktop, VS Code, Codex и OpenCode, способы входа, модель безопасности с таблицей ответственности и чек-листом защиты, режимы TLS, справочник инструментов и переменных окружения, а также частые ошибки. Рядом лежат журнал изменений и описание порядка сообщений об уязвимостях.