PostgreSQL MCP-Server in Cursor: Nur-Lesen-Rolle auf der Datenbankseite und Geheimnisse außerhalb des Repositorys
Что вы на самом деле открываете агенту
Подключая базу к Cursor через MCP, вы даёте языковой модели инструмент «выполни SQL». Модель сама решает, какой запрос отправить, а результат уходит в контекст и, значит, к провайдеру модели. Отсюда три отдельных риска:
- 1.Запись и удаление. Агент может выполнить
UPDATEилиDROP, если сервер это позволяет. - 2.Утечка строки подключения. Пароль от базы оказывается в
.cursor/mcp.json, который легко закоммитить. - 3.Утечка данных. Даже SELECT по таблице
usersотправит email и телефоны клиентов во внешний API.
Read-only-режим самого MCP-сервера закрывает только первый пункт, и то ненадёжно.
Почему нельзя полагаться на read-only сервера
Референсный пакет @modelcontextprotocol/server-postgres выполняет запросы внутри транзакции BEGIN TRANSACTION READ ONLY. Позже в нём нашли обход: несколько SQL-операторов в одной строке позволяли завершить read-only-транзакцию и выполнить запись. Сам пакет перенесён в архив и не поддерживается. Вывод общий для любого MCP-сервера баз данных: ограничение, которое реализовано в клиентском коде, обходится. Настоящая граница — права роли в самой PostgreSQL.
Роль для агента
Выполните под администратором:
CREATE ROLE mcp_reader LOGIN PASSWORD 'сгенерируйте-длинный-пароль'; -- Ограничения на уровне роли ALTER ROLE mcp_reader SET statement_timeout = '5s'; ALTER ROLE mcp_reader SET idle_in_transaction_session_timeout = '10s'; ALTER ROLE mcp_reader SET default_transaction_read_only = on; ALTER ROLE mcp_reader CONNECTION LIMIT 3; -- Минимальный доступ REVOKE ALL ON DATABASE app FROM PUBLIC; GRANT CONNECT ON DATABASE app TO mcp_reader; GRANT USAGE ON SCHEMA public TO mcp_reader; GRANT SELECT ON public.orders, public.products, public.categories TO mcp_reader; -- Только безопасные колонки из таблицы с персональными данными GRANT SELECT (id, created_at, plan, country) ON public.users TO mcp_reader;
Важно понимать, что именно здесь работает. default_transaction_read_only — удобная подстраховка, но пользователь может выключить её командой SET в своей сессии. Защищают от записи именно GRANT: у роли просто нет INSERT, UPDATE, DELETE и прав владельца. Не выдавайте агенту встроенную роль pg_read_all_data — она открывает чтение всех таблиц, включая будущие.
REVOKE ALL ON DATABASE app FROM PUBLIC может задеть другие роли, которые полагались на права по умолчанию. Проверьте это на копии, прежде чем выполнять на рабочем сервере.
Проверка, что роль действительно не пишет:
psql "postgresql://mcp_reader@db-host/app" -c "SET default_transaction_read_only = off; DELETE FROM orders WHERE false;" # ожидаемо: ERROR: permission denied for table orders
Строка подключения вне репозитория
Не вписывайте URL с паролем прямо в args. Сделайте обёртку, которая берёт его из окружения:
#!/usr/bin/env bash # ~/bin/mcp-postgres-ro — файл вне репозитория, chmod 700 set -euo pipefail source "$HOME/.config/mcp/pg-readonly.env" # содержит MCP_PG_URL=postgresql://mcp_reader:...@host/app exec npx -y @modelcontextprotocol/server-postgres "$MCP_PG_URL"
И подключите её в глобальном конфиге ~/.cursor/mcp.json, а не в проектном:
{
"mcpServers": {
"postgres-readonly": {
"command": "/Users/you/bin/mcp-postgres-ro",
"args": []
}
}
}Если команда всё же хочет общий проектный .cursor/mcp.json, в нём должен быть только путь к обёртке, а файл с паролем у каждого свой. Добавьте *.env в .gitignore и прогоните gitleaks или аналог в pre-commit.
Учитывая статус референсного пакета, для новых проектов разумно взять активно поддерживаемый MCP-сервер для Postgres. Схема с отдельной ролью и обёрткой при этом не меняется.
Куда подключаться
Лучший вариант — реплика или ночная копия с замаскированными персональными данными. Тогда тяжёлый запрос агента не нагрузит основную базу, а случайно выбранные строки не содержат реальных телефонов. Если подключаться к продакшену всё-таки нужно, делайте это через представления:
CREATE VIEW analytics.orders_safe AS SELECT id, created_at, status, total_kzt, left(customer_email, 2) || '***' AS customer_hint FROM public.orders; GRANT USAGE ON SCHEMA analytics TO mcp_reader; GRANT SELECT ON analytics.orders_safe TO mcp_reader;
Диагностика
- Агент говорит «permission denied» — это нормальная работа ограничений. Расширяйте права точечно, по одной таблице.
- Запросы обрываются по таймауту —
statement_timeoutсработал. Не поднимайте его, а попросите агента добавитьLIMITи фильтры по индексированным колонкам. - Чтобы посмотреть, что агент реально выполнял, включите
log_statement = 'all'для этой роли:ALTER ROLE mcp_reader SET log_statement = 'all';.
Когда MCP к базе не нужен
Если агенту нужна только схема, дайте ему вывод pg_dump --schema-only или файл миграций: это ноль рисков и ноль сетевых доступов. Для разовой аналитики проще выполнить запрос самому и вставить результат. Прямой MCP-доступ оправдан, когда агент действительно итеративно исследует данные, и даже тогда только через выделенную роль.