Aller au contenu

Model Context Protocol

Donnez la bibliothèque à votre IA.Serveur MCP pour les textes islamiques classiques

Laissez un assistant IA lire les textes islamiques classiques et citer une vraie édition imprimée, avec volume, page et l'arabe mot pour mot, au lieu d'une référence tirée de sa mémoire.

Point d'accès

https://qurangallery.com/mcp/shamela

Streamable HTTPPOSTaucune authentification

Fonctionne avec
  • ChatGPT
  • Claude
  • Copilot
  • et d'autres Cursor VS Code Gemini CLI

8 594 œuvres3 188 auteurssans clégratuit

01 · Connexion

Une URL, dans le client que vous utilisez déjà.

Collez le point d'accès dans votre assistant et posez une question. Ni compte ni clé pour commencer.

Claude claude.ai et Claude Desktop

  1. Ouvrez Settings → Connectors → Add custom connector.
  2. Nommez-le Quran Gallery, collez le point d'accès et laissez les réglages avancés vides.
  3. Activez-le pour une conversation depuis le menu des outils.
point d'accès
https://qurangallery.com/mcp/shamela

ChatGPT Developer mode

  1. Ouvrez Settings → Apps & Connectors → Advanced settings et activez Developer mode.
  2. Créez un connecteur avec le point d'accès et réglez Authentication sur No authentication.
  3. Choisissez-le dans le menu du mode développeur de la zone de saisie, dans une nouvelle conversation.
point d'accès
https://qurangallery.com/mcp/shamela

Claude Code Terminal

  1. Lancez cette commande une fois dans votre terminal.
bash
claude mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamela

Cursor ~/.cursor/mcp.json

  1. Ajoutez le serveur à ~/.cursor/mcp.json.
  2. Redémarrez le client s'il vous le demande.
~/.cursor/mcp.json
{
  "mcpServers": {
    "quran-gallery": {
      "url": "https://qurangallery.com/mcp/shamela"
    }
  }
}

VS Code .vscode/mcp.json

  1. Ajoutez le serveur à .vscode/mcp.json.
  2. Redémarrez le client s'il vous le demande.
.vscode/mcp.json
{
  "servers": {
    "quran-gallery": {
      "type": "http",
      "url": "https://qurangallery.com/mcp/shamela"
    }
  }
}

Gemini CLI ~/.gemini/settings.json

  1. Ajoutez le serveur à ~/.gemini/settings.json.
  2. Redémarrez le client s'il vous le demande.
~/.gemini/settings.json
{
  "mcpServers": {
    "quran-gallery": {
      "httpUrl": "https://qurangallery.com/mcp/shamela"
    }
  }
}

02 · Ce qui revient

Un passage, un livre et une page vérifiables.

Un vrai résultat de search_library pour le hadith le plus cité de l'islam, sans retouche. C'est ce que reçoit votre assistant avant d'écrire un mot.

Requête

search_library(query: "إنما الأعمال بالنيات", scope: "hadith-primary")

Passage 3 sur 38 livres parcourus

…عُمَرَ بْنَ الْخَطَّابِ ﵁ عَلَى الْمِنْبَرِ، قَالَ: سَمِعْتُ رَسُولَ اللهِ ﷺ، يَقُولُ: «إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ، وَإِنَّمَا لِكُلِّ امْرِئٍ مَا نَوَى، فَمَنْ كَانَتْ هِجْرَتُهُ إِلَى دُنْيَا يُصِيبُهَا، أَوْ إِلَى امْرَأَ…
Livre
صحيح البخاري - ط السلطانية
Auteur
البخاري m. 256 H
Volume / page
1/ 6
Édition
ط السلطانية
Éditeur
السلطانية
Source
shamela.ws
Trouvé dans
Le texte principal, pas une note · Expression exacte
Résultat brut
{
  "book": "صحيح البخاري - ط السلطانية",
  "author": "البخاري",
  "authorDied": 256,
  "bookId": 1681,
  "printedPage": "1/ 6",
  "pageId": 10,
  "edition": "ط السلطانية",
  "publisher": "السلطانية",
  "sourceUrl": "https://shamela.ws/book/1681/10",
  "arabic": "…عُمَرَ بْنَ الْخَطَّابِ ﵁ عَلَى الْمِنْبَرِ، قَالَ: سَمِعْتُ رَسُولَ اللهِ ﷺ، يَقُولُ: «إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ، وَإِنَّمَا لِكُلِّ امْرِئٍ مَا نَوَى، فَمَنْ كَانَتْ هِجْرَتُهُ إِلَى دُنْيَا يُصِيبُهَا، أَوْ إِلَى امْرَأَ…",
  "matchedIn": "body",
  "matchQuality": "exact_phrase"
}
  1. 01 Mot pour mot L'arabe est copié de la page, jamais paraphrasé ni complété de mémoire.
  2. 02 La page imprimée Volume et page dans l'impression nommée, pour qu'un lecteur ouvre le livre et la trouve.
  3. 03 Texte ou note Chaque passage indique si les mots sont de l'auteur ou d'une note de l'éditeur.

