İçeriğe geç

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

Quran Gallery MCP sunucusunun 15 salt okunur aracı, 3 istem ve 1 kaynak: arama, okuma, atıf, isnâd, râvîler, tefsir, katalog.

Bu sayfada

On beş araç, her istemci için aynı; hepsi salt okunur. Dördü bize aittir (shamela_search_library, search, fetch, shamela_verify_quote); on biri kütüphane sunucusunun kendisinden gelir. Bu on birin dokuzu yönlendiricidir: her biri ne yapacağını seçen tek bir kip bağımsız değişkeni (match, kind, unit ya da mode) alır ve aşağıdaki tablolar her kipi ayrı bir satırda listeler. search ve fetch, ChatGPT deep research’ün gerektirdiği standart çifttir ve her istemci bunları görür. Araçlara ek olarak sunucu üç istem ve bir kaynak sunar.

İstemciniz bunları sizin için listeler. 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.

shamela_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
shamela_search_libraryVarsayılan. Atıflı ve eşleşme bildirimli kapsamlı arama. Bkz. başvurusu.
searchChatGPT 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 (match: 'words')Kapsamsız dahil ham sayfa aramasını istiyorsunuz. Terim sıklığına göre sıralar — aşağıdaki uyarıyı okuyun.
shamela_search (match: 'phrase')Art arda gelen tam bir ifadeye veya yakınlık eşleştirmesine ihtiyacınız var.
shamela_search (match: 'exact')Hareke (التشكيل) ve hemze/elif biçimlerinin tam eşleşmesi gerekiyor.
shamela_search (match: 'boolean')Yalnızca AND değil, OR ve NOT’a ihtiyacınız var.
shamela_find (kind: 'heading')Ana metni değil, bir bölüm veya kısım başlığını arıyorsunuz.
shamela_lookup_hadith (mode: 'search')Bir hadisin ifadesine sahipsiniz ve onu taşıyan derlemeleri istiyorsunuz.
shamela_search (match: 'batch')Tek çağrıda 24’e kadar kapsamlı arama, birleştirilmiş ve tekilleştirilmiş.
shamela_survey_topicAramadan önce: kütüphane bir terim hakkında ne kadar içerik barındırıyor ve hangi raflarda, yüzyıllarda, kitaplarda ve yazarlarda? Varsayılan olarak kelimeyi yazıldığı gibi sayar; mode: 'morphological' kökünün bütün biçimlerini sayar.

shamela_search (match: 'words') 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 shamela_search_library kullanın.

search ve fetch

ChatGPT deep research ve company knowledge, sabit şekle sahip iki araç bekler. Bunlar standart çift olarak her istemciye listelenir. Hızlı, genel bir giriştir: tek bağımsız değişken, kapsamsız. Hadis, tefsir veya fıkıh için shamela_search_library tercih edilir; kapsam, birebir ifade veya sayfalama için shamela_search kullanın.

AraçGirdiDöndürür
searchquery (Arapça)results: en fazla 10 adet { id, title, url }. id değeri bookId:pageId‘dir; url Maktabah okuyucusundaki sayfadır.
fetchBir 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 (match: 'words') gibi sıralar; istemciniz bu şekle ihtiyaç duymuyorsa shamela_search_library tercih edin.

Okuma

