pgbot: Postgres-intelligentie voor AI-agenten en apps

Installatie

Je kunt pgbot installeren via de volgende opdracht:

curl -fsSL https://pgbot.dev/install | sh

Hoe het werkt

Er zijn twee manieren om verbinding te maken: direct via het netwerk, of door de agent naast een database te draaien die nooit je netwerk verlaat.

• Directe PostgreSQL-toegang: Geschikt voor Supabase, Neon, RDS, PlanetScale en publieke databases.
• pgBot agent: Geschikt voor Docker, Kubernetes, private servers en VPC's.

Functionaliteiten

Verbind elke PostgreSQL-database en krijg inzicht in prestaties, queries, gezondheid, schema's en wijzigingen, ondersteund door AI-gestuurde uitleg.

1. Realtime databasegezondheid monitoren: Houd verbindingen, locks, transacties, cache hit ratio, replicatie, WAL en de algemene gezondheid van de database in de gaten.
2. Query-prestaties begrijpen: Track trage queries, regressies, throughput, query-latentie en kostbare SQL-opdrachten met behulp van PostgreSQL-statistieken.
3. Tabellen en indexen inspecteren: Analyseer tabelgroei, indexgebruik, ongebruikte indexen, missende indexen, vacuum-activiteit en opslagpatronen.
4. AI-gestuurde inzichten: Stel vragen aan pgBot in gewone taal en ontvang samenvattingen, uitleg en aanbevelingen op basis van echte database-signalen.
5. Compatibiliteit met alle PostgreSQL-versies: Maak direct verbinding met publieke databases of gebruik de pgBot Agent voor private omgevingen zoals Docker, Kubernetes en interne servers.
6. Gebouwd voor veilig productief gebruik: De tool biedt alleen-lezen toegang, maakt gebruik van een open-source agent en ondersteunt private implementaties zonder dat je database publiekelijk hoeft te worden blootgesteld.

MCP — gebruik pgbot als tool voor AI-agenten

pgbot mcp spreekt het Model Context Protocol via stdio, waardoor een AI-agent pgbot kan aanroepen als een read-only tool. Het stelt uitsluitend deterministische tools beschikbaar — inspect (volledige bevindingen als JSON) en unused_indexes — en laat het gekoppelde model de uitleg verzorgen. Er is geen Gemini-sleutel vereist; de agent redeneert over dezelfde bevindingen die de CLI berekent.

Configuratie

Voeg het toe aan elke MCP-client (zoals Claude Desktop/Code, Cursor, etc.):

{
  "mcpServers": {
    "pgbot": {
      "command": "pgbot",
      "args": ["mcp"],
      "env": { "DATABASE_URL": "postgres://pgbot_ro@host:5432/db" }
    }
  }
}

Veiligheid en werking

Van ontwerp is de tool alleen-lezen. Wanneer DATABASEURL is ingesteld, roept de agent inspect aan zonder argumenten; alternatief kan per aanroep een connectionstring worden meegegeven om meerdere databases te bereiken. Omdat pgbot nooit schrijft, kan een agent niets beschadigen.

Tools, prompts en resources

Daarnaast biedt het een diagnose prompt — een workflow in één klik om te inspecteren en een geprioriteerde diagnose te krijgen — en een pgbot://baselines resource met een lijst van databases waarvoor pgbot lokale historie heeft.

Kernfuncties

• Monitoring van PostgreSQL-gezondheid
• Analyse van query-prestaties
• Detectie van trage queries en regressies
• Inzicht in locks en blokkerende queries
• Analyse van tabellen en indexen
• Zichtbaarheid van vacuum en autovacuum
• Tracking van databasegroei
• AI-analyse van de bronoorzaak (root-cause)
• AI-gestuurde aanbevelingen
• Directe verbinding of private toegang via agent

Waarom pgBot?

• Niet alleen metrics, maar context: pgBot helpt je begrijpen wat er is veranderd en waarom dat belangrijk is.
• Niet alleen dashboards, maar uitleg: Stel vragen in gewone taal en krijg bruikbare antwoorden.
• Niet alleen voor hosted Postgres: Gebruik pgBot met Supabase, Neon, RDS, Docker, Kubernetes en private servers.
• Niet alleen observability, maar een AI DBA: Krijg inzichten die je helpen problemen sneller te vinden en betere beslissingen te nemen.
• Veiligheid voorop: Richt het op een database en wees gerust; het is standaard alleen-lezen. Er verlaat niets je infrastructuur tenzij je dat expliciet aangeeft.