03 · Outils

Un outil pour commencer, 36 derrière lui.

La plupart des questions n'ont besoin que de search_library. Le reste du serveur de la bibliothèque est là quand une question en demande plus.

Commencez ici

search_library(query, scope, limit?)

Fait d'abord une recherche par expression exacte, puis se replie sur une recherche par mots, en vous disant laquelle a répondu. Renvoie le livre, l'auteur, l'année de décès, le volume et la page imprimés et l'arabe mot pour mot, et précise si les mots viennent du texte principal ou d'une note de l'éditeur.

À côté, 36 outils shamela_* du serveur de la bibliothèque lui-même : chaînes d'isnād et fiches de transmetteurs, recherche booléenne et sensible aux voyelles, résolution d'une référence imprimée vers une page, tafsir par verset et lecture d'une page entière. Les requêtes doivent être en arabe.

Au total, 39 outils : search_library, search, fetch et les 36 outils shamela_*.

La référence complète des outils

Recherche

9
  • shamela_search_pages
  • shamela_search_titles
  • shamela_search_phrase
  • shamela_search_exact
  • shamela_search_boolean
  • shamela_search_hadith
  • shamela_search_batch
  • shamela_recon
  • shamela_root_stats

Transmetteurs et isnād

5
  • shamela_search_narrators
  • shamela_get_narrator
  • shamela_search_isnad
  • shamela_get_isnad
  • shamela_get_books_for_hadith
22 autres outils Références · Coran et tafsir · Lecture · Catalogue

Références

4
  • shamela_get_citation
  • shamela_resolve_work
  • shamela_resolve_printed_page
  • shamela_resolve

Coran et tafsir

5
  • shamela_search_quran
  • shamela_get_aya
  • shamela_get_tafseer_of_aya
  • shamela_list_tafsirs_for_aya
  • shamela_get_tafseer_texts

Lecture

6
  • shamela_get_page
  • shamela_get_pages_range
  • shamela_get_book_section
  • shamela_get_toc
  • shamela_get_book_parts
  • shamela_get_page_services

Catalogue

7
  • shamela_search_books
  • shamela_search_authors
  • shamela_get_book
  • shamela_get_author
  • shamela_list_categories
  • shamela_books_by_period
  • shamela_brief

04 · Périmètres

Cherchez d'abord sur le bon rayon.

search_library en exige un. Ce n'est pas un confort : sans périmètre, le classement dans ce corpus suit la fréquence des termes, ce qui place une anthologie poétique de 710 H au-dessus de tous les manuels de fiqh et ne fait jamais remonter le Sahih al-Bukhari pour le hadith le plus célèbre de l'islam. Les recherches brutes shamela_* permettent de chercher sans périmètre ; le classement explique pourquoi il vaut mieux s'en abstenir.

hadith-primary
The eight primary hadith collections, edition-pinned
tafsir-canonical
Canonical tafsir — Ibn Kathir, al-Tabari, Ibn al-Jawzi first
fiqh-hanafi
Hanafi fiqh (+ usul, comparative)
fiqh-maliki
Maliki fiqh (+ usul, comparative)
fiqh-shafii
Shafi'i fiqh (+ usul, comparative)
fiqh-hanbali
Hanbali fiqh (+ usul, comparative)
fiqh-comparative
All four schools plus comparative and fatwa collections
aqeedah
Creed and sects
hadith-sciences
Hadith commentary, takhrij and the sciences of hadith
tafsir
The whole tafsir shelf and Quranic sciences
seerah
Prophetic biography, history and biographical dictionaries
lugha
Arabic language, lexicons, grammar and adab

