Tambahkan server MCP perpustakaan Islam ke VS Code
Tambahkan server MCP Quran Gallery ke VS Code lewat mcp.json tanpa kunci, dan cari kitab klasik Arab dengan kutipan halaman cetak di obrolan.
Di halaman ini
Tanpa akun, tanpa masuk, tanpa kunci. VS Code membaca server MCP dari berkas mcp.json.
Langkah
- Di workspace Anda, buat
.vscode/mcp.json. (Atau jalankan MCP: Add Server dari Command Palette dan ikuti alur terpandu, pilih tipe HTTP dan URL di bawah.) - Tambahkan server:
{
"servers": {
"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
}
}- Simpan. VS Code menampilkan aksi Start di atas entri server; mulai dan percayai saat diminta.
- Buka tampilan obrolan dalam mode agen, pastikan quran-gallery muncul di daftar alat, lalu ajukan pertanyaan (di bawah).
Untuk pengaturan yang sama lewat GitHub Copilot, lihat GitHub Copilot di VS Code. Halaman /mcp memiliki tombol pasang satu klik untuk VS Code.
Prompt pertama untuk dicoba
Carilah hadis «إنما الأعمال بالنيات» di kitab-kitab hadis primer dan beri tahu saya di kitab, edisi, jilid, dan halaman mana ia dicetak. Kutip teks Arabnya persis.
Asisten Anda semestinya memanggil shamela_search_library (atau search lalu fetch). Hasilnya mencakup صحيح البخاري, ط السلطانية, halaman 1/6, dengan tautan ke halaman itu di pembaca Maktabah. Bila ia menjawab dari memori, katakan: “Gunakan alat perpustakaan Quran Gallery dan kutip apa yang dikembalikannya.”
Kueri pencarian harus berbahasa Arab; asisten Anda menerjemahkan istilah berbahasa Indonesia lebih dulu (detail). Prompt siap pakai untuk takhrīj, mengutip kutipan, dan membandingkan tafsir tercantum di seluruh alat.
Pemecahan masalah
- 429, “Keyless limit reached”. Pemakaian tanpa kunci mengizinkan 10 panggilan alat per menit dan 200 per hari per alamat IP. Tunggu sesuai header
Retry-After, atau tambahkan kunci gratis (di bawah). Lihat Batas dan galat. - 503. Server atau perpustakaan di baliknya sementara tidak tersedia. Coba lagi setelah header
Retry-After; bila klien menampilkan nol alat, tunggu semenit lalu sambungkan ulang. - Alat tidak muncul, atau alat yang Anda harapkan tidak ada. Mulai ulang server dari editor
mcp.json(aksi Restart di baris) atau jalankan MCP: List Servers lalu mulai ulang. - Koneksi langsung gagal. Endpoint-nya
/mcp/shamela;/mcpsaja adalah halaman web, bukan server.
Opsional: kunci gratis untuk batas lebih tinggi
Kunci tidak pernah wajib. Kunci gratis menaikkan batas menjadi 60 panggilan per menit dan mencabut batas rentang halaman tanpa kunci. Buat kunci di halaman Developers pada akun Quran Gallery Anda (cara kerja kunci), lalu kirim sebagai bearer token.
Tambahkan entri headers ke server:
{
"servers": {
"quran-gallery": {
"type": "http",
"url": "https://qurangallery.com/mcp/shamela",
"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
}
}
}Jangan commit berkas workspace yang berisi kunci.