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 brutsshamela_*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_library | Le choix par défaut. Recherche cadrée avec citations et indication de l’appariement. Voir sa référence. |
search | Recherche 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_topic | Avant 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 utilisezshamela_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.
| Outil | Entrée | Renvoie |
|---|---|---|
search | query (arabe) | results : jusqu’à 10 éléments { id, title, url }. id vaut bookId:pageId ; url est la page dans le lecteur Maktabah. |
fetch | id 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_quote | Vé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_brief | Le 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.
| Prompt | Arguments | Ce qu’il fait |
|---|---|---|
takhrij_hadith | text | Localise un hadith dans les recueils avec son isnād, sans jamais l’évaluer. Voir Takhrīj d’un hadith. |
cite_passage | text | Trouve un passage et le cite avec édition, volume et page. |
compare_tafsir | surah, ayah | Compare 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. Utilisezshamela_find(kind: 'book'), qui lit le catalogue, oushamela_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 nom | Désormais |
|---|---|
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') |
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.