Gemini CLI'ı İslami metinler için MCP sunucusuna bağlayın
Quran Gallery MCP sunucusunu Gemini CLI'a tek komutla veya settings.json ile ekleyin: klasik Arapça kitaplar, basılı sayfa atıfları, anahtar gerekmez.
Bu sayfada
Hesap, oturum açma, anahtar yok. Tek komut:
gemini mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamelaAdımlar
Yukarıdaki komutu proje klasörünüzün içinde çalıştırın. Sunucuyu o klasördeki
.gemini/settings.jsondosyasına yazar. Her projede çalışması için~/.gemini/settings.jsondosyasına yazmak üzere--scope userekleyin.gemini mcp listkomutunu çalıştırın.quran-galleryConnected olarak görünmelidir.
geminikomutunu başlatın ve bir metin gerektiren soru sorun (aşağıda). Gemini CLI her araç çağrısından önce ilk seferde sorar. Onaylayın.
Yanıt baskıyı, cildi ve basılı sayfayı ve Maktabah okuyucusundaki sayfaya bir bağlantıyı verir. Bağlantı https://qurangallery.com/maktabah/book/{bookId}/{pageId} biçimindedir; örneğin Sahih al-Bukhari için qurangallery.com/maktabah/book/1681/10. Böylece sayfa Quran Gallery’de açılır:

Kaldırmak için: gemini mcp remove quran-gallery.
Veya settings.json dosyasını kendiniz düzenleyin
Sunucuyu ~/.gemini/settings.json (tüm projeler) veya .gemini/settings.json (tek proje) dosyasına ekleyin:
{
"mcpServers": {
"quran-gallery": {
"url": "https://qurangallery.com/mcp/shamela",
"type": "http"
}
}
}Komutun yazdığı budur. "httpUrl": "https://qurangallery.com/mcp/shamela" de çalışır. "type": "http" ifadesini url yanında tutun, çünkü eski Gemini CLI sürümleri yalın bir url değerini SSE uç noktası olarak okur.
Denenecek ilk istem
«إنما الأعمال بالنيات» hadisini birincil derlemelerde bul ve hangi kitapta, hangi baskıda, hangi cilt ve sayfada basılı olduğunu söyle. Arapça metni birebir alıntıla.
Asistanınız shamela_search_library aracını (veya search, ardından fetch) çağırmalıdır. Sonuçlar, Maktabah okuyucusundaki sayfa bağlantısıyla birlikte صحيح البخاري, ط السلطانية, sayfa 1/6 içerir. Asistan bunun yerine hafızasından yanıt verirse şunu söyleyin: “Quran Gallery kütüphane aracını kullan ve döndürdüğü metni alıntıla.”
Arama sorguları Arapça olmalıdır; asistanınız İngilizce terimleri önce Arapçaya çevirir (ayrıntılar). Tahrîc, bir pasajı kaynak gösterme ve tefsir karşılaştırma için hazır istemler araçların tam listesinde yer alır.
Sorun giderme
- 400, “schema at properties.transmission.items.items must be a boolean or an object”. Sunucumuzun önceki bir sürümü, Gemini API’sinin reddettiği bir araç şeması gönderiyordu ve her istem bu hatayla başarısız oluyordu. Düzeltildi.
geminikomutunu yeniden başlatın. - 429, “Keyless limit reached”. Anahtarsız kullanımda IP adresi başına dakikada 10, günde 200 araç çağrısına izin verilir.
Retry-Afterbaşlığındaki süre kadar bekleyin veya ücretsiz bir anahtar ekleyin (aşağıda). Bkz. Sınırlar ve hatalar. - 503. Sunucu veya arkasındaki kütüphane kısa süreliğine kullanılamıyor.
Retry-Afterbaşlığındaki süreden sonra yeniden deneyin. İstemci sıfır araç listeliyorsa bir dakika bekleyip yeniden bağlanın. - Araçlar görünmüyor veya beklediğiniz bir araç eksik.
geminikomutunu yeniden başlatın ve/mcp listçalıştırın. Araç listesi başlangıçta okunur. gemini mcp listsunucuyu Disabled olarak gösteriyor veya “Gemini CLI is not running in a trusted directory” hatası çıkıyor. Gemini CLI, güvenmediğiniz bir klasörde MCP sunucularını kapatır vegemini mcp removede onları orada bulamaz. O klasördegeminikomutunu bir kez açıp klasöre güvenin. Bir betikte veya-pile bunun yerine--skip-trustekleyebilirsiniz.- Bağlantı hemen başarısız oluyor. Uç nokta
/mcp/shamelaadresidir; yalın/mcpbir web sayfasıdır, sunucu değildir.
İsteğe bağlı: daha yüksek sınırlar için ücretsiz anahtar
Anahtar hiçbir zaman zorunlu değildir. Ücretsiz bir anahtar sınırı dakikada 60 çağrıya çıkarır ve anahtarsız kullanımdaki sayfa aralığı kısıtlarını kaldırır. Quran Gallery hesabınızın Developers sayfasında bir anahtar oluşturun (anahtarlar nasıl çalışır), ardından bunu bearer token olarak gönderin.
--header (veya -H) ile ekleyin:
gemini mcp add --transport http quran-gallery
https://qurangallery.com/mcp/shamela
--header "Authorization: Bearer qg_sk_your_key_here"settings.json içinde aynı anahtar, url yanındaki bir headers nesnesine girer:
{
"mcpServers": {
"quran-gallery": {
"url": "https://qurangallery.com/mcp/shamela",
"type": "http",
"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
}
}
}Anahtarı, commit ettiğiniz hiçbir ayar dosyasında tutmayın.