← 返回目录

pg-aiguide

社区

面向 AI 编程助手的 PostgreSQL 专家知识

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 38 / 58
Stars: ★ 1.9k 非常热门
传输方式: Streamable HTTP
运行环境: 远程托管（无需本地环境）
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 14 天前
工具数: 2

50FMRS · D

pg-aiguide 通过提供语义搜索和最佳实践技能，显著提升了 AI 编码工具生成 PostgreSQL 代码的质量。它适合需要高质量数据库代码的开发人员，但需要网络访问，且依赖外部服务。

最强项 · 维护活跃度 12/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

9/20

维护活跃度

12/20

文档质量

10/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: 仓库未提供MCP服务器清单或明确的本地运行证据；工具声明为search_docs和view_skill，但未提供实际行为验证。错误处理与依赖控制信息不足，因此可靠性评分较低，仅为乐观路径的合理性。
安全与权限 9/20: 服务器作为远程HTTP端点暴露，文档未提供认证或授权细节，可能允许无限制访问。但未发现恶意行为或真实密钥泄露。由于权限和范围不明确，评分中等偏低。
维护活跃度 12/20: 仓库活跃，有大量star和更新的提交，但缺少明确的发布版本和变更日志。许可证为Apache-2.0，但未见安全响应渠道。评分反映活跃但有治理缺口。
文档质量 10/20: README提供了详细的安装和使用示例，包括多个客户端的配置，但缺少API参数的详细说明、限制和故障排除。评分认可文档的良好覆盖但存在隐藏假设。
安装易用性 11/20: 提供了多种客户端的配置示例，但主要依赖远程托管服务，本地安装步骤不明确。未提供本地运行验证，因此评分中等偏高。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

使用 AI 编码工具（如 Claude Code、Cursor、Codex、Gemini CLI）的开发人员。
希望确保生成的 PostgreSQL 代码现代、可靠且高效的人。

不适合谁

需要直接数据库连接或执行查询的应用程序。
需要本地、离线运行的环境。

所需权限

作为远程 HTTP 服务器，它接收查询并返回文档。
作为技能，它可能被 AI 代理自动调用。

风险与副作用

公共服务器可能包含文档中的过时或不准确信息。
远程服务器暴露于网络风险。
AI 代理可能生成看似合理但未经验证的代码。

安装接入

准备工作

运行环境：远程托管（无需本地环境）

作为 Agent Skills 安装：运行 npx skills add timescale/pg-aiguide --skill postgres。作为 MCP 服务器，可将 https://mcp.tigerdata.com/docs 添加到客户端配置（例如 mcpServers JSON）。作为 Claude Code 插件：运行 claude plugin marketplace add timescale/pg-aiguide 和 claude plugin install pg@aiguide。

.mcp.json

{
  "mcpServers": {
    "pg-aiguide": {
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "pg-aiguide": {
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http pg-aiguide https://mcp.tigerdata.com/docs

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中确认出现 search_docs 和 view_skill 两个工具，然后让 AI 使用 search_docs 搜索某条 PostgreSQL 文档以验证连接。

常见排障

确保网络连接可到达 `mcp.tigerdata.com`。
检查客户端 MCP 配置中的 URL 是否正确。
对于技能，验证 `npx skills` 已安装且版本兼容。
对于 Claude Code 插件，确保使用支持的 Claude 版本。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

创建一个用于存储用户名和唯一邮箱地址的 Postgres 表结构。
搜索 PostgreSQL 官方文档中关于部分索引（partial index）的内容。
查看关于索引策略的 Postgres 最佳实践 skill。
为一个 IoT 设备公司生成一个 Postgres schema，设备采集温度、湿度、压力等环境数据。

工具能力 2

search_docs 只读

统一搜索工具，支持跨多个文档源的语义（向量相似性）和关键词（BM25）搜索，包括 PostgreSQL、TimescaleDB 和 PostGIS 文档。

view_skill 只读

提供精选的、有主见的 PostgreSQL 最佳实践技能，涵盖模式设计、索引策略、数据类型、数据完整性、命名约定、性能调优和现代功能。

使用场景

为 AI 编码代理提供深入的 PostgreSQL 知识，以生成更好的模式。

跨不同文档源搜索 PostgreSQL 相关文档。

通过最佳实践技能自动化最佳实践应用。

支持客户端

Claude Code

Cursor

VS Code

Codex

Gemini CLI

Windsurf

依据项目文档列出，未经本站实测。

详细介绍

pg-aiguide 帮助 AI 编程工具编写更好的 PostgreSQL 代码。它提供官方 PostgreSQL 手册的语义搜索（按版本感知）、AI 优化的最佳实践技能（自动用于 AI 代理），以及扩展生态文档（如 TimescaleDB）。可用作代理技能、公共 MCP 服务器或 Claude Code 插件。