Pg Aiguide

🚀 pg-aiguide

pg-aiguide 為代碼編寫助手提供經過 AI 優化的 PostgreSQL 專業知識。它能顯著提升 AI 編碼工具編寫 PostgreSQL 代碼的質量，主要功能包括：

• 語義搜索：可對官方 PostgreSQL 手冊進行語義搜索（支持版本識別）。
• AI 優化“技能”：精心整理、專業權威的 Postgres 最佳實踐，能被 AI 智能體自動運用。
• 擴展生態文檔：目前已涵蓋 TimescaleDB，更多擴展即將推出。

它支持以下兩種使用方式：

• 公共 MCP 服務器：可與任何 AI 編碼智能體配合使用。
• Claude Code 插件：針對 Claude 的原生技能支持進行了優化。

🚀 快速開始

pg-aiguide 作為公共 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 工具）

• 
  可對官方 PostgreSQL 手冊進行語義搜索，搜索結果會根據特定的 Postgres 版本進行篩選。

• 可搜索 Tiger Data 的文檔語料庫，包括 TimescaleDB 以及未來的生態系統擴展。

技能（AI 優化的最佳實踐）

• 
  提供精心整理、專業權威的 PostgreSQL 最佳實踐技能，供 AI 編碼助手自動使用。

  這些技能涵蓋以下方面的指導：

  • 模式設計
  • 索引策略
  • 數據類型
  • 數據完整性和約束
  • 命名約定
  • 性能調優
  • 現代 PostgreSQL 特性

📚 詳細文檔

🔌 生態系統文檔

目前支持：

• TimescaleDB（文檔 + 技能）

即將支持：

• pgvector
• PostGIS

我們歡迎為更多擴展和工具做出貢獻。

🛠 開發相關

如需瞭解以下內容，請參閱 DEVELOPMENT.md：

• 在本地運行 MCP 服務器
• 添加新技能
• 添加新文檔

🤝 貢獻指南

我們歡迎以下方面的貢獻：

• 新的 Postgres 最佳實踐技能
• 更多的文檔語料庫
• 搜索質量的改進
• 錯誤報告和功能建議

📄 許可證

本項目採用 Apache 2.0 許可證。