pg-aiguide

pg-aiguide

AI最適化されたPostgreSQL専門知識をコーディングアシスタントへ

pg-aiguideは、AIコーディングツールが劇的に優れたPostgreSQLコードを書けるように支援します。提供される機能は以下のとおりです:

• 公式PostgreSQLマニュアルのセマンティック検索（バージョン対応）
• AI最適化された「スキル」 — AIエージェントが自動的に使用する、厳選されたPostgreSQLのベストプラクティス
• 拡張エコシステムのドキュメント（TimescaleDBから開始、今後さらに追加予定）

以下の方法で利用できます:

• Agent Skillsとして npx skills 経由 — Claude Code、Cursor、Codex、Gemini CLI、その他40以上のエージェントで動作
• 公開MCPサーバーとして、任意のAIコーディングエージェントで利用可能
• Claude Codeプラグインとして、Claudeのネイティブスキルサポートに最適化

⭐ なぜpg-aiguideなのか？

AIコーディングツールが生成するPostgresコードには、以下のような問題がよくあります:

• 古い内容
• 制約やインデックスが欠落
• 最新のPG機能を認識していない
• 実世界のベストプラクティスと一貫性がない

pg-aiguideは、AIエージェントに深くバージョン管理されたPostgreSQLの知識と実証済みのパターンを提供することで、これらの問題を解決します。

違いを確認する

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

🚀 クイックスタート

Agent Skills

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