İçeriğe geç

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/shamela

Adımlar

  1. Yukarıdaki komutu proje klasörünüzün içinde çalıştırın. Sunucuyu o klasördeki .gemini/settings.json dosyasına yazar. Her projede çalışması için ~/.gemini/settings.json dosyasına yazmak üzere --scope user ekleyin.

  2. gemini mcp list komutunu çalıştırın. quran-gallery Connected olarak görünmelidir.

    Bir terminal: gemini mcp add sunucuyu .gemini/settings.json dosyasına yazar ve gemini mcp list quran-gallery'yi Connected olarak gösterir.

  3. gemini komutunu 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:

Bir terminal: gemini, Sahih al-Bukhari, Sultaniyya baskısı, cilt 1 sayfa 6 ve sayfaya giden bir bağlantıyla yanıt veriyor.

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. gemini komutunu 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-After baş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-After baş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. gemini komutunu yeniden başlatın ve /mcp list çalıştırın. Araç listesi başlangıçta okunur.
  • gemini mcp list sunucuyu 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 ve gemini mcp remove de onları orada bulamaz. O klasörde gemini komutunu bir kez açıp klasöre güvenin. Bir betikte veya -p ile bunun yerine --skip-trust ekleyebilirsiniz.
  • Bağlantı hemen başarısız oluyor. Uç nokta /mcp/shamela adresidir; yalın /mcp bir 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.

Sonraki adımlar

Bu sayfayı GitHub'da düzenle