05 · Limites

Gratuit pour commencer. Une clé quand il en faut plus.

Un appel refusé ne coûte rien, et l'erreur nomme la limite atteinte. Une plage de pages plus courte ne perd aucune page : la réponse indique où reprendre.

Sans clé

10 appels d'outil par minute

  • 200 par jour, comptés par adresse IP
  • Jusqu'à 5 pages par appel pages_range et 10 par appel book_section
  • Se connecter et lister les outils ne coûte rien

Avec une clé gratuite

60 requêtes par minute

  • Aucun plafond quotidien, compté par clé
  • Jusqu'à 20 pages par appel pages_range et 100 par appel book_section
  • Envoyée dans un en-tête Authorization: Bearer qg_sk_…
Obtenir une clé

Créez-en une sous Developers dans votre compte Quran Gallery.

Ce qu'il ne fait pas

  • Les recherches renvoient des extraits limités à leur page, avec références ; les outils de lecture renvoient des pages entières. Aucun appel n'exporte un livre, et la limite de débit est ce qui sépare la lecture de l'aspiration.

  • Il ne peut pas empêcher votre modèle d'attribuer un passage à tort. Il garantit que le passage, le livre et la page sont réels, pas que la phrase construite autour l'est.

  • Il n'a pas besoin de votre identité pour répondre. Les appels sans clé sont limités par IP ; une clé ne sert qu'à relever les limites.

Questions

Questions sur le serveur

Existe-t-il un serveur MCP pour le hadith et le tafsir ?

Oui. Le serveur Quran Gallery MCP, à l'adresse https://qurangallery.com/mcp/shamela, cherche dans 8 594 œuvres islamiques classiques de 3 188 auteurs, dont les recueils de hadith de référence, les grands tafsirs, le fiqh des quatre écoles, la croyance, la sira et la langue arabe. Chaque passage revient avec son livre, son auteur, son volume et sa page imprimés.

Comment l'ajouter à ChatGPT ou Claude ?

Dans Claude, ouvrez Settings → Connectors → Add custom connector et collez https://qurangallery.com/mcp/shamela. Dans ChatGPT, activez Developer mode sous Settings → Apps & Connectors → Advanced settings, puis créez un connecteur avec la même URL et No authentication. Claude Code, Cursor, VS Code et Gemini CLI prennent l'URL dans leur configuration MCP.

Est-ce gratuit ? Faut-il une clé ?

C'est gratuit et sans clé. Sans clé, vous avez 10 appels d'outil par minute et 200 par jour par adresse IP. Une clé gratuite de votre compte Quran Gallery porte cela à 60 par minute, sans plafond quotidien.

Quels livres couvre-t-il ?

Le catalogue de la Maktabah al-Shamela : 8 594 œuvres classiques de 3 188 auteurs réparties en 41 catégories. Les recherches se font dans un périmètre, comme les huit recueils de hadith de référence, les tafsirs canoniques ou le fiqh d'une école, pour que le bon rayon réponde en premier. Les requêtes sont en arabe.

En quoi est-ce différent de demander directement à une IA ?

Un assistant qui répond de mémoire peut produire une référence plausible qui n'existe pas. Avec ce serveur, il cite mot pour mot un passage qu'il a récupéré, avec l'édition imprimée, le volume et la page, pour que vous puissiez ouvrir le livre et vérifier. Il ne peut pas empêcher un modèle d'attribuer un passage à tort ; il garantit que le passage, le livre et la page sont réels.

Fonctionne-t-il avec la recherche approfondie de ChatGPT ?

Oui. Le serveur propose des outils search et fetch dans la forme qu'attend ChatGPT : la recherche approfondie peut trouver un passage, puis le lire en entier. Dans ChatGPT, activez Developer mode et ajoutez https://qurangallery.com/mcp/shamela comme connecteur avec No authentication.

Commencer

Connectez-le, puis demandez une page.

La documentation couvre chaque outil, périmètre et erreur. Dites-nous ce que vous construisez avec, ou ce qui ne va pas.