pg-aiguide

pg-aiguide

KI-optimiertes PostgreSQL-Fachwissen für Coding-Assistenten

pg-aiguide hilft KI-Coding-Tools, dramatisch besseren PostgreSQL-Code zu schreiben. Es bietet:

• Semantische Suche im offiziellen PostgreSQL-Handbuch (versionsabhängig)
• KI-optimierte „Skills“ — kuratierte, meinungsstarke Postgres-Best-Practices, die automatisch von KI-Agenten genutzt werden
• Dokumentation zum Erweiterungs-Ökosystem, beginnend mit TimescaleDB, weitere folgen in Kürze

Verwendung als:

• Agent Skills via npx skills — funktioniert mit Claude Code, Cursor, Codex, Gemini CLI und über 40 weiteren Agenten
• einen öffentlichen MCP-Server, der mit jedem KI-Coding-Agenten genutzt werden kann, oder
• ein Claude Code Plugin, optimiert für die native Skill-Unterstützung von Claude.

⭐ Warum pg-aiguide?

KI-Coding-Tools generieren oft Postgres-Code, der:

• veraltet ist
• Constraints und Indizes vermissen lässt
• moderne PG-Features nicht kennt
• inkonsistent mit realen Best Practices ist

pg-aiguide behebt das, indem es KI-Agenten tiefes, versioniertes PostgreSQL-Wissen und bewährte Muster bereitstellt.

Den Unterschied sehen

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

🚀 Schnellstart

Agent Skills

Installiere kuratierte PostgreSQL-Best-Practice-Skills für deinen KI-Coding-Agenten:

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

Oder wähle einzelne Skills interaktiv aus:

npx skills add timescale/pg-aiguide

Funktioniert mit Claude Code, Cursor, Codex, Gemini CLI, VS Code und über 40 weiteren Agenten.

Für noch tieferes PostgreSQL-Wissen füge auch den MCP-Server hinzu, um deinem Agenten semantische Suche im offiziellen PostgreSQL-, TimescaleDB- und PostGIS-Handbuch zu ermöglichen.

MCP-Server

Für die semantische Suche in der PostgreSQL-, TimescaleDB- und PostGIS-Dokumentation füge den öffentlichen MCP-Server hinzu:

https://mcp.tigerdata.com/docs

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

Oder er kann als Claude Code Plugin verwendet werden:

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide

Installation nach Umgebung

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"
    }
  }
}

💡 Dein erster Prompt

Nach der Installation kann pg-aiguide Postgres-Fragen beantworten oder Schemata entwerfen.

Einfaches Schema-Beispiel-Prompt

Erstelle ein Postgres-Tabellenschema zum Speichern von Benutzernamen und eindeutigen E-Mail-Adressen.

Komplexes Schema-Beispiel-Prompt

Du bist ein erfahrener Softwareentwickler. Dir wird die Aufgabe übertragen, ein Postgres-Schema für ein IoT-Geräteunternehmen zu generieren. Die Geräte sammeln Umgebungsdaten auf einer Fabrikhalle. Zu den Daten gehören Temperatur, Luftfeuchtigkeit, Druck als Hauptdatenpunkte sowie weitere Messwerte, die von Gerät zu Gerät variieren. Jedes Gerät hat eine eindeutige ID und einen menschenlesbaren Namen. Wir möchten auch den Zeitpunkt der Datenerfassung aufzeichnen. Die Analyse aktueller Daten umfasst das Auffinden von Ausreißern und Anomalien basierend auf Messwerten sowie die Analyse der Daten bestimmter Geräte für Ad-hoc-Analysen. Die Analyse historischer Daten umfasst die Analyse des Datenverlaufs eines Geräts oder das Abrufen von Statistiken für alle Geräte über lange Zeiträume.

Funktionen

Dokumentationssuche (MCP-Tools)

• search_docs Vereinheitlichtes Suchtool, das semantische (Vektorähnlichkeit) und Stichwortsuche (BM25) über mehrere Dokumentationsquellen hinweg unterstützt:
  • postgres - Offizielles PostgreSQL-Handbuch, versionsbezogen
  • tiger - Tiger-Data-Dokumentation (TimescaleDB und Ökosystem)
  • postgis - PostGIS-Dokumentation für räumliche Erweiterungen

Skills (KI-optimierte Best Practices)

• view_skill
  Stellt kuratierte, meinungsstarke PostgreSQL-Best-Practice-Skills bereit, die automatisch von KI-Coding-Assistenten genutzt werden.

  Diese Skills bieten Anleitung zu:

  • Schema-Design
  • Indizierungsstrategien
  • Datentypen
  • Datenintegrität und Constraints
  • Namenskonventionen
  • Performance-Tuning
  • Moderne PostgreSQL-Features

🔌 Ökosystem-Dokumentation

Derzeit unterstützt:

• TimescaleDB (Dokumentation + Skills)
• PostGIS (Dokumentation)

Demnächst verfügbar:

• pgvector

Wir freuen uns über Beiträge für weitere Erweiterungen und Tools.

🛠 Entwicklung

Siehe DEVELOPMENT.md für:

• lokales Ausführen des MCP-Servers
• Hinzufügen neuer Skills
• Hinzufügen neuer Dokumentationen

🤝 Mitwirken

Wir freuen uns über:

• neue Postgres-Best-Practice-Skills
• zusätzliche Dokumentationskorpora
• Verbesserungen der Suchqualität
• Fehlerberichte und Feature-Ideen

📄 Lizenz

Apache 2.0