Agent Skills
返回列表
🤖

PGMCP 只读 Postgres 查询助手

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 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 验证