İçeriğe geç

İslami kütüphane MCP sunucusunu VS Code'a ekleyin

Quran Gallery MCP sunucusunu mcp.json ile VS Code'a ekleyin, anahtar gerekmez; sohbette basılı sayfa atıflı klasik Arapça kitaplarda arama yapın.

Bu sayfada

Hesap, oturum açma, anahtar yok. VS Code, MCP sunucularını bir mcp.json dosyasından okur.

Adımlar

  1. Çalışma alanınızda .vscode/mcp.json dosyasını oluşturun. (Ya da Komut Paletinden MCP: Add Server komutunu çalıştırıp yönlendirmeyi izleyin; HTTP türünü ve aşağıdaki URL’yi seçin.)
  2. Sunucuyu ekleyin:
{
	"servers": {
		"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. Kaydedin. VS Code, sunucu girişinin üstünde bir Start eylemi gösterir; sunucuyu başlatın ve sorulduğunda güvenin.
  2. Sohbet görünümünü agent modunda açın, quran-gallery öğesinin araç listesinde göründüğünü kontrol edin ve bir soru sorun (aşağıda).

Aynı kurulum için GitHub Copilot üzerinden bkz. VS Code’da GitHub Copilot. /mcp sayfasında VS Code için tek tıkla kurulum düğmesi bulunur.

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

  • 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; istemci sıfır araç listeliyorsa bir dakika bekleyip yeniden bağlanın.
  • Araçlar görünmüyor veya beklediğiniz bir araç eksik. mcp.json düzenleyicisinden sunucuyu yeniden başlatın (satır içi Restart eylemi) veya MCP: List Servers çalıştırıp oradan yeniden başlatın.
  • 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.

Sunucuya bir headers girişi ekleyin:

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

Anahtar içeren bir çalışma alanı dosyasını commit etmeyin.

Sonraki adımlar

Bu sayfayı GitHub'da düzenle