İçeriğe geç

Cursor'ı İslami metinler için MCP sunucusuna bağlayın

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

Bu sayfada

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

Adımlar

  1. ~/.cursor/mcp.json (tüm projeler) veya bir projedeki .cursor/mcp.json (yalnızca o proje) dosyasını açın. Dosya yoksa oluşturun.
  2. Sunucuyu ekleyin:
{
	"mcpServers": {
		"quran-gallery": { "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. Kaydedin. Cursor, MCP sunucularını Customize sayfasında listeler; quran-gallery araçlarıyla birlikte etkin görünmelidir.
  2. Agent modunda bir sohbet açın ve bir metin gerektiren soru sorun (aşağıda).

/mcp sayfasında Cursor için tek tıkla kurulum düğmesi de 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. Cursor’ın MCP listesinde sunucuyu kapatıp açın veya Cursor’ı yeniden başlatın; araç listesi oturum başına önbelleğe alınır.
  • 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.

Bir headers girişi ekleyin:

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

Anahtar içeren dosyayı git dışında tutun.

Sonraki adımlar

Bu sayfayı GitHub'da düzenle