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_libraryile 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 hamshamela_*araçlarına başvurun. Tüm sorgular Arapça olmalıdır.
Arama
| Araç | Ne zaman kullanılır |
|---|---|
shamela_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 (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_topic | Aramadan ö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 veyashamela_search_librarykullanı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ç | Girdi | Döndürür |
|---|---|---|
search | query (Arapça) | results: en fazla 10 adet { id, title, url }. id değeri bookId:pageId‘dir; url Maktabah okuyucusundaki 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 (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_quote | Bir 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_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 okuyanshamela_find(kind: 'book')‘u ya da bir kitabın metninin sunucuda olup olmadığını söyleyenshamela_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_period | shamela_find (kind: 'period') |
shamela_brief | shamela_get_brief |
shamela_get_author | shamela_get_details (kind: 'author') |
shamela_get_aya | shamela_lookup_quran (mode: 'aya') |
shamela_get_book | shamela_get_details (kind: 'book') |
shamela_get_book_parts | shamela_read (unit: 'parts') |
shamela_get_book_section | shamela_read (unit: 'section') |
shamela_get_books_for_hadith | shamela_lookup_hadith (mode: 'sources') |
shamela_get_citation | shamela_cite (mode: 'citation') |
shamela_get_isnad | shamela_lookup_rijal (mode: 'isnad') |
shamela_get_narrator | shamela_lookup_rijal (mode: 'narrator') |
shamela_get_page | shamela_read (unit: 'page') |
shamela_get_page_services | shamela_read (unit: 'services') |
shamela_get_pages_range | shamela_read (unit: 'range') |
shamela_get_tafseer_of_aya | shamela_lookup_tafsir (mode: 'coverage') |
shamela_get_tafseer_texts | shamela_lookup_tafsir (mode: 'texts') |
shamela_get_toc | shamela_read (unit: 'toc') |
shamela_guide | shamela_get_guide |
shamela_health | shamela_check_health |
shamela_list_books_by_period | shamela_find (kind: 'period') |
shamela_list_categories | shamela_find (kind: 'category') |
shamela_list_tafsirs_for_aya | shamela_lookup_tafsir (mode: 'coverage') |
shamela_recon | shamela_survey_topic (root → term) |
shamela_resolve | shamela_find (kind: 'name') |
shamela_resolve_name | shamela_find (kind: 'name') |
shamela_resolve_printed_page | shamela_cite (mode: 'printed_page') |
shamela_resolve_work | shamela_find (kind: 'work') |
shamela_root_stats | shamela_survey_topic (mode: 'morphological') (root → term) |
shamela_search_authors | shamela_find (kind: 'author') |
shamela_search_batch | shamela_search (match: 'batch') (probes → queries) |
shamela_search_books | shamela_find (kind: 'book') |
shamela_search_boolean | shamela_search (match: 'boolean') |
shamela_search_exact | shamela_search (match: 'exact') |
shamela_search_hadith | shamela_lookup_hadith (mode: 'search') |
shamela_search_isnad | shamela_lookup_rijal (mode: 'isnad_search') |
shamela_search_narrators | shamela_lookup_rijal (mode: 'narrators') |
shamela_search_pages | shamela_search (match: 'words') |
shamela_search_phrase | shamela_search (match: 'phrase' or 'near') (mode → match) |
shamela_search_quran | shamela_lookup_quran (mode: 'search') |
shamela_search_titles | shamela_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.