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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/mcp-postgres/raw/index.md(查看排版版本)