Postgres Ai Guide

pg-aiguide

コーディングアシスタント向けに最適化された PostgreSQL の専門知識

pg-aiguide は、AI コーディングツールがより優れた PostgreSQL コードを作成できるよう支援します。以下を提供します。

• PostgreSQL 公式マニュアルを対象としたセマンティック検索（バージョン対応）
• AI 向けに最適化された「スキル」 — 厳選された、独自の見解を含む Postgres のベストプラクティス。AI エージェントが自動的に使用します
• 拡張機能のエコシステムに関するドキュメント。まずは 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

または、既存の PostgreSQL データベースを調査するためのスキーマ調査スキルをインストールします。

npx skills add timescale/pg-aiguide --skill schema-exploration

あるいは、個別のスキルを対話形式で選択します。

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pg-aiguide": {
      "type": "remote",
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

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 テーブルスキーマを作成してください。

複雑なスキーマのプロンプト例

あなたはシニアソフトウェアエンジニアです。IoT デバイス企業向けの Postgres スキーマを作成するタスクが与えられています。 デバイスは工場のフロアで環境データを収集します。データには、主要なデータポイントである温度、湿度、圧力に加えて、デバイスごとに異なるその他の測定値が含まれます。各デバイスには一意の ID と、人が読みやすい名前があります。データが収集された時刻も記録したいと考えています。最近のデータの分析では、測定値に基づく外れ値や異常値の検出、およびアドホック分析のための特定デバイスのデータ分析が含まれます。過去データの分析では、1 台のデバイスのデータ履歴の分析や、長期間にわたる全デバイスの統計情報の取得が含まれます。

機能

ドキュメント検索（MCP ツール）

• search_docs 複数のドキュメントソースを対象に、セマンティック検索（ベクトル類似度）とキーワード検索（BM25）をサポートする統合検索ツールです。
  • postgres - バージョンごとに対象を絞った PostgreSQL 公式マニュアル
  • tiger - Tiger Data のドキュメント（TimescaleDB とそのエコシステム）
  • postgis - PostGIS の空間拡張機能のドキュメント

スキル（AI に最適化されたベストプラクティス）

• view_skill
  AI コーディングアシスタントが自動的に使用する、厳選された独自の PostgreSQL ベストプラクティススキルを提供します。

  これらのスキルでは、以下について解説します。

  • 既存の PostgreSQL スキーマとオブジェクトの調査
  • スキーマ設計
  • インデックス戦略
  • データ型
  • データの整合性と制約
  • 命名規則
  • パフォーマンスのチューニング
  • PostgreSQL の最新機能

🔌 エコシステムのドキュメント

現在サポートしているもの：

• TimescaleDB（ドキュメント＋スキル）
• PostGIS（ドキュメント）

近日公開：

• pgvector

その他の拡張機能やツールのコントリビューションを歓迎します。

🛠 開発

以下については、DEVELOPMENT.md を参照してください。

• MCP サーバーをローカルで実行する
• 新しいスキルを追加する
• 新しいドキュメントを追加する

🤝 コントリビューション

以下を歓迎します。

• Postgres の新しいベストプラクティススキル
• 追加のドキュメントコーパス
• 検索品質の改善
• バグ報告や機能のアイデア

📄 ライセンス

Apache 2.0