AraçNe zaman kullanılır
shamela_read (unit: 'page')Bir book_id + page_id değeriniz var ve tam sayfayı istiyorsunuz — ana metin, dipnotlar ve hepsi.
shamela_read (unit: 'range')Art arda 20 sayfaya kadar ihtiyacınız var.
shamela_read (unit: 'section')Tek bir bölüm başlığı altındaki her sayfayı istiyorsunuz.
shamela_read (unit: 'toc')Bir kitabın içindekiler tablosu.
shamela_read (unit: 'parts')Çok ciltli bir eserin ciltleri.
shamela_read (unit: '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_cite (mode: 'printed_page')Bir atfı doğrulamak. «c. 4, s. 405» ifadesini onu taşıyan sayfa kimliklerine çevirin.
shamela_verify_quoteBir alıntıyı denetlemek. Bu Arapça ifade kütüphanede geçiyor mu ve nerede: kitap, basılı sayfa, ana metin ya da dipnot. Bkz. Yapay zekânın aktardığı alıntıyı doğrulayın.
shamela_find (kind: 'work')Atıf yapılan bir başlığı (ve yazarı ve baskıyı) bir katalog girişine çözün — ya da reddedin.
shamela_cite (mode: 'citation')Bir atfı üç biçimden birinde biçimlendirin.
shamela_find (kind: 'name')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_lookup_rijal (mode: 'narrators')Bir râvîyi adıyla bulun — 18.989 râvî, vefat yılları hicrî 2–774.
shamela_lookup_rijal (mode: 'narrator')Tam dosya: nesep, vefat yılı, ṭabaqa, derecelendirmeler.
shamela_lookup_rijal (mode: 'isnad_search')On hadis kitabı genelinde dizinlenmiş 45.220 zincirde arayın.
shamela_lookup_rijal (mode: 'isnad')Bir sayfada basılı zincir(ler), râvî adları çözülmüş olarak.
shamela_lookup_hadith (mode: 'sources')Aynı hadisi kaydeden her derleme, ortak anahtarıyla.

Kur’an ve tefsir

AraçNe zaman kullanılır
shamela_lookup_quran (mode: 'search')6.236 âyette arayın (Âsım’dan Hafs).
shamela_lookup_quran (mode: 'aya')Âyetleri numarayla veya sûre + âyet ile getirin.
shamela_lookup_tafsir (mode: 'coverage')Hangi tefsir kitaplarının bu âyet hakkında yorum yaptığı, her birinin sayfasıyla; dizinin kapsamadığı kitaplar için de açık bir durum bilgisi. downloaded_only: false, metni sunucuda olmayan kitapları da ekler.
shamela_lookup_tafsir (mode: 'texts')Bir âyet için gerçek yorum metinleri, kaynaklar arasında, tek çağrıda.

Katalog

AraçNe zaman kullanılır
shamela_find (kind: 'book')Kitapları ada, yazara veya bibliyografik tanıma göre bulun.
shamela_find (kind: 'author')Yazarları ada veya biyografiye göre bulun.
shamela_get_details (kind: 'book')Bir kitabın tam metaverisi.
shamela_get_details (kind: 'author')Bir yazarın tam metaverisi, isteğe bağlı olarak kitaplarıyla.
shamela_find (kind: 'category')Kitap sayılarıyla 41 kategorinin tamamı.
shamela_find (kind: 'period')Kataloğu döneme göre süzün; kısıtları AND ile birleştirir.
shamela_get_briefKü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.

İstemArgümanlarNe yapar
takhrij_hadithtextBir hadisi derlemeler arasında isnâdıyla bulur ve asla derecelendirmez. Bkz. Hadis tahrici.
cite_passagetextBir pasajı bulur ve baskı, cilt ve sayfayla atıf yapar.
compare_tafsirsurah, ayahMevcut 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_find (kind: 'book')‘u ya da bir kitabın metninin sunucuda olup olmadığını söyleyen shamela_get_details (kind: 'book')‘u kullanın.
  • shamela_check_health — sunucu sürümü ve dahili tanılar.
  • shamela_get_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.

Eski araç adları

Kütüphane sunucusunun 1.4.0 sürümü 39 aracı dokuz yönlendiricide birleştirdi. Eski adlar listelenmeden çalışmaya devam eder ve sonuç, yeni aracın adını veren _meta.deprecated_alias alanını taşır. Eski adlar, 14 gün boyunca hiç çağrılmadıktan sonra kaldırılır. Tablo, her eski ad için yeni aracı ve gönderilecek kip değerini gösterir:

Eski adŞimdi
shamela_books_by_periodshamela_find (kind: 'period')
shamela_briefshamela_get_brief
shamela_get_authorshamela_get_details (kind: 'author')
shamela_get_ayashamela_lookup_quran (mode: 'aya')
shamela_get_bookshamela_get_details (kind: 'book')
shamela_get_book_partsshamela_read (unit: 'parts')
shamela_get_book_sectionshamela_read (unit: 'section')
shamela_get_books_for_hadithshamela_lookup_hadith (mode: 'sources')
shamela_get_citationshamela_cite (mode: 'citation')
shamela_get_isnadshamela_lookup_rijal (mode: 'isnad')
shamela_get_narratorshamela_lookup_rijal (mode: 'narrator')
shamela_get_pageshamela_read (unit: 'page')
shamela_get_page_servicesshamela_read (unit: 'services')
shamela_get_pages_rangeshamela_read (unit: 'range')
shamela_get_tafseer_of_ayashamela_lookup_tafsir (mode: 'coverage')
shamela_get_tafseer_textsshamela_lookup_tafsir (mode: 'texts')
shamela_get_tocshamela_read (unit: 'toc')
shamela_guideshamela_get_guide
shamela_healthshamela_check_health
shamela_list_books_by_periodshamela_find (kind: 'period')
shamela_list_categoriesshamela_find (kind: 'category')
shamela_list_tafsirs_for_ayashamela_lookup_tafsir (mode: 'coverage')
shamela_reconshamela_survey_topic (root → term)
shamela_resolveshamela_find (kind: 'name')
shamela_resolve_nameshamela_find (kind: 'name')
shamela_resolve_printed_pageshamela_cite (mode: 'printed_page')
shamela_resolve_workshamela_find (kind: 'work')
shamela_root_statsshamela_survey_topic (mode: 'morphological') (root → term)
shamela_search_authorsshamela_find (kind: 'author')
shamela_search_batchshamela_search (match: 'batch') (probes → queries)
shamela_search_booksshamela_find (kind: 'book')
shamela_search_booleanshamela_search (match: 'boolean')
shamela_search_exactshamela_search (match: 'exact')
shamela_search_hadithshamela_lookup_hadith (mode: 'search')
shamela_search_isnadshamela_lookup_rijal (mode: 'isnad_search')
shamela_search_narratorsshamela_lookup_rijal (mode: 'narrators')
shamela_search_pagesshamela_search (match: 'words')
shamela_search_phraseshamela_search (match: 'phrase' or 'near') (mode → match)
shamela_search_quranshamela_lookup_quran (mode: 'search')
shamela_search_titlesshamela_find (kind: 'heading')

Yeni adları kullanın ve ikinci sütunda gösterilen kip bağımsız değişkenini gönderin.

Sonraki adımlar

Sorular

Quran Gallery MCP sunucusunun kaç aracı var?

Her istemci için aynı olan 15 salt okunur araç. Dördü bizim, 11'i kütüphane sunucusundan gelir.

Önce hangi aracı çağırmalıyım?

shamela_search_library. Kapsam ister ve eşleşmenin nasıl yapıldığını bildirir; bu metni bul tarzı çoğu soruya uygundur.

search ve fetch ne işe yarar?

ChatGPT derin araştırmasının beklediği standart çifttir: search tüm kütüphanede tek bir Arapça sorgu çalıştırır, fetch bir sonucu kimliğiyle okur.

Bir aracın yönlendirici (router) olması ne demek?

Tek bir araç adı birkaç işlemi kapsar; match, kind, unit veya mode gibi bir argüman hangisinin çalışacağını seçer.

Sunucu prompt veya kaynak sunar mı?

Evet: takhrij_hadith, cite_passage ve compare_tafsir adlı üç prompt ile qurangallery://grounding-rules adlı bir kaynak.

Tam bir sayfayı nasıl okur veya alıntıyı nasıl doğrularım?

Sayfa okumak için unit değeri page olan shamela_read, bir Arapça alıntının kütüphanede geçip geçmediğini görmek için shamela_verify_quote kullanın.

Bu sayfayı GitHub'da düzenle