Klasik Arapça kitaplar için MCP araçları: tam liste

Otuz dokuz araç, hepsi salt okunur. Üçü bize aittir (search_library, search, fetch); otuz altısı kütüphane sunucusunun kendisinden gelir ve kendi adları ve şemalarıyla sunulur. Bunlara ek olarak sunucu üç istem ve bir kaynak sunar.

İstemciniz hepsini listeleyecektir. Bu sayfa bir haritadır; neyin var olduğunu ve hangisine başvuracağınızı bilirsiniz — her araç, istemcinizin zaten aldığı şemada kendi parametre belgelerini taşır.

search_library ile başlayın. Bir kapsam gerektirir ve nasıl eşleştirdiğini bildirir; bu, “bana bu metni bul” için doğru varsayılandır. Onun yapamadığı bir şeye ihtiyaç duyduğunuzda ham shamela_* araçlarına başvurun. Tüm sorgular Arapça olmalıdır.

Arama

Araç	Ne zaman kullanılır
search_library	Varsayılan. Atıflı ve eşleşme bildirimli kapsamlı arama. Bkz. başvurusu.
search	ChatGPT deep research ve company knowledge. Tüm kütüphanede tek sorgu; id, title, url içeren results döndürür. Ayrıntılar aşağıda.
shamela_search_pages	Kapsamsız dahil ham sayfa aramasını istiyorsunuz. Terim sıklığına göre sıralar — aşağıdaki uyarıyı okuyun.
shamela_search_phrase	Art arda gelen tam bir ifadeye veya yakınlık eşleştirmesine ihtiyacınız var.
shamela_search_exact	Hareke (التشكيل) ve hemze/elif biçimlerinin tam eşleşmesi gerekiyor.
shamela_search_boolean	Yalnızca AND değil, OR ve NOT’a ihtiyacınız var.
shamela_search_titles	Ana metni değil, bir bölüm veya kısım başlığını arıyorsunuz.
shamela_search_hadith	Bir hadisin ifadesine sahipsiniz ve onu taşıyan derlemeleri istiyorsunuz.
shamela_search_batch	Tek çağrıda 12’ye kadar kapsamlı arama, birleştirilmiş ve tekilleştirilmiş.
shamela_recon	Aramadan önce: kütüphane bu konuda ne kadar içerik barındırıyor ve hangi raflarda?
shamela_root_stats	Bir Arapça kökün kütüphane genelinde kategori ve yüzyıla göre dağılımı.

shamela_search_pages kapsamsız çalışır ve genellikle çalıştırılmamalıdır. Sıralama, ilmî otorite hakkında hiçbir şey bilmeyen terim sıklığına göredir. Kapsamsız olarak التيمم 26.098 sonuç döndürür ve en üstte 710 hicrî tarihli bir şiir antolojisi yer alır; إنما الأعمال بالنيات ise 6.815 sonuç döndürür ve bunlarda Sahîh-i Buhârî hiç görünmez. Bir kapsam verin veya search_library kullanın.

search ve fetch

ChatGPT deep research ve company knowledge, sabit şekle sahip iki araç bekler. Diğer istemciler de bunları kullanabilir.

Araç	Girdi	Döndürür
search	query (Arapça)	results: en fazla 10 adet { id, title, url }. id değeri bookId:pageId‘dir; url shamela.ws üzerindeki sayfadır.
fetch	Bir search sonucundan id	{ id, title, text, url, metadata }. text, ana metni ve dipnotu ayrı tutar; dipnot kendi etiketi altındadır.

İkisi de yapılandırılmış içerik ve aynı JSON’u metin olarak döndürür. search kapsamsızdır, bu yüzden shamela_search_pages gibi sıralar; istemciniz bu şekle ihtiyaç duymuyorsa search_library tercih edin.

Okuma

Araç	Ne zaman kullanılır
shamela_get_page	Bir book_id + page_id değeriniz var ve tam sayfayı istiyorsunuz — ana metin, dipnotlar ve hepsi.
shamela_get_pages_range	Art arda 20 sayfaya kadar ihtiyacınız var.
shamela_get_book_section	Tek bir bölüm başlığı altındaki her sayfayı istiyorsunuz.
shamela_get_toc	Bir kitabın içindekiler tablosu.
shamela_get_book_parts	Çok ciltli bir eserin ciltleri.
shamela_get_page_services	Bir sayfanın hangi âyetleri, hadis anahtarlarını ve isnâd işaretlerini taşıdığı.

Atıflar

Araç	Ne zaman kullanılır
shamela_resolve_printed_page	Bir atfı doğrulamak. «c. 4, s. 405» ifadesini onu taşıyan sayfa kimliklerine çevirin.
shamela_resolve_work	Atıf yapılan bir başlığı (ve yazarı ve baskıyı) bir katalog girişine çözün — ya da reddedin.
shamela_get_citation	Bir atfı üç biçimden birinde biçimlendirin.
shamela_resolve	Bir Arapça ad parçasını kitap veya yazar kimliklerine ayırt edin.

İlk iki araç, bu yüzeyin sahip olmaya değer olmasının nedenidir. “el-Muğnî, 4/405” gibi bir iddia inanılmak yerine denetlenebilir: eseri çözün, sayfayı çözün, okuyun.

İsnâd ve râvîler

Araç	Ne zaman kullanılır
shamela_search_narrators	Bir râvîyi adıyla bulun — 18.989 râvî, vefat yılları hicrî 2–774.
shamela_get_narrator	Tam dosya: nesep, vefat yılı, ṭabaqa, derecelendirmeler.
shamela_search_isnad	On hadis kitabı genelinde dizinlenmiş 45.220 zincirde arayın.
shamela_get_isnad	Bir sayfada basılı zincir(ler), râvî adları çözülmüş olarak.
shamela_get_books_for_hadith	Aynı hadisi kaydeden her derleme, ortak anahtarıyla.

Kur’an ve tefsir

Araç	Ne zaman kullanılır
shamela_search_quran	6.236 âyette arayın (Âsım’dan Hafs).
shamela_get_aya	Âyetleri numarayla veya sûre + âyet ile getirin.
shamela_get_tafseer_of_aya	Hangi tefsir kitaplarının bu âyet hakkında yorum yaptığı.
shamela_list_tafsirs_for_aya	Âyet bazında tefsir kapsama raporu.
shamela_get_tafseer_texts	Bir âyet için gerçek yorum metinleri, kaynaklar arasında, tek çağrıda.

Katalog

Araç	Ne zaman kullanılır
shamela_search_books	Kitapları ada, yazara veya bibliyografik tanıma göre bulun.
shamela_search_authors	Yazarları ada veya biyografiye göre bulun.
shamela_get_book	Bir kitabın tam metaverisi.
shamela_get_author	Bir yazarın tam metaverisi, isteğe bağlı olarak kitaplarıyla.
shamela_list_categories	Kitap sayılarıyla 41 kategorinin tamamı.
shamela_books_by_period	Kataloğu döneme göre süzün; kısıtları AND ile birleştirir.
shamela_brief	Kütüphane sunucusunun, programatik çağıranlar için kendi çalışma özeti.

İstemler

İstemciniz tarafından listelenebilecek hazır istemler. Her biri, modele sizin dilinizde yanıt vermesini söyleyen İngilizce metindir.

İstem	Argümanlar	Ne yapar
takhrij_hadith	text	Bir hadisi derlemeler arasında isnâdıyla bulur ve asla derecelendirmez. Bkz. Hadis tahrici.
cite_passage	text	Bir pasajı bulur ve baskı, cilt ve sayfayla atıf yapar.
compare_tafsir	surah, ayah	Mevcut tefsir kitaplarının bir âyet hakkında söylediklerini karşılaştırır.

Kaynak

qurangallery://grounding-rules, atıf sözleşmesini taşıyan bir text/markdown kaynağıdır. Bkz. Dayanak kuralları.

Neler açığa çıkarılmaz

Kütüphane sunucusunun üç aracı alıkonulmuştur ve bunun nedeni güçlü olmaları değildir. Sunucunun çalıştığı makine hakkında rapor verirler; bu yüzden uzak bir çağıran, bir kütüphane hakkında bilgi okuduğunu sanırken altyapımız hakkındaki bilgileri okuyor olurdu:

• shamela_list_downloaded_books — ana makinede nelerin indirildiği. Kataloğu okuyan shamela_search_books kullanın.
• shamela_health — sunucu sürümü ve dahili tanılar.
• shamela_guide — sahip olmadığınız bir arayüzü anlatan, Şamile masaüstü eklentisinin kullanım kılavuzu.

Külliyat hakkında hiçbir şey alıkonulmamıştır.