mcp-postgres

让 Claude 直接查询、监控和分析 PostgreSQL 数据库的 MCP 工具。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:mcp-postgres。
它的用途是:让 Claude 直接查询、监控和分析 PostgreSQL 数据库的 MCP 工具。
完整的 Skill 内容见:https://321skill.com/skills/mcp-postgres/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我查询过去24小时内订单表里状态为‘待发货’的记录,并按金额降序排列。”,它会调用 sql_execute 工具,执行相应的 SQL 查询并返回结果。或者

对AI说:“检查一下数据库里有没有长时间运行的查询。”,它会使用监控工具列出当前活跃的查询会话,帮助你定位性能瓶颈。

介绍

mcp-postgres 是一个 Model Context Protocol (MCP) 服务器,它打通了 Claude 与 PostgreSQL 数据库之间的桥梁,让开发者无需离开 Claude 的对话界面即可直接操作数据库。

它通过配置环境变量连接到你的 PostgreSQL 实例,然后在 Claude 中提供一系列工具,让你可以执行 SELECT 查询、浏览数据库表结构、查看列信息,还能监控数据库的运行状态,例如活跃查询、阻塞会话和连接数等。对于需要写操作的场景,在关闭只读模式后,也支持 INSERT、UPDATE 和 DELETE。

这个 Skill 非常适合需要频繁与数据库交互的后端开发、全栈开发和数据分析师。无论是调试时快速查看数据,还是分析业务数据、监控数据库性能,都能在 Claude 内一站式完成,极大提升工作效率。

使用时请注意,为确保安全,默认启用只读模式(READONLY=true)。如需启用写操作,请务必在明确知晓风险后手动设置为 false。同时,建议为生产环境数据库配置具有最小必要权限的专用账号,并合理设置 QUERY_TIMEOUT 和 MAX_ROWS 以避免意外影响。

核心特点

与同类数据库 MCP 工具相比,它不仅支持基础的查询和表结构浏览,更内置了丰富的数据库监控与性能分析工具,如查看阻塞会话、等待统计、识别缺失或未使用的索引,能直接辅助数据库运维和性能调优。

注意事项

不适合需要复杂事务管理、执行存储过程或进行大规模数据迁移等高级数据库管理操作的场景。

常见问题

如何安全地启用写操作(INSERT/UPDATE/DELETE)?

在配置中将环境变量 READONLY 设置为 false,并确保连接数据库的账号仅拥有操作特定表所需的最小权限。

查询结果太多怎么办?

可以通过设置 MAX_ROWS 环境变量(默认1000,最大5000)来限制单次查询返回的行数,避免数据过载。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/mcp-postgres/raw/index.md 读取 mcp-postgres 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。