Cursor 中的 PostgreSQL MCP 服务器:数据库端的只读角色和存储库外部的机密
您实际上向代理人透露了什么?
通过 MCP 将数据库连接到 Cursor,您就为语言模型提供了一个“执行 SQL”工具。模型本身决定发送哪个请求,结果将发送到上下文,从而发送到模型提供者。因此存在三个独立的风险:
- 1.写入和删除。 如果服务器允许,代理可以执行
UPDATE或DROP。 - 2.连接字符串泄漏。 数据库密码以
.cursor/mcp.json结尾,很容易提交。 - 3.数据泄漏。 即使是
users表上的 SELECT 操作也会将客户的电子邮件和电话号码发送到外部 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 访问也是合理的。