pg-aiguide MCP Server

pg-aiguide

Kodlama asistanları için AI-optimize edilmiş PostgreSQL uzmanlığı

pg-aiguide, AI kodlama araçlarının çok daha iyi PostgreSQL kodu yazmasına yardımcı olur. Sağladıkları:

• Resmi PostgreSQL kılavuzu üzerinde anlamsal arama (sürüm farkında)
• AI-optimize edilmiş “beceriler” — AI ajanları tarafından otomatik olarak kullanılan, seçilmiş, görüş bildiren Postgres en iyi uygulamaları
• Eklenti ekosistemi dokümanları, TimescaleDB ile başlayarak, yakında daha fazlası eklenecek

Şu şekilde kullanın:

• npx skills aracılığıyla Ajan Becerileri — Claude Code, Cursor, Codex, Gemini CLI ve 40'tan fazla diğer ajanla çalışır
• herhangi bir AI kodlama ajanıyla kullanılabilen bir genel MCP sunucusu veya
• Claude'un yerel beceri desteğiyle kullanım için optimize edilmiş bir Claude Code eklentisi.

⭐ Neden pg-aiguide?

AI kodlama araçları genellikle şu tür 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, AI ajanlarına derin, sürümlendirilmiş 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

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

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

Veya etkileşimli olarak bireysel beceriler seçin:

npx skills add timescale/pg-aiguide

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

Daha da derin PostgreSQL bilgisi için, ajanınıza resmi PostgreSQL, TimescaleDB ve PostGIS kılavuzları üzerinde anlamsal arama sağlamak ü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 yükleme

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

💡 İ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 bir Postgres şeması oluşturma görevi verildi. Cihazlar bir fabrika zemininde çevresel veriler toplar. Veriler ana veri noktaları olarak sıcaklık, nem, basınç 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. Verinin toplandığı zamanı da kaydetmek istiyoruz. Son veriler için analiz, ölçümlere dayalı aykırı değerleri ve anormallikleri bulmayı ve belirli cihazların verilerini geçici analiz için incelemeyi 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 çok dokümantasyon kaynağında anlamsal (vektör benzerliği) ve anahtar kelime (BM25) aramasını 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 mekansal eklenti dokümantasyonu

Beceriler (AI-Optimize Edilmiş En İyi Uygulamalar)

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

  Bu beceriler şu konularda rehberlik sağlar:

  • Şema tasarımı
  • İndeksleme stratejileri
  • Veri tipleri
  • Veri bütünlüğü ve kısıtlamalar
  • Adlandırma kuralları
  • Performans ayarlama
  • Modern PostgreSQL özellikleri

🔌 Ekosistem Dokümantasyonu

Bugün desteklenenler:

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

Yakında:

• pgvector

Ek eklentiler ve araçlar için katkıları memnuniyetle karşılıyoruz.

🛠 Geliştirme

Şunlar için DEVELOPMENT.md dosyasına bakın:

• MCP sunucusunu yerel olarak çalıştırma
• yeni beceriler ekleme
• yeni dokümanlar 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