WorkBuddy 是一款腾讯开发的 AI 智能体工作台,可以通过 MCP(Model Context Protocol,模型上下文协议)连接外部工具和数据源。通过配置适用于 PostgreSQL 的 MCP Server,用户可以使用自然语言辅助完成云数据库 PostgreSQL 的数据查询、SQL 分析和日常巡检等工作。
本文介绍 WorkBuddy 连接云数据库 PostgreSQL 后,用自然语言完成数据查询、SQL 分析和日常巡检的典型场景和注意事项。
说明:
WorkBuddy 生成的 SQL 和分析结论仅作为辅助参考。生产环境中的 SQL 应由用户确认后执行,涉及数据变更的操作应遵循业务发布和数据库变更规范。
前提条件
开始前,请完成以下准备工作:
已 创建云数据库 PostgreSQL 实例,并获取实例的连接地址、端口和数据库名称。
PostgreSQL MCP Server 的运行环境与数据库网络互通。位于同一私有网络时,建议通过内网地址连接。
已为 WorkBuddy 创建独立的普通数据库账号,并根据实际任务授予所需权限。数据分析和巡检场景建议默认使用只读权限。
WorkBuddy 所在设备已安装 Node.js,并可以执行 npx 命令,也可以让 WorkBuddy 自己去安装。
云数据库 PostgreSQL 支持在控制台的数据库管理 > 账号管理页面创建账号和配置对象权限。网络连接还需要确保实例安全组已放通 MCP Server 运行环境的访问地址和数据库端口。
配置 PostgreSQL MCP Server
本文以腾讯云开发者 MCP 广场收录的 PostgreSQL MCP Server 为例。该服务支持检查数据库表结构和执行只读查询,所有查询均在只读事务中执行。
步骤1:准备连接信息
内网或外网连接地址。
数据库端口,默认为5432。
需要访问的数据库名称。
专用普通账号及密码。
建议优先使用内网连接。使用外网连接时,应限制安全组来源地址,避免直接向所有公网地址开放数据库端口。
步骤2:打开 MCP 配置
在 WorkBuddy 侧边栏选择专家·技能·连接器,选择连接器,单击自定义连接器,进入 MCP 服务管理页面,选择配置 MCP。
在此页面,可以将腾讯云数据库的 MCP 配置填写进去。

数据库连接信息中包含凭证,建议使用用户级配置,并妥善保护配置文件。不要将包含真实密码的配置提交到代码仓库。
步骤3:填写 MCP 配置
macOS 或 Linux 环境可以使用以下配置:
{"mcpServers": {"tencentdb-postgresql": {"command": "npx","args": ["-y","@modelcontextprotocol/server-postgres","postgresql://<账号>:<密码>@<连接地址>:<端口>/<数据库名>"]}}}
Windows 环境需要通过 cmd 调用 npx:
{"mcpServers": {"tencentdb-postgresql": {"command": "cmd","args": ["/c","npx","-y","@modelcontextprotocol/server-postgres","postgresql://<账号>:<密码>@<连接地址>:<端口>/<数据库名>"]}}}
将尖括号中的内容替换为实际连接信息。如果密码包含 @、:、/、# 或 ? 等 URL 特殊字符,需要先进行 URL 编码。实例启用 SSL 后,还需要按照云数据库 PostgreSQL 的 SSL 连接要求配置连接参数。
注意:
示例使用的是开源 MCP Server。正式用于生产环境前,请评估其来源、版本、权限范围和安全风险,并使用独立的只读数据库账号控制访问范围。
步骤4:验证连接
保存配置后,在 WorkBuddy MCP Server 列表中查看状态。绿色表示连接成功;红色表示配置异常,应依次检查 node 和 npx 命令、JSON 格式、网络和安全组、连接地址以及账号密码。
连接状态正常后,输入以下指令进行验证:
请连接 PostgreSQL 数据库,仅执行只读操作,并返回当前数据库名称和数据库版本。

WorkBuddy 返回当前数据库名称和版本后,表示 MCP Server 已能够访问实例。建议先使用测试实例或非核心数据库验证连接、权限和 SQL 执行范围,再用于生产环境。
典型使用场景
场景 | 适合解决的问题 | 主要产出 |
梳理数据库结构 | 新接手数据库,不清楚 Schema、表和字段的用途 | 数据库结构概览、数据字典 |
自然语言查询数据 | 有明确的业务问题,但不熟悉 SQL 或表结构 | 查询 SQL、结果表格、分析摘要 |
SQL 开发和性能分析 | 需要编写 SQL 或理解执行计划 | SQL 草稿、执行计划说明、优化建议 |
日常巡检 | 需要快速了解连接、事务、锁和容量情况 | 巡检摘要、异常项和处理建议 |
梳理数据库结构和生成数据字典
接手新的云数据库 PostgreSQL 实例时,用户通常需要先了解实例中有哪些 Schema 和数据表,以及主要字段之间的关系。WorkBuddy 可以通过 MCP Server 读取数据库元数据,并在账号权限范围内查询 PostgreSQL 系统目录,整理表、字段、数据类型、主键、外键和索引等信息。
例如:
请以只读方式分析当前数据库:1. 列出所有业务 Schema 和数据表。2. 重点分析 public Schema 中的 orders、order_items 和 customers 表。3. 整理字段、数据类型、主键、外键和索引信息。4. 生成 Markdown 格式的数据字典,并说明表之间的关系。不要查询或展示表中的业务数据。

WorkBuddy 可以输出数据库结构概览和数据字典,帮助开发人员快速熟悉数据库。生成结果来自数据库元数据,字段的实际业务含义仍需结合系统设计文档或研发人员确认。
自然语言查询和分析数据
当用户有明确的数据分析目标,但不熟悉表结构或 SQL 时,可以直接用自然语言描述需求。WorkBuddy 会先读取相关表结构,再生成只读 SQL;用户确认后执行查询,最后将结果整理为表格和分析摘要。
例如:
请先查看订单相关表的结构,再完成以下分析:1. 统计最近 7 天每天的订单数量和成交金额。2. 计算订单数量和成交金额的日环比变化。3. 只生成 SELECT 语句,执行前先展示 SQL。4. 执行后以表格展示结果,并用三句话总结变化趋势。
一次完整的输出应包含实际执行的 SQL、查询结果以及基于结果生成的摘要,便于用户检查分析口径。该场景适合临时查数、数据核对和趋势分析。对于数据量较大的表,建议在指令中明确时间范围、过滤条件和返回行数,避免生成开销过大的查询。

辅助 SQL 开发和性能分析
WorkBuddy 可以结合云数据库 PostgreSQL 中的字段类型、表关联和索引信息,辅助编写查询 SQL。对于已有 SQL,可以让 WorkBuddy 执行 EXPLAIN 并解释扫描方式、连接顺序、估算行数和代价较高的节点。
例如:
请结合 orders 和 order_items 的表结构分析下面的 SQL:1. 检查连接条件和过滤条件是否正确。2. 执行 EXPLAIN,不要执行 EXPLAIN ANALYZE。3. 说明扫描方式、连接顺序、估算行数和索引使用情况。4. 给出优化建议和建议的验证方法,不要直接创建或删除索引。
输出内容可以包括 SQL 问题说明、执行计划解读、改写后的 SQL 以及索引建议。WorkBuddy 可以帮助识别全表扫描、大量数据读取、排序或连接开销等问题,但建议仍需结合实际数据分布、业务访问模式和实例负载进行验证。普通 EXPLAIN 展示的是估算开销;EXPLAIN ANALYZE 会实际执行目标 SQL,不建议直接对生产环境中的高开销语句使用。

生成日常巡检摘要
通过查询 pg_stat_activity、pg_locks 等 PostgreSQL 运行状态视图,WorkBuddy 可以辅助检查连接、长事务和锁等待。还可以使用 PostgreSQL 容量函数统计当前数据库和主要数据表的空间占用,并将结果整理为巡检摘要。
例如:
请以只读方式完成一次数据库巡检:1. 按连接状态统计当前连接数。2. 找出持续时间超过 10 分钟的事务。3. 检查锁等待,并说明等待会话和阻塞会话。4. 统计当前数据库容量和占用空间最大的 10 张表。5. 输出检查结果、异常项、可能影响和建议处理方式。不要终止会话,也不要修改数据库参数。
巡检结果可以按“检查项、当前状态、是否异常、处理建议”组织成表格,便于日常留档。普通数据库账号能够查看的会话和统计信息可能受到权限限制,应根据巡检范围配置必要的只读监控权限。

PostgreSQL MCP Server 主要获取数据库内的信息,不能直接替代云数据库 PostgreSQL 控制台的 CPU、内存、存储 I/O、告警和慢查询分析能力。发现异常后,建议结合控制台监控和诊断数据进一步确认。
安全使用建议
遵循最小权限原则。为 WorkBuddy 创建独立账号,仅授予目标数据库、Schema 和数据表的必要权限。
默认限制为只读操作。查询类任务应明确只允许执行 SELECT。INSERT、UPDATE、DELETE、DDL 和会话终止等操作应经过人工确认。
妥善保管连接凭证。不要在对话指令、截图或共享文档中填写明文密码,建议使用 MCP Server 支持的环境变量或安全凭证管理方式。
控制查询影响。对查询设置合理的时间范围、返回行数和执行超时,避免复杂 SQL 对生产实例造成额外负载。
检查生成内容。执行 WorkBuddy 生成的 SQL 前,应检查访问对象、查询条件和预估影响,重要操作应先在测试环境验证。
总结
通过 PostgreSQL MCP Server,WorkBuddy 可以使用自然语言辅助访问云数据库 PostgreSQL,降低临时查数、SQL 分析和日常巡检的操作门槛。实际使用时,建议从只读场景开始,通过专用账号、最小权限和人工确认机制控制风险,并继续使用云数据库 PostgreSQL 控制台完成实例监控、告警和管理操作。