PostgreSQL MCP 服务器

解决什么问题

当 LLM Agent 需要直接读取 PostgreSQL 里的业务数据时，通常面临两个麻烦：模型不知道库表结构，写出的 SQL 经常是错的；把数据库凭证直接交给模型又有安全风险。这个技能演示如何通过 MCP（Model Context Protocol）把 PostgreSQL 封装成一个标准化的工具服务，让 Agent 在受控边界内发现表结构、执行查询并拿回结构化结果。

它如何工作

• 技能以 MCP 服务器 的形式运行在 MCP 客户端或宿主环境中，前置条件是已具备 PostgreSQL 访问权限和凭证。
• Agent 通过 MCP 协议发现服务器暴露的工具，例如查看数据库元信息或执行 SQL 查询。
• 查询结果以结构化内容返回给模型，后续的分析与展示由 Agent 自行决定。
• 代码库的定位是 参考实现：主要演示 MCP 特性与 SDK 用法，供开发者照着改造出自己的服务器。

适用边界与注意点

• 这是教学性质的示例代码，不是开箱即用的生产级服务。上线前需要自己补齐鉴权、多租户隔离、监控和策略校验；文档中提到的 MCP Plexus、mxcp 等框架可以作为企业级改造的参考方向。
• 它只覆盖「连接 PostgreSQL 并执行查询」这一层，不会替模型做业务决策，也不会自动优化慢查询或处理数据一致性问题。
• 上游文档源自 modelcontextprotocol 官方 servers 项目，代码仓库为 1991513ccie-png 的 skills 仓库，遇到依赖冲突时应以官方说明为准。