生产环境该用哪个 Postgres MCP
用 MCP 把 agent 接到了生产 Postgres,却没人确认示例配置是否允许写入、语句有没有上限、工具清单吃掉多少上下文。
📜 目录
四个 Postgres MCP,2026 年 11 月 23 日逐个核过。每次会话一开始就分出高下的那个数不是速度,是 261 个工具定义 token 对 6982 个。后一个数在模型读到第一张表之前就已经花掉了。
下面写清楚:每个服务对写入到底怎么管、它自己的 README 让你怎么配、以及选了小的那个要付什么代价。
生产环境让这道选择题变成什么样
开发用的 MCP 什么都要能做到。生产用的只需要三条保证:人没开写入,agent 就写不了;任何一条查询都不能扫过一亿行;工具清单不能在人开口之前把上下文吃掉。剩下的都是偏好。
这四个是怎么核的
Star 数、许可证、最后提交时间取自 2026 年 11 月 23 日的 GitHub API。周下载量取自 npm registry,时间窗口是 2026 年 11 月 15 日到 21 日。行为描述引自各项目自己的 README,是原文不是转述。工具定义的 token 数来自 DBHub 自己发布的对照表——看清是谁发的,比看数字本身重要。
能锁成只读的两个,配法都在往反方向带你
DBHub(bytebase/dbhub,3924 星,MIT,2026-11-21 仍在提交,当周 npm 下载 225789)默认两个工具:execute_sql 和 search_objects,explain_sql、health_check 要显式打开。README 列了护栏:只读模式、行数限制、查询超时;接着说了大多数对比文不会写的一句:只给 --dsn 时,execute_sql 也能写,要真的只读,得用 --config 指到一份 TOML,里面写 readonly = true。同一份 README 还提醒,只读模式是护栏,不是权限边界。
Postgres MCP Pro(crystaldba/postgres-mcp,3494 星,MIT,最后提交 2026-08-17,98 个未关的 issue)在分析上更进一步:索引调优(在候选索引组合里搜)、带假设索引的 EXPLAIN 计划模拟、vacuum、buffer cache、复制延迟这些健康检查。访问控制靠一个参数:--access-mode=restricted 限制成只读事务并加执行时间上限,--access-mode=unrestricted 放开写入。README 里每一份配置示例都用 unrestricted。照抄示例,生产库就是可写的。
这个模式在整个生态里反复出现,也是部署前最该查的一件事:看示例配置,别看功能列表。示例是为了一次跑通而写的。
被归档的那个,下载量还是最高
@modelcontextprotocol/server-postgres,最新版 0.6.2,npm 上挂着弃用声明:已归档、无人维护、不保证安全。2026 年 11 月 15 日那一周它还有 137933 次下载,DBHub 的 README 专门写了一篇怎么替代它。装机量比维护状态多活好几年,一个没人打补丁的连接器就这样接上了生产只读库。查一个团队的 MCP 配置,先查这个包。
工具清单在第一个问题之前要花多少
MCP 客户端会把工具定义装进提示词。DBHub 发布了一份定义大小的对照,用 cl100k_base 分词器量的。作者量自己的产品,偏差摆在明面上,看趋势可以:
| 服务 | 工具定义 token | 工具数 |
|---|---|---|
| DBHub 2.0.1 | 261 | 2 |
| MCP Toolbox 1.18.0 | 3901 | 29 |
| Supabase MCP 0.19.0 | 6982 | 36 |
6982 个 token 对着 32768 的窗口,等于用户还没打字就没了 21%。36 个工具还意味着更多选错的机会,而这种错误在对话记录里看不出来——它长得像一个自信的回答,只是答的是另一张表。另一个服务上的实测见37 个工具吃掉多少 token。
怎么选
| 情况 | 选 | 真正要紧的那个设置 |
|---|---|---|
| agent 只读生产数据,永不写 | DBHub + TOML 配置 | readonly = true,外加一个最小权限的数据库角色 |
| agent 帮忙调慢查询和索引 | Postgres MCP Pro | --access-mode=restricted,不是 README 里那个示例 |
| 一个技术栈里混用 MySQL、SQL Server、SQLite | DBHub | 一个进程、一份 TOML、每条连接各自的只读开关 |
| agent 更需要 Postgres 文档而不是查表 | pg-aiguide(1886 星,Apache-2.0) | 另一个品类:技能和 schema 文档,不是查询网关 |
| 在配置里发现了那个被归档的服务 | 上面任选一个 | 它已无人维护,npm 上挂着弃用声明 |
信任任何一个之前,五分钟能做完的检查
按顺序做完,一条别跳。用一个只有 CONNECT 和 SELECT 权限的数据库角色接上,先确认拿写锁的语句在这一层就被拒。再让 agent 插一行:正确的结果是 Postgres 报错,而不是服务端拒绝——服务端自己的只读模式是一道可以配错的护栏。然后让它 count 你最大的那张表,看它是返回全部还是按行数或时间限制住。最后翻查询日志:agent 跑过的每一条语句都该在,原文不动。
agent 有写权限而你没想清楚时会出什么事,见60 次攻击的护栏测试。从没接过这类服务的话,Postgres 接入教程可以照做;协议本身对服务端有什么要求,在规范笔记。
这篇没做什么
四个服务一个都没装、没连库实跑,所以这里没有延迟、吞吐、召回的数字,只有 2026 年 11 月 23 日当天可查的公开事实:行为与体积。版本号会动,参数名一个小版本就可能改。那份 token 对照表是被对比的三家之一自己发布的,另外两行我没有独立复核。要拿表下单之前,用你自己的分词器再数一遍。
本站文章由编辑人工撰写,收录的工具均经过实测或公开资料核验。文中链接指向工具官网或 GitHub 仓库,仅作信息参考,不构成付费推广。