TP

timescale/pg-aiguide

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

1877 stars 120 forks 品質 86 トレンド 46Apache-2.0

PostgresのスキルやドキュメントのためのMCPサーバーとClaudeプラグイン。AIコーディングツールがより良いPostgreSQLコードを生成するのに役立ちます。

概要

pg-aiguideは、AIコーディングツールが劇的に優れたPostgreSQLコードを書くのを支援します。以下を提供します: - 公式PostgreSQLマニュアル(バージョン対応)- — AIエージェントが自動的に使用する厳選された意見を持つPostgreのベストプラクティス - TimescaleDBから始まり、今後さらに追加予定です - via npx skills — Claude Code、Cursor、Codex、Gemini CLI、その他40+エージェントで動作 - 任意のAIコーディングエージェントで使用可能、またはClaudeのネイティブスキルサポートに最適化されたツール。 AIコーディングツールはしばしばPostgresコードを生成します: - 時代遅れ - 制約やインデックスが欠如 - 現代のPG機能に気づいていない - 現実のベストプラクティスと矛盾 pg-aiguideは、AIエージェントに深くバージョン管理されたPostgreSQLの知識と実証済みパターンを提供することで、この問題を解決します。 https://github.

概要(AI 翻訳)

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

pg-aiguideは、AIコーディングツールが劇的に優れたPostgreSQLコードを書くのを支援します。以下を提供します:

  • 公式PostgreSQLマニュアル(バージョン対応)における意味検索
  • AI最適化された「スキル」 — AIエージェントが自動的に使用する厳選された意見を持つPostgreのベストプラクティス
  • 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 により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

pg-aiguide

AI-optimized PostgreSQL expertise for coding assistants

pg-aiguide helps AI coding tools write dramatically better PostgreSQL code. It provides:

  • Semantic search across the official PostgreSQL manual (version-aware)
  • AI-optimized “skills” — curated, opinionated Postgres best practices used automatically by AI agents
  • Extension ecosystem docs, starting with TimescaleDB, with more coming soon

Use it as:

  • Agent Skills via npx skills — works with Claude Code, Cursor, Codex, Gemini CLI, and 40+ other agents
  • a public MCP server that can be used with any AI coding agent, or
  • a Claude Code plugin optimized for use with Claude’s native skill support.

⭐ Why pg-aiguide?

AI coding tools often generate Postgres code that is:

  • outdated
  • missing constraints and indexes
  • unaware of modern PG features
  • inconsistent with real-world best practices

pg-aiguide fixes that by giving AI agents deep, versioned PostgreSQL knowledge and proven patterns.

See the difference

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

🚀 Quickstart

Agent Skills

Install curated PostgreSQL best-practice skills for your AI coding agent:

npx skills add timescale/pg-aiguide --skill postgres

Or install the schema exploration skill to investigate an existing PostgreSQL database:

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

Or pick individual skills interactively:

npx skills add timescale/pg-aiguide

Works with Claude Code, Cursor, Codex, Gemini CLI, VS Code, and 40+ other agents.

For even deeper PostgreSQL knowledge, also add the MCP server to give your agent semantic search over the official PostgreSQL, TimescaleDB, and PostGIS manuals.

MCP Server

For semantic search over PostgreSQL, TimescaleDB, and PostGIS documentation, add the public MCP server:

https://mcp.tigerdata.com/docs

{
  "mcpServers": {
    "pg-aiguide": {
GitHub で README 全文を見る

インストール

npx skills add timescale/pg-aiguide --skill postgres
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "pg-aiguide": { "url": "https://mcp.tigerdata.com/docs" } } }