hs-sql-agent

Deploy dengan mudah server HTTP MCP untuk database relasional yang dilengkapi panel administrasi bawaan. hs-sql-agent memungkinkan client MCP seperti Claude Desktop, Cursor, dan Visual Studio Code mengakses database relasional secara aman, sekaligus memungkinkan administrator mengelola koneksi database, MCP key, permission, audit log, dan security policy secara terpusat. Template Zeabur ini akan secara otomatis men-deploy:

• hs-sql-agent — MCP server dan panel administrasi
• PostgreSQL — database internal untuk administrasi
• Redis — cache, rate limiting, concurrency control, dan sinkronisasi security policy

✨ Fitur Utama

• 🔌 HTTP MCP Endpoint
• 🔑 MCP Access Key terpisah untuk setiap client
• 🗄️ Manajemen beberapa koneksi database
• 🔐 Mapping database per MCP Key
• 🧰 Permission MCP Tools per MCP Key
• 🚦 Rate Limit yang dapat dikonfigurasi
• 📋 Audit log eksekusi SQL
• 🛡️ Security policy terpusat
• ⚡ Cache dan concurrency control berbasis Redis
• 🖥️ Panel administrasi web bawaan
• 📋 Konfigurasi MCP Client siap salin

🚀 Memulai

1. Deploy Template

Deploy template ini di Zeabur dan tentukan subdomain untuk panel administrasi. Zeabur akan secara otomatis membuat dan menghubungkan seluruh service yang dibutuhkan. Setelah deployment selesai, buka Admin Panel URL yang ditampilkan pada instruksi deployment Zeabur.

2. Buat Akun Administrator

Pada saat pertama kali dijalankan, buat akun administrator pertama. Setelah itu, login ke panel administrasi menggunakan akun tersebut.

3. Tambahkan Database

Buka DB Management dan tambahkan database relasional yang ingin kamu izinkan untuk diakses oleh MCP Client. Sebaiknya lakukan pengujian koneksi terlebih dahulu sebelum menerbitkan MCP Key.

4. Terbitkan MCP Access Key

Buka: Runtime Admin → MCP Keys Buat MCP Key baru dan atur hak aksesnya. Pengaturan yang tersedia meliputi:

• Nama key
• Masa berlaku
• Database
• Rate Limit
• MCP Tools yang diizinkan
• Pembatasan akses data opsional
• CORS Origins opsional Klik Test DB Connection untuk memastikan koneksi database yang dipilih berfungsi, lalu klik Issue Key.

5. Salin Konfigurasi MCP

Setelah key berhasil diterbitkan, hs-sql-agent akan langsung menampilkan dialog Save and connect. Dialog tersebut berisi:

• MCP Key yang hanya ditampilkan satu kali
• MCP Endpoint
• Konfigurasi lengkap yang sudah dibuat untuk MCP Client yang didukung Pilih client yang digunakan:
• Claude Desktop
• Cursor
• Visual Studio Code
• Generic HTTP Kemudian klik tombol Copy config yang sesuai dan tempelkan konfigurasi tersebut langsung ke MCP Client.

⚠️ Nilai plaintext MCP Key hanya ditampilkan satu kali. > > Simpan key atau salin konfigurasi client yang telah dibuat sebelum menutup dialog. Setelah dialog ditutup, nilai plaintext key tidak dapat ditampilkan kembali dari Admin UI. Selesai. Kamu tidak perlu menyusun MCP Endpoint atau authentication header secara manual.

🔐 Keamanan

Perlakukan MCP Key sebagai informasi rahasia, sama seperti password. Jangan commit konfigurasi yang berisi MCP Key ke source control, dan jangan menempelkannya ke Issue publik, ticket, atau tempat publik lainnya. Jika key terekspos, revoke key tersebut melalui halaman MCP Keys, lalu terbitkan key baru. Untuk database production, sebaiknya gunakan akun database khusus dan terapkan prinsip least privilege, dengan hanya memberikan permission yang benar-benar dibutuhkan oleh MCP Tools yang digunakan.

⚠️ Status Proyek

hs-sql-agent saat ini masih dalam pengembangan aktif. Fitur dan opsi konfigurasi dapat berubah antarversi, dan bug mungkin masih ditemukan. Jika menemukan masalah atau ingin mengajukan fitur:

• 🔗 GitHub Issues
• ⭐ GitHub Repository