pg-aiguide MCP Server

pg-aiguide

面向编程助手的 AI 优化 PostgreSQL 专业知识

pg-aiguide 帮助 AI 编程工具编写出质量大幅提升的 PostgreSQL 代码。它提供：

• 对官方 PostgreSQL 手册的语义搜索（版本感知）
• AI 优化的“技能” — 由 AI 代理自动使用的精选、有主见的 Postgres 最佳实践
• 扩展生态系统文档，从 TimescaleDB 开始，更多内容即将推出

使用方式：

• 通过 npx skills 作为代理技能 — 适用于 Claude Code、Cursor、Codex、Gemini CLI 以及 40 多个其他代理
• 作为可与任何 AI 编程代理一起使用的公共 MCP 服务器，或
• 作为针对 Claude 原生技能支持优化的Claude Code 插件。

⭐ 为什么选择 pg-aiguide？

AI 编程工具生成的 Postgres 代码常常：

• 过时
• 缺少约束和索引
• 不了解现代 PG 特性
• 与真实世界的最佳实践不一致

pg-aiguide 通过为 AI 代理提供深入的、带版本的 PostgreSQL 知识和经过验证的模式来解决这些问题。

看看区别

https://github.com/user-attachments/assets/5a426381-09b5-4635-9050-f55422253a3d

🚀 快速开始

代理技能

为你的 AI 编程代理安装精选的 PostgreSQL 最佳实践技能：

npx skills add timescale/pg-aiguide --skill postgres

或交互式选择单个技能：

npx skills add timescale/pg-aiguide

适用于 Claude Code、Cursor、Codex、Gemini CLI、VS Code 以及 40 多个其他代理。

如需更深入的 PostgreSQL 知识，还可添加 MCP 服务器，为你的代理提供对官方 PostgreSQL、TimescaleDB 和 PostGIS 手册的语义搜索。

MCP 服务器

如需对 PostgreSQL、TimescaleDB 和 PostGIS 文档进行语义搜索，请添加公共 MCP 服务器：

https://mcp.tigerdata.com/docs

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

或者，它也可以作为 Claude Code 插件使用：

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide

按环境安装

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide

codex mcp add --url "https://mcp.tigerdata.com/docs" pg-aiguide

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

gemini mcp add -s user pg-aiguide "https://mcp.tigerdata.com/docs" -t http

code --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'

code-insiders --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'

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

💡 你的第一个提示

安装后，pg-aiguide 可以回答 Postgres 问题或设计架构。

简单架构示例提示

创建一个用于存储用户名和唯一电子邮件地址的 Postgres 表架构。

复杂架构示例提示

你是一名高级软件工程师。你的任务是为一家物联网设备公司生成一个 Postgres 架构。 这些设备收集工厂车间的环境数据。数据包括温度、湿度、压力作为主要数据点，以及其他因设备而异的测量值。每个设备都有一个唯一 ID 和一个人类可读的名称。我们还想记录数据收集的时间。对近期数据的分析包括根据测量值查找异常值和异常情况，以及分析特定设备的数据以进行临时分析。历史数据分析包括分析单个设备的数据历史记录，或获取所有设备在长时间内的统计数据。

特性

文档搜索（MCP 工具）

• search_docs 统一的搜索工具，支持跨多个文档源的语义（向量相似度）和关键词（BM25）搜索：
  • postgres - 官方 PostgreSQL 手册，按版本限定范围
  • tiger - Tiger Data 的文档（TimescaleDB 及生态系统）
  • postgis - PostGIS 空间扩展文档

技能（AI 优化的最佳实践）

• view_skill
  公开由 AI 编程助手自动使用的精选、有主见的 PostgreSQL 最佳实践技能。

  这些技能提供以下方面的指导：

  • 架构设计
  • 索引策略
  • 数据类型
  • 数据完整性和约束
  • 命名约定
  • 性能调优
  • 现代 PostgreSQL 特性

🔌 生态系统文档

目前支持：

• TimescaleDB（文档 + 技能）
• PostGIS（文档）

即将推出：

• pgvector

我们欢迎为其他扩展和工具做出贡献。

🛠 开发

请参阅 DEVELOPMENT.md 了解：

• 在本地运行 MCP 服务器
• 添加新技能
• 添加新文档

🤝 贡献

我们欢迎：

• 新的 Postgres 最佳实践技能
• 额外的文档语料库
• 搜索质量改进
• 错误报告和功能想法

📄 许可证

Apache 2.0