pg-aiguide MCP Server

pg-aiguide

AIコーディングアシスタントのための、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テーブルスキーマを作成してください。

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

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

機能

ドキュメント検索（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