İçeriğe geç

İslami kütüphane MCP sunucusunu GitHub Copilot ile kullanın

VS Code'daki GitHub Copilot agent moduna Quran Gallery MCP sunucusunu verin: basılı sayfa atıflı klasik Arapça kitaplar, hesap ve anahtar gerekmez.

Bu sayfada

Hesap, oturum açma, anahtar yok. VS Code’daki GitHub Copilot, VS Code’un kendisiyle aynı MCP yapılandırmasını kullanır ve MCP araçlarını agent modundan çağırır.

Adımlar

  1. Çalışma alanınızda .vscode/mcp.json dosyasını oluşturun (veya Komut Paletinden MCP: Add Server komutunu çalıştırın):
{
	"servers": {
		"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. Girişin üstündeki Start eylemiyle sunucuyu başlatın ve güvenin.
  2. Copilot sohbet görünümünü açın ve Agent moduna geçin. Araç seçiciyi açıp quran-gallery araçlarının işaretli olduğunu doğrulayın.
  3. Bir metin gerektiren soru sorun (aşağıda).

Kurum politikası Copilot için MCP sunucularını devre dışı bırakabilir; araçlar hiç görünmezse yöneticinize MCP’ye izin verilip verilmediğini sorun. Tam adımlar ve anahtar kurulumu VS Code sayfasında yer alır.

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. Araç seçiciyi açın ve sunucunun işaretli olduğundan emin olun; sunucuyu MCP: List Servers üzerinden 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. VS Code sayfasında gösterildiği gibi bir headers girişi ekleyin. Quran Gallery hesabınızın Developers sayfasında bir anahtar oluşturun (anahtarlar nasıl çalışır).

Sonraki adımlar

Bu sayfayı GitHub'da düzenle