Aller au contenu

Outils MCP pour les livres arabes classiques : la liste complète

Les 15 outils MCP en lecture seule de Quran Gallery, plus 3 prompts et une ressource : recherche, lecture, citations, isnād, transmetteurs, tafsir.

Sur cette page

Quinze outils, les mêmes pour tous les clients, tous en lecture seule. Quatre sont les nôtres (shamela_search_library, search, fetch, shamela_verify_quote) ; onze viennent du serveur de la bibliothèque lui-même. Neuf de ces onze sont des routeurs : chacun prend un argument de mode (match, kind, unit ou mode) qui choisit ce qu’il fait, et les tableaux ci-dessous listent chaque mode sur sa propre ligne. search et fetch forment la paire standard qu’exige la recherche approfondie de ChatGPT, et tous les clients les voient. Le serveur propose en outre trois prompts et une ressource.

Votre client les liste pour vous. Cette page est une carte, pour savoir ce qui existe et lequel choisir — chaque outil porte sa propre documentation de paramètres dans le schéma que votre client a déjà reçu.

Commencez par shamela_search_library. Il exige une portée et indique comment il a apparié, ce qui est le bon défaut pour « trouve-moi ce texte ». Recourez aux outils bruts shamela_* quand vous avez besoin de ce qu’il ne sait pas faire. Toutes les requêtes doivent être en arabe.

Recherche

OutilÀ utiliser quand
shamela_search_libraryLe choix par défaut. Recherche cadrée avec citations et indication de l’appariement. Voir sa référence.
searchRecherche approfondie et connaissance d’entreprise de ChatGPT. Une requête sur toute la bibliothèque ; renvoie des results de id, title, url. Détails plus bas.
shamela_search (match: 'words')Vous voulez la recherche brute de pages, y compris sans portée. Classe par fréquence des termes — lisez l’avertissement ci-dessous.
shamela_search (match: 'phrase')Vous avez besoin d’une phrase consécutive exacte, ou d’un appariement par proximité.
shamela_search (match: 'exact')Les signes diacritiques (التشكيل) et les formes de hamza/alef doivent correspondre exactement.
shamela_search (match: 'boolean')Vous avez besoin de OR et NOT, pas seulement de AND.
shamela_find (kind: 'heading')Vous cherchez un titre de chapitre ou de section, pas le texte courant.
shamela_lookup_hadith (mode: 'search')Vous avez la formulation d’un hadith et voulez les recueils qui la portent.
shamela_search (match: 'batch')Jusqu’à 24 recherches cadrées en un appel, fusionnées et dédoublonnées.
shamela_survey_topicAvant de chercher : que contient la bibliothèque sur un terme, et sur quels rayons, siècles, livres et auteurs ? Compte par défaut le mot tel qu’il est écrit ; mode: 'morphological' compte toutes les formes de sa racine.

shamela_search (match: 'words') s’exécute sans portée, et ne devrait généralement pas. Le classement se fait par fréquence des termes, qui ignore tout de l’autorité savante. Sans portée, التيمم renvoie 26 098 résultats en tête desquels figure une anthologie poétique de 710 AH, et إنما الأعمال بالنيات renvoie 6 815 résultats où Sahih al-Bukhari n’apparaît jamais. Passez une portée, ou utilisez shamela_search_library.

search et fetch

La recherche approfondie et la connaissance d’entreprise de ChatGPT attendent deux outils aux formes fixes. Ils sont listés à tous les clients, comme paire standard. C’est une entrée générique rapide : un seul argument, sans portée. Pour le hadith, le tafsir ou le fiqh, préférez shamela_search_library ; utilisez shamela_search pour une portée, une expression exacte ou la pagination.

OutilEntréeRenvoie
searchquery (arabe)results : jusqu’à 10 éléments { id, title, url }. id vaut bookId:pageId ; url est la page dans le lecteur Maktabah.
fetchid d’un résultat de search{ id, title, text, url, metadata }. Le text garde séparés le texte principal et la note, celle-ci sous sa propre étiquette.

Les deux renvoient du contenu structuré et le même JSON en texte. search n’est pas cadré par une portée : il classe donc comme shamela_search (match: 'words') ; préférez shamela_search_library quand votre client n’a pas besoin de cette forme.

Lecture

OutilÀ utiliser quand
shamela_read (unit: 'page')Vous avez un book_id + page_id et voulez la page entière — corps, notes de bas de page, et le reste.
shamela_read (unit: 'range')Vous avez besoin de jusqu’à 20 pages consécutives.
shamela_read (unit: 'section')Vous voulez toutes les pages sous un même titre de chapitre.
shamela_read (unit: 'toc')La table des matières d’un livre.
shamela_read (unit: 'parts')Les volumes d’un ouvrage en plusieurs volumes.
shamela_read (unit: 'services')Quels versets, clés de hadith et marqueurs d’isnād une page porte.

Citations

OutilÀ utiliser quand
shamela_cite (mode: 'printed_page')Vérifier une citation. Transformer « vol. 4, p. 405 » en identifiants de pages qui la portent.
shamela_verify_quoteVérifier une citation. Cette formulation arabe figure-t-elle dans la bibliothèque, et où : livre, page imprimée, texte principal ou note. Voir Vérifier une citation donnée par une IA sur la page imprimée.
shamela_find (kind: 'work')Résoudre un titre cité (avec auteur et édition) vers une entrée du catalogue — ou refuser.
shamela_cite (mode: 'citation')Mettre en forme une citation dans l’un de trois styles.
shamela_find (kind: 'name')Lever l’ambiguïté d’un fragment de nom arabe vers des identifiants de livre ou d’auteur.

Ces deux premiers sont la raison pour laquelle cette interface vaut la peine. Une affirmation comme « al-Mughni, 4/405 » peut être vérifiée plutôt que crue : résoudre l’ouvrage, résoudre la page, lire.

Isnād et transmetteurs

OutilÀ utiliser quand
shamela_lookup_rijal (mode: 'narrators')Trouver un transmetteur par son nom — 18 989 au total, décès de 2 à 774 AH.
shamela_lookup_rijal (mode: 'narrator')La fiche complète : généalogie, année de décès, ṭabaqa, appréciations.
shamela_lookup_rijal (mode: 'isnad_search')Chercher dans 45 220 chaînes indexées de dix livres de hadith.
shamela_lookup_rijal (mode: 'isnad')La ou les chaînes imprimées sur une page, avec les noms des transmetteurs résolus.
shamela_lookup_hadith (mode: 'sources')Chaque recueil qui consigne le même hadith, par sa clé partagée.

Coran et tafsir

OutilÀ utiliser quand
shamela_lookup_quran (mode: 'search')Chercher dans les 6 236 versets (Hafs d’après Asim).
shamela_lookup_quran (mode: 'aya')Récupérer des versets par numéro, ou par sourate + verset.
shamela_lookup_tafsir (mode: 'coverage')Quels livres de tafsir commentent ce verset, avec la page de chacun, et un statut franc pour les livres que l’index ne couvre pas. downloaded_only: false ajoute les livres dont le texte n’est pas sur le serveur.
shamela_lookup_tafsir (mode: 'texts')Les textes de commentaire eux-mêmes pour un verset, toutes sources confondues, en un appel.

Catalogue

OutilÀ utiliser quand
shamela_find (kind: 'book')Trouver des livres par nom, auteur ou description bibliographique.
shamela_find (kind: 'author')Trouver des auteurs par nom ou biographie.
shamela_get_details (kind: 'book')Métadonnées complètes d’un livre.
shamela_get_details (kind: 'author')Métadonnées complètes d’un auteur, avec ses livres si l’on veut.
shamela_find (kind: 'category')Les 41 catégories avec le nombre de livres.
shamela_find (kind: 'period')Filtrer le catalogue par période, en combinant les contraintes par AND.
shamela_get_briefLe descriptif d’utilisation propre au serveur de la bibliothèque, pour les appelants programmatiques.

Prompts

Prompts prêts à l’emploi que votre client peut lister. Chacun est un texte anglais qui demande au modèle de répondre dans votre langue.

PromptArgumentsCe qu’il fait
takhrij_hadithtextLocalise un hadith dans les recueils avec son isnād, sans jamais l’évaluer. Voir Takhrīj d’un hadith.
cite_passagetextTrouve un passage et le cite avec édition, volume et page.
compare_tafsirsurah, ayahCompare ce que disent les livres de tafsir disponibles sur un verset.

Ressource

qurangallery://grounding-rules est une ressource text/markdown qui contient le contrat de citation. Voir Règles d’ancrage.

Ce qui n’est pas exposé

Trois des outils du serveur de la bibliothèque sont retenus, et non parce qu’ils seraient puissants. Ils renseignent sur la machine sur laquelle tourne le serveur : un appelant distant lirait donc des faits sur notre infrastructure en croyant lire des faits sur une bibliothèque :

  • shamela_list_downloaded_books — ce qui est téléchargé sur l’hôte. Utilisez shamela_find (kind: 'book'), qui lit le catalogue, ou shamela_get_details (kind: 'book'), qui indique si le texte d’un livre est sur le serveur.
  • shamela_check_health — version du serveur et diagnostics internes.
  • shamela_get_guide — le guide d’utilisation de l’extension de bureau Shamela, qui décrit une interface que vous n’avez pas.

Rien du corpus n’est retenu.

Anciens noms d’outils

La version 1.4.0 du serveur de la bibliothèque a fondu 39 outils en neuf routeurs. Les anciens noms fonctionnent toujours, sans être listés, et le résultat porte _meta.deprecated_alias avec le nom du nouvel outil. Ils ne seront retirés qu’après 14 jours sans aucun appel. Le tableau donne, pour chaque ancien nom, le nouvel outil et la valeur de mode à envoyer :

Ancien nomDésormais
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')

Préférez les nouveaux noms et envoyez l’argument de mode indiqué dans la deuxième colonne.

Étapes suivantes

Questions

Combien d'outils compte le serveur MCP de Quran Gallery ?

15 outils en lecture seule, identiques pour chaque client. Quatre sont les nôtres et 11 viennent du serveur de la bibliothèque.

Quel outil appeler en premier ?

shamela_search_library. Il exige une portée et indique comment la correspondance a été trouvée, ce qui convient à la plupart des questions du type trouve-moi ce texte.

À quoi servent search et fetch ?

C'est la paire standard qu'attend la recherche approfondie de ChatGPT : search prend une requête arabe sur toute la bibliothèque et fetch lit un résultat par son identifiant.

Que signifie qu'un outil est un routeur ?

Un seul nom d'outil couvre plusieurs opérations, et un argument comme match, kind, unit ou mode choisit celle qui s'exécute.

Le serveur propose-t-il des prompts ou des ressources ?

Oui : trois prompts, takhrij_hadith, cite_passage et compare_tafsir, et une ressource, qurangallery://grounding-rules.

Comment lire une page entière ou vérifier une citation ?

Utilisez shamela_read avec unit à page pour lire une page, et shamela_verify_quote pour savoir si une citation arabe figure dans la bibliothèque.

Modifier cette page sur GitHub