pg-aiguide：PostgreSQL 智能助手
为 AI 编程工具提供优化的 PostgreSQL 知识与最佳实践，生成更高质量的代码。
- Star 数
- ★ 1.9k
- 最近更新
- 11 天前
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 33/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code 或 Cursor 的开发者，希望生成更健壮的 PostgreSQL 模式。
- 不适合
- 需要完全离线或数据不出本地的团队，公共 MCP 服务器由 TigerData 托管
- 只使用 PostgreSQL、TimescaleDB、PostGIS 之外扩展的团队，其他扩展尚未支持
- 不愿安装 Node.js 或使用命令行工具的非技术用户
这个 Agent 能做什么，适合哪些场景？
pg-aiguide 是一个 MCP 服务器和 Claude Code 插件，旨在帮助 AI 编码工具生成更准确、更现代的 PostgreSQL 代码。它提供基于官方 PostgreSQL 手册的语义搜索（支持版本感知），以及经过优化的“技能”（skills），涵盖模式设计、索引策略、数据类型等最佳实践。支持 Agent Skills（通过 npx skills 安装）和公共 MCP 服务器（https://mcp.tigerdata.com/docs）两种使用方式，并可作为 Claude Code 插件直接安装。
pg-aiguide 通过 MCP 提供文档搜索工具（search_docs），支持对 PostgreSQL、TimescaleDB 和 PostGIS 手册进行语义搜索和关键词搜索。它还通过 view_skill 工具暴露预设的 PostgreSQL 最佳实践技能，供 AI 代理自动使用。安装后，AI 代理可以在生成模式或查询时自动检索相关文档和技能，从而生成包含更多约束、索引和现代特性的高质量 SQL。
- 使用 Claude Code 或 Cursor 的开发者，希望生成更健壮的 PostgreSQL 模式。
- 使用 Codex 或 Gemini CLI 的开发者，需要快速查询 PostgreSQL 文档。
- 使用 VS Code 或 Visual Studio 的开发者，希望通过 MCP 集成获取实时文档建议。
- 处理复杂物联网数据模式的工程师，需要设计包含时序数据、异常检测等功能的数据库结构。
- 希望将 TimescaleDB 或 PostGIS 扩展集成到 AI 工作流中的团队。
如何安装或部署这个 Agent？
安装 Agent Skills：运行 npx skills add timescale/pg-aiguide --skill postgres 或交互式选择。安装 MCP 服务器：配置 JSON 将 https://mcp.tigerdata.com/docs 作为 MCP 端点。安装 Claude Code 插件：运行 claude plugin marketplace add timescale/pg-aiguide 然后 claude plugin install pg@aiguide。
如何使用这个 Agent？
安装后，直接向 AI 代理提问，例如“创建一个存储用户名和唯一电子邮件地址的 Postgres 表模式”。对于复杂任务，提供详细需求，代理会自动搜索相关文档并应用最佳实践。
这个 Agent 有哪些优点和局限？
- 提供版本感知的 PostgreSQL 官方手册语义搜索，确保知识最新。
- 内置经过优化的最佳实践技能，自动提升生成的 SQL 质量。
- 支持多种 AI 工具（Claude Code、Cursor、Codex、Gemini CLI 等）和协议（MCP、Agent Skills）。
- 开源且采用 Apache 2.0 许可，可自由扩展。
- 公共 MCP 服务器依赖 TigerData 托管，可能存在第三方服务依赖。
- 安装过程涉及多个环境（Node.js、命令行工具），对非技术用户不友好。
- 技能集和文档覆盖范围有限，目前仅支持 PostgreSQL、TimescaleDB 和 PostGIS，其他扩展（如 pgvector）仍在规划中。
这个 Agent 与同类方案有什么区别？
与原生 AI 工具（如不带额外插件的 Claude Code）相比，pg-aiguide 提供了更专业的 PostgreSQL 知识库和最佳实践集成。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| pg-aiguide：PostgreSQL 智能助手 当前 | 33 · 缺口较多 | 命令行工具免费 | ★ 1.9k | 11 天前 | Python | ChatGPT · Codex · Claude Code |
| Grounded Docs MCP 服务器 | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.8k | 今天 | TypeScript | ChatGPT · Claude Code |
| Microsoft Learn MCP Server | 43 · 缺口较多 | MCP 服务器免费 | ★ 2k | 1 个月前 | TypeScript | ChatGPT · Codex · Claude Code · Claude.ai |
| Remnic 智能体记忆 | 85 · 表现良好 | 命令行工具免费 + 模型费 | ★ 227 | 3 天前 | TypeScript | ChatGPT · Codex · Claude Code · OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：仓库未提供权限模型、用户确认机制、数据流透明性、敏感数据处理、依赖安全审计、外部影响说明、回滚机制或来源归属的明确说明。所有信任相关标准均未得到支持，因此评分为0。
证据显示：README和package.json中的描述一致，均指向PostgreSQL文档搜索和技能提供，自洽性评分为2。依赖项在package.json中列出，但未提供可用性保证或锁定版本，依赖可用性评分为1。未提供失败消息或错误处理文档，失败消息评分为0。
证据显示：README明确了目标受众（AI编码助手）和多种使用场景（Agent Skills、MCP服务器、Claude插件），受众和场景评分为2。能力边界部分描述（如支持的扩展），但未明确限制，能力边界评分为1。触发精度未详细说明，仅提及技能自动使用，触发精度评分为1。环境适配良好，支持多种IDE和CLI，环境适配评分为2。
证据显示：README结构清晰，包含快速入门、功能、开发等章节，信息架构评分为2。安装说明详细，覆盖多种环境，安装说明评分为2。命名稳定性未明确，但版本号存在，命名稳定性评分为1。提供了示例提示和视频，示例和FAQ评分为2。已知限制未明确列出，仅提及即将支持pgvector，已知限制评分为1。许可证为Apache-2.0，许可证评分为2。版本号存在但无变更日志，版本和变更日志评分为1。维护责任未明确，但存在贡献指南，维护责任评分为1。
证据显示：输出可用性高，提供搜索和技能，输出可用性评分为2。边际价值明显，提供AI优化技能，边际价值评分为2。成本效益未量化，成本效益评分为1。
证据显示：README中的声明（如4倍约束）未提供可验证的测试或数据，声明可追溯性评分为1。跨来源佐证有限，仅依赖README，跨来源佐证评分为1。事实与推断未明确区分，事实推断分离评分为1。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 未提供权限模型或用户确认机制，使用前需谨慎评估。
- 依赖未锁定版本，存在供应链风险。
- 声明（如4倍约束）缺乏可验证证据。
- 未提供回滚机制或数据流透明性说明。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Full Changelog: https://github.com/timescale/pg-aiguide/compare/v0.6.0...v0.6.1在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * Update @tigerdata/mcp-boilerplate to 1.6.4 by @Askir in https://github.com/timescale/pg-aiguide/pull/131 * Update dependencies (includes boilerplate XSS fix) by @murrayju in https://github.com/timescale/pg-aiguide/pull/132 * chore(ingest): update python deps to clear all 44 Dependabot alerts by @murrayju in https://github.com/timescale/pg-aiguide/pull/133 * Resolve relative inline links to fully-qualified URLs during scrape by @arimu1 in https://github.com/timescale/pg-aiguide/pull/129 …在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * [AGE-430] Add PostGIS versioning (and combine source+version) by @gregsaab in https://github.com/timescale/pg-aiguide/pull/90 * Update secrets to ORG_AUTOMATION_TOKEN by @dsanroman96 in https://github.com/timescale/pg-aiguide/pull/91 * [CHORE] update lock file by @gregsaab in https://github.com/timescale/pg-aiguide/pull/92 * [CHORE] use non-prod instead of github's runners by @gregsaab in https://github.com/timescale/pg-aiguide/pull/93 * [CHORE] revert by @gregsaab in https://github.com/timescale/pg-aiguide/pull/94 …在 GitHub 查看 ↗