PGMCP 只读 Postgres 查询助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/query-postgres-databases-through-read-only-mcp-workflows-with-pgmcp。
技能介绍
问题:让 Postgres 查询更贴近工程对话
当你已经有一个 PostgreSQL 数据库,但查数、排障和验证 schema 仍要在客户端、应用日志和聊天窗口之间来回切换时,一个更顺手的路径是让 MCP 兼容助手直接读取数据库上下文,并用自然语言提问。这个技能要解决的不是再做一个数据库面板,而是把既有 Postgres 接入只读查询链路:你描述目标,助手结合 schema 生成更可读的 SQL,结果以流式方式返回,便于边看边调整。
工作方式
- 接入既有数据库:目标不是迁移数据,而是连接到已有 PostgreSQL 数据库,复用已有表、视图和 schema。
- 只读工作流:围绕查询场景组织交互,降低自然语言接口直接触碰写入路径的风险。
- Schema 感知 SQL:在可用 schema 元数据范围内生成查询,而不是凭空拼 SQL。
- 自然语言到结果:你用自然语言表达要查的业务域、字段和聚合维度,助手返回 SQL 与结果;可选 OpenAI API key 用于 AI 辅助生成 SQL。
- 流式返回:查询结果以流式形式给到客户端,适合结果较长或需要逐步观察的场景。
适用边界与注意点
- 适合探索、排障、取数和 schema 验证;不要把它当成生产写入入口或权限管理系统的替代品。
- 真正的安全边界仍取决于 PostgreSQL 账号权限、上游 PGMCP 的 SQL 约束和 MCP 客户端实现。
- 需要准备可用的
DATABASE_URL和 MCP 兼容客户端;上游文档还提到 Docker/Kubernetes 部署方式,容器化环境里应确认网络连通、凭据管理和客户端生命周期。 - 若使用 AI SQL 生成,OpenAI API key 是可选项;未提供时可用范围取决于具体客户端与上游配置。
- 查询前建议先确认敏感表、行级权限和审计要求,必要时仍走正式数据访问流程。
使用场景
- 在既有 Postgres 中排查慢查询时,用自然语言描述预期结果,让助手基于 schema 生成检查 SQL
- 验证某张表的结构变更是否生效时,直接查询列名、类型和示例数据
- 在 Kubernetes 环境部署 PGMCP 并连接现有 PostgreSQL,确认流式查询返回正常
- 让兼容 MCP 的助手回答业务指标问题,同时观察较长结果集逐步返回
适合人员
- 后端工程师,需要频繁连接 Postgres 排查接口慢查询或数据不一致问题
- 数据分析师,希望用自然语言查询既有数仓表并直接核对聚合结果
- 平台工程师,负责在 Docker 或 Kubernetes 中部署只读数据库访问组件并管理连接串
- AI 应用工程师,正在把 MCP 兼容助手接入 Postgres,用于安全取数和 schema 验证