pg-aiguide

pg-aiguide

Yapay zeka odaklı PostgreSQL uzmanlığı, kodlama asistanları için

pg-aiguide, yapay zeka kodlama araçlarının çok daha iyi PostgreSQL kodu yazmasına yardımcı olur. Şunları sağlar:

• Anlamsal arama resmi PostgreSQL kılavuzunda (sürüm duyarlı)
• Yapay zeka odaklı "beceriler" — yapay zeka ajanları tarafından otomatik olarak kullanılan, seçilmiş ve görüşlü Postgres en iyi uygulamaları
• Eklenti ekosistemi dokümantasyonu, TimescaleDB ile başlayan ve yakında daha fazlası gelecek

Şu şekilde kullanın:

• Ajan Becerileri npx skills ile — Claude Code, Cursor, Codex, Gemini CLI ve 40'tan fazla diğer ajanla çalışır
• Herhangi bir yapay zeka kodlama ajanıyla kullanılabilen genel bir MCP sunucusu, veya
• Claude'un yerel beceri desteğiyle kullanılmak üzere optimize edilmiş bir Claude Code eklentisi.

⭐ Neden pg-aiguide?

Yapay zeka kodlama araçları genellikle şu özelliklere sahip Postgres kodu üretir:

• güncel olmayan
• kısıtlamalar ve indeksler eksik
• modern PG özelliklerinden habersiz
• gerçek dünya en iyi uygulamalarıyla tutarsız

pg-aiguide, yapay zeka ajanlarına derin, sürümlü PostgreSQL bilgisi ve kanıtlanmış desenler vererek bunu düzeltir.

Farkı görün

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

🚀 Hızlı Başlangıç

Ajan Becerileri

Yapay zeka kodlama ajanınız için seçilmiş PostgreSQL en iyi uygulama becerilerini yükleyin:

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

Veya mevcut bir PostgreSQL veritabanını incelemek için şema keşif becerisini yükleyin:

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

Veya bireysel becerileri etkileşimli olarak seçin:

npx skills add timescale/pg-aiguide

Claude Code, Cursor, Codex, Gemini CLI, VS Code ve 40'tan fazla diğer ajanla çalışır.

Daha derin PostgreSQL bilgisi için, ajanınıza resmi PostgreSQL, TimescaleDB ve PostGIS kılavuzları üzerinde anlamsal arama yeteneği vermek üzere MCP sunucusunu da ekleyin.

MCP Sunucusu

PostgreSQL, TimescaleDB ve PostGIS dokümantasyonu üzerinde anlamsal arama için genel MCP sunucusunu ekleyin:

https://mcp.tigerdata.com/docs

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

Veya bir Claude Code Eklentisi olarak kullanılabilir:

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

Ortama göre kurulum

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pg-aiguide": {
      "type": "remote",
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

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

💡 İlk Komutunuz

Kurulduktan sonra, pg-aiguide Postgres sorularını yanıtlayabilir veya şemalar tasarlayabilir.

Basit şema örnek komutu

Kullanıcı adlarını ve benzersiz e-posta adreslerini saklamak için bir Postgres tablo şeması oluşturun.

Karmaşık şema örnek komutu

Kıdemli bir yazılım mühendisisiniz. Bir IoT cihaz şirketi için Postgres şeması oluşturma görevi verildi. Cihazlar bir fabrika katında çevresel veriler toplar. Veriler ana veri noktaları olarak sıcaklık, nem, basıncı ve cihazdan cihaza değişen diğer ölçümleri içerir. Her cihazın benzersiz bir kimliği ve insan tarafından okunabilir bir adı vardır. Verilerin toplandığı zamanı da kaydetmek istiyoruz. Yakın tarihli veri analizi, ölçümlere dayalı aykırı değerleri ve anormallikleri bulmayı ve belirli cihazların verilerini geçici analiz için analiz etmeyi içerir. Geçmiş veri analizi, bir cihazın veri geçmişini analiz etmeyi veya uzun zaman dilimleri boyunca tüm cihazlar için istatistikler almayı içerir.

Özellikler

Dokümantasyon Arama (MCP Araçları)

• search_docs Birden fazla dokümantasyon kaynağında anlamsal (vektör benzerliği) ve anahtar kelime (BM25) aramayı destekleyen birleşik arama aracı:
  • postgres - Resmi PostgreSQL kılavuzu, sürüme göre kapsamlandırılmış
  • tiger - Tiger Data'nın dokümantasyonu (TimescaleDB ve ekosistem)
  • postgis - PostGIS uzamsal uzantı dokümantasyonu

Beceriler (Yapay Zeka Odaklı En İyi Uygulamalar)

• view_skill
  Yapay zeka kodlama asistanları tarafından otomatik olarak kullanılan, seçilmiş ve görüşlü PostgreSQL en iyi uygulama becerilerini sunar.

  Bu beceriler şu konularda rehberlik sağlar:

  • Mevcut PostgreSQL şemalarını ve nesnelerini keşfetme
  • Şema tasarımı
  • İndeksleme stratejileri
  • Veri türleri
  • Veri bütünlüğü ve kısıtlamalar
  • Adlandırma kuralları
  • Performans ayarlama
  • Modern PostgreSQL özellikleri

🔌 Ekosistem Dokümantasyonu

Bugün desteklenenler:

• TimescaleDB (dokümantasyon + beceriler)
• PostGIS (dokümantasyon)

Yakında:

• pgvector

Ek uzantılar ve araçlar için katkılarınızı memnuniyetle karşılıyoruz.

🛠 Geliştirme

DEVELOPMENT.md dosyasına bakın:

• MCP sunucusunu yerel olarak çalıştırma
• yeni beceriler ekleme
• yeni dokümantasyon ekleme

🤝 Katkıda Bulunma

Şunları memnuniyetle karşılıyoruz:

• yeni Postgres en iyi uygulama becerileri
• ek dokümantasyon külliyatları
• arama kalitesi iyileştirmeleri
• hata raporları ve özellik fikirleri

📄 Lisans

Apache 2.0