pg-aiguide MCP Server

pg-aiguide

Keahlian PostgreSQL yang dioptimalkan AI untuk asisten coding

pg-aiguide membantu alat coding AI menulis kode PostgreSQL yang jauh lebih baik. Ini menyediakan:

• Pencarian semantik di seluruh manual resmi PostgreSQL (sadar versi)
• "Skill" yang dioptimalkan AI — praktik terbaik Postgres yang dikurasi dan opinionated, digunakan secara otomatis oleh agen AI
• Dokumentasi ekosistem ekstensi, dimulai dengan TimescaleDB, dengan lebih banyak lagi segera hadir

Gunakan sebagai:

• Skill Agen melalui npx skills — berfungsi dengan Claude Code, Cursor, Codex, Gemini CLI, dan 40+ agen lainnya
• server MCP publik yang dapat digunakan dengan agen coding AI apa pun, atau
• plugin Claude Code yang dioptimalkan untuk digunakan dengan dukungan skill native Claude.

⭐ Mengapa pg-aiguide?

Alat coding AI sering menghasilkan kode Postgres yang:

• ketinggalan zaman
• tidak memiliki constraint dan indeks
• tidak menyadari fitur PG modern
• tidak konsisten dengan praktik terbaik dunia nyata

pg-aiguide memperbaikinya dengan memberikan pengetahuan PostgreSQL yang mendalam, berversi, dan pola yang terbukti kepada agen AI.

Lihat perbedaannya

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

🚀 Mulai Cepat

Skill Agen

Instal skill praktik terbaik PostgreSQL yang dikurasi untuk agen coding AI Anda:

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

Atau pilih skill individual secara interaktif:

npx skills add timescale/pg-aiguide

Berfungsi dengan Claude Code, Cursor, Codex, Gemini CLI, VS Code, dan 40+ agen lainnya.

Untuk pengetahuan PostgreSQL yang lebih mendalam, tambahkan juga server MCP untuk memberikan agen Anda pencarian semantik di seluruh manual resmi PostgreSQL, TimescaleDB, dan PostGIS.

Server MCP

Untuk pencarian semantik di seluruh dokumentasi PostgreSQL, TimescaleDB, dan PostGIS, tambahkan server MCP publik:

https://mcp.tigerdata.com/docs

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

Atau dapat digunakan sebagai Plugin Claude Code:

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

Instal berdasarkan lingkungan

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

💡 Prompt Pertama Anda

Setelah terinstal, pg-aiguide dapat menjawab pertanyaan Postgres atau mendesain skema.

Contoh prompt skema sederhana

Buat skema tabel Postgres untuk menyimpan nama pengguna dan alamat email unik.

Contoh prompt skema kompleks

Anda adalah seorang insinyur perangkat lunak senior. Anda diberi tugas untuk menghasilkan skema Postgres untuk perusahaan perangkat IoT. Perangkat mengumpulkan data lingkungan di lantai pabrik. Data mencakup suhu, kelembaban, tekanan, sebagai titik data utama serta pengukuran lain yang bervariasi dari perangkat ke perangkat. Setiap perangkat memiliki id unik dan nama yang dapat dibaca manusia. Kami ingin mencatat waktu data dikumpulkan juga. Analisis untuk data terbaru mencakup menemukan outlier dan anomali berdasarkan pengukuran, serta menganalisis data perangkat tertentu untuk analisis ad-hoc. Analisis data historis mencakup menganalisis riwayat data untuk satu perangkat atau mendapatkan statistik untuk semua perangkat selama periode waktu yang lama.

Fitur

Pencarian Dokumentasi (Alat MCP)

• search_docs Alat pencarian terpadu yang mendukung pencarian semantik (kesamaan vektor) dan kata kunci (BM25) di berbagai sumber dokumentasi:
  • postgres - Manual resmi PostgreSQL, dibatasi berdasarkan versi
  • tiger - Dokumentasi Tiger Data (TimescaleDB dan ekosistem)
  • postgis - Dokumentasi ekstensi spasial PostGIS

Skill (Praktik Terbaik yang Dioptimalkan AI)

• view_skill
  Mengekspos skill praktik terbaik PostgreSQL yang dikurasi dan opinionated, digunakan secara otomatis oleh asisten coding AI.

  Skill ini memberikan panduan tentang:

  • Desain skema
  • Strategi pengindeksan
  • Tipe data
  • Integritas data dan constraint
  • Konvensi penamaan
  • Penyetelan performa
  • Fitur PostgreSQL modern

🔌 Dokumentasi Ekosistem

Didukung saat ini:

• TimescaleDB (dokumentasi + skill)
• PostGIS (dokumentasi)

Segera hadir:

• pgvector

Kami menyambut kontribusi untuk ekstensi dan alat tambahan.

🛠 Pengembangan

Lihat DEVELOPMENT.md untuk:

• menjalankan server MCP secara lokal
• menambahkan skill baru
• menambahkan dokumentasi baru

🤝 Berkontribusi

Kami menyambut:

• skill praktik terbaik Postgres baru
• korpora dokumentasi tambahan
• peningkatan kualitas pencarian
• laporan bug dan ide fitur

📄 Lisensi

Apache 2.0