Pg Aiguide

🚀 pg-aiguide

AIに最適化されたPostgreSQLの専門知識をコーディングアシスタントに提供します

pg-aiguideは、AIコーディングツールが劇的に良質なPostgreSQLコードを生成するのを支援します。以下の機能を提供します。

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

これは以下のいずれかの形で使用できます。

• 任意の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

🚀 クイックスタート

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

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

あなたはシニアソフトウェアエンジニアです。IoTデバイス会社のPostgresスキーマを生成するタスクを受け取りました。 デバイスは工場の床で環境データを収集します。データには、主なデータポイントとして温度、湿度、気圧が含まれ、デバイスによって異なる他の測定値も含まれます。各デバイスには一意のIDと人間が読める名前があります。また、データが収集された時間も記録したいと思います。最近のデータの分析には、測定値に基づく外れ値や異常を見つけること、および特定のデバイスのデータを即席分析することが含まれます。過去のデータ分析には、1つのデバイスのデータの履歴を分析すること、または長期間にわたるすべてのデバイスの統計を取得することが含まれます。

セマンティック検索（MCPツール）

• 
  公式PostgreSQLマニュアル全体でセマンティック検索を実行し、結果を特定のPostgresバージョンに限定します。

• Tiger Dataのドキュメントコーパスを検索します。TimescaleDBと将来的なエコシステム拡張機能を含みます。

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

• 
  AIコーディングアシスタントが自動的に使用する、精選された、意見主導のPostgreSQLのベストプラクティススキルを公開します。

  これらのスキルは以下の点に関するガイダンスを提供します。

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

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

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

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

近日追加予定：

• pgvector
• PostGIS

追加の拡張機能やツールに関する貢献を歓迎します。

🛠 開発

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

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

🤝 コントリビューション

以下の貢献を歓迎します。

• 新しいPostgresのベストプラクティススキル
• 追加のドキュメントコーパス
• 検索品質の向上
• バグレポートと機能アイデア

📄 ライセンス

Apache 2.0