Pakai server MCP perpustakaan Islam dengan GitHub Copilot
Beri mode agen GitHub Copilot di VS Code server MCP Quran Gallery: kitab klasik Arab dengan kutipan halaman cetak, tanpa akun atau kunci.
Di halaman ini
Tanpa akun, tanpa masuk, tanpa kunci. GitHub Copilot di VS Code memakai konfigurasi MCP yang sama dengan VS Code sendiri, dan memanggil alat MCP dari mode agen.
Langkah
- Buat
.vscode/mcp.jsondi workspace Anda (atau jalankan MCP: Add Server dari Command Palette):
{
"servers": {
"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
}
}- Mulai server dari aksi Start di atas entrinya dan percayai.
- Buka tampilan obrolan Copilot dan beralih ke mode Agent. Buka pemilih alat dan pastikan alat quran-gallery tercentang.
- Ajukan pertanyaan yang memerlukan sebuah teks (di bawah).
Kebijakan organisasi dapat menonaktifkan server MCP untuk Copilot; bila alat tak kunjung muncul, tanyakan kepada administrator Anda apakah MCP diizinkan. Langkah lengkap dan pengaturan kunci ada di halaman 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. Buka pemilih alat dan pastikan server tercentang; mulai ulang server dari MCP: List Servers.
- 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. Tambahkan entri headers persis seperti di halaman VS Code. Buat kunci di halaman Developers pada akun Quran Gallery Anda (cara kerja kunci).