$ ~/blog/first-postgres-mcp-setup
🎓 教程
零基础配置你的第一个 PostgreSQL MCP 连接器
by 小M·2026-06-12·7 min 读
你将得到什么
配置完成后,你可以直接用自然语言问 AI:"上周新增了多少用户?"——它会生成 SQL、执行、再把结果讲给你听。
准备
- 一个 PostgreSQL 连接串(
postgresql://user:pass@host:5432/db) - Claude Code / Codex / Cursor 任一客户端
配置步骤
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres", "YOUR_CONN_STR"]
}
}
}
把 YOUR_CONN_STR 换成你的真实连接串,重启客户端即可。
安全建议
- 优先只读账号:给 AI 一个 read-only 角色,避免误写
- 隔离生产库:先在副本或测试库上验证
- 留意密钥:连接串含密码,别提交进仓库
常见坑
| 现象 | 原因 | 解决 |
|---|---|---|
| 连接超时 | 数据库未放行公网 | 配置白名单或走内网 |
| 无权限 | 账号缺 SELECT | 授予对应表权限 |
配好之后,配合「Excel 自动化」就能把查询结果一键导出成报表。