Курсордағы PostgreSQL MCP сервері: дерекқор жағындағы тек оқуға арналған рөл және репозиторийден тыс құпиялар
Сіз агентке нені ашасыз?
Деректер базасын курсорға MCP арқылы қосу арқылы сіз тіл үлгісіне «SQL орындау» құралын бересіз. Модельдің өзі қандай сұранысты жіберу керектігін шешеді және нәтиже мәтінмәнге, демек, үлгі жеткізушісіне өтеді. Осылайша, үш бөлек тәуекел бар:
- 1.Жазу және жою. Егер сервер рұқсат етсе, агент
UPDATEнемесеDROPорындай алады. - 2.Байланыс жолы ағып кетті. Дерекқор құпия сөзі
.cursor/mcp.jsonішінде аяқталады, оны орындау оңай. - 3.Деректердің ағып кетуі. Тіпті
usersкестесіндегі ТАҢДАУ клиенттің электрондық пошталары мен телефон нөмірлерін сыртқы API интерфейсіне жібереді.
MCP серверінің тек оқуға арналған режимінің өзі тек бірінші нүктені жабады, тіпті содан кейін сенімсіз.
Неліктен тек оқуға арналған серверлерге сене алмайсыз?
@modelcontextprotocol/server-postgres анықтамалық бумасы BEGIN TRANSACTION READ ONLY транзакциясындағы сұрауларды орындайды. Кейінірек онда уақытша шешім табылды: бір жолда бірнеше SQL операторлары тек оқуға арналған транзакцияны аяқтауға және жазуды орындауға мүмкіндік берді. Пакеттің өзі мұрағатталды және енді оған қолдау көрсетілмейді. Қорытынды кез келген 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 немесе алдын ала орындаудағы баламасын іске қосыңыз.
Анықтамалық пакет мәртебесін ескере отырып, жаңа жобалар үшін Postgres үшін белсенді қызмет көрсетілетін MCP серверін таңдау орынды. Бөлек рөлі мен орамасы бар схема өзгермейді.
Қайда қосылу керек
Ең жақсы нұсқа - көшірме немесе жасырын жеке деректері бар түнгі көшірме. Содан кейін ауыр агент сұрауы негізгі дерекқорды жүктемейді және кездейсоқ таңдалған жолдарда нақты телефон нөмірлері болмайды. Егер сізге әлі де өндіріске қосылу қажет болса, оны көріністер арқылы орындаңыз:
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;
Диагностика
- Агент «рұқсат берілмеді» дейді - бұл шектеулердің қалыпты жұмысы. Құқықтарды нүкте бойынша кеңейту, бір уақытта бір кесте.
- Сұраныстардың уақыты аяқталды -
statement_timeoutжұмыс істеді. Оны келтірмеңіз, бірақ агенттен индекстелген бағандарғаLIMITжәне сүзгілерді қосуды сұраңыз. - Агенттің іс жүзінде не істегенін көру үшін осы рөл үшін
log_statement = 'all'функциясын қосыңыз:ALTER ROLE mcp_reader SET log_statement = 'all';.
Дерекқорға MCP қажет болмаған кезде
Егер агентке тек схема қажет болса, оған pg_dump --schema-only шығысын немесе тасымалдау файлын беріңіз: бұл нөлдік тәуекел және желіге кіру мүмкіндігі нөл. Бір реттік аналитика үшін сұрауды өзіңіз орындап, нәтижені қою оңайырақ. Тікелей MCP қатынасы агент деректерді нақты итерациялық түрде зерттегенде, тіпті сол кезде де тек арнайы рөл арқылы ғана ақталады.