Lewati ke konten

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

  1. Buat .vscode/mcp.json di workspace Anda (atau jalankan MCP: Add Server dari Command Palette):
{
	"servers": {
		"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. Mulai server dari aksi Start di atas entrinya dan percayai.
  2. Buka tampilan obrolan Copilot dan beralih ke mode Agent. Buka pemilih alat dan pastikan alat quran-gallery tercentang.
  3. 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; /mcp saja 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).

Langkah berikutnya

Edit halaman ini di GitHub