Lewati ke konten

Hubungkan Gemini CLI ke server MCP teks Islam

Tambahkan server MCP Quran Gallery ke Gemini CLI dengan satu perintah atau settings.json: kitab klasik Arab, kutipan halaman cetak, tanpa perlu kunci.

Di halaman ini

Tanpa akun, tanpa masuk, tanpa kunci. Satu perintah:

gemini mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamela

Langkah

  1. Jalankan perintah di atas di dalam folder proyek Anda. Perintah ini menulis server ke .gemini/settings.json di folder itu. Tambahkan --scope user untuk menulisnya ke ~/.gemini/settings.json, sehingga berfungsi di setiap proyek.

  2. Jalankan gemini mcp list. quran-gallery semestinya tampil sebagai Connected.

    Terminal: gemini mcp add menulis server ke .gemini/settings.json, dan gemini mcp list menampilkan quran-gallery sebagai Connected.

  3. Mulai gemini dan ajukan pertanyaan yang memerlukan sebuah teks (di bawah). Gemini CLI meminta izin sebelum setiap panggilan alat untuk pertama kalinya. Setujui.

Jawabannya memberikan edisi, jilid, dan halaman cetak, serta tautan ke halaman itu di pembaca Maktabah. Tautannya berbentuk https://qurangallery.com/maktabah/book/{bookId}/{pageId}, misalnya qurangallery.com/maktabah/book/1681/10 untuk Sahih al-Bukhari, sehingga halaman terbuka di Quran Gallery:

Terminal: gemini menjawab dengan Sahih al-Bukhari, edisi Sultaniyya, jilid 1 halaman 6, dengan tautan ke halaman itu.

Untuk menghapusnya: gemini mcp remove quran-gallery.

Atau edit settings.json sendiri

Tambahkan server ke ~/.gemini/settings.json (semua proyek) atau .gemini/settings.json (satu proyek):

{
	"mcpServers": {
		"quran-gallery": {
			"url": "https://qurangallery.com/mcp/shamela",
			"type": "http"
		}
	}
}

Inilah yang ditulis oleh perintah tadi. "httpUrl": "https://qurangallery.com/mcp/shamela" juga berfungsi. Pertahankan "type": "http" di samping url, karena Gemini CLI versi lama membaca url polos sebagai endpoint SSE.

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

  • 400, “schema at properties.transmission.items.items must be a boolean or an object”. Versi server kami sebelumnya mengirim skema alat yang ditolak Gemini API, dan setiap prompt gagal dengan galat ini. Masalahnya sudah diperbaiki. Mulai ulang gemini.
  • 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 gemini dan jalankan /mcp list. Daftar alat dibaca saat startup.
  • gemini mcp list menampilkan server sebagai Disabled, atau muncul “Gemini CLI is not running in a trusted directory”. Gemini CLI menonaktifkan server MCP di folder yang belum Anda percayai, dan gemini mcp remove juga tidak menemukannya di sana. Buka gemini sekali di folder itu dan percayai. Dalam skrip atau dengan -p, Anda bisa menyertakan --skip-trust sebagai gantinya.
  • 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. Buat kunci di halaman Developers pada akun Quran Gallery Anda (cara kerja kunci), lalu kirim sebagai bearer token.

Tambahkan dengan --header (atau -H):

gemini mcp add --transport http quran-gallery 
  https://qurangallery.com/mcp/shamela 
  --header "Authorization: Bearer qg_sk_your_key_here"

Di settings.json, kunci yang sama ditaruh dalam objek headers di samping url:

{
	"mcpServers": {
		"quran-gallery": {
			"url": "https://qurangallery.com/mcp/shamela",
			"type": "http",
			"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
		}
	}
}

Jauhkan kunci dari berkas pengaturan apa pun yang Anda commit.

Langkah berikutnya

Edit halaman ini di GitHub