Connecter Gemini CLI au serveur MCP des textes islamiques
Ajoutez le serveur MCP de Quran Gallery à Gemini CLI par une commande ou dans settings.json : livres arabes classiques, pages imprimées citées, sans clé.
Sur cette page
Ni compte, ni connexion, ni clé. Une seule commande :
gemini mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamelaÉtapes
Exécutez la commande ci-dessus dans le dossier de votre projet. Elle écrit le serveur dans
.gemini/settings.jsonde ce dossier. Ajoutez--scope userpour l’écrire dans~/.gemini/settings.json, afin qu’il fonctionne dans tous les projets.Exécutez
gemini mcp list.quran-gallerydoit apparaître comme Connected.
Lancez
geminiet posez une question qui nécessite un texte (ci-dessous). Gemini CLI demande confirmation avant chaque appel d’outil la première fois. Approuvez-le.
La réponse donne l’édition, le volume et la page imprimée, ainsi qu’un lien vers la page dans le lecteur Maktabah. Le lien a la forme https://qurangallery.com/maktabah/book/{bookId}/{pageId}, par exemple qurangallery.com/maktabah/book/1681/10 pour Sahih al-Bukhari, et ouvre donc la page sur Quran Gallery :

Pour le retirer : gemini mcp remove quran-gallery.
Ou modifier settings.json vous-même
Ajoutez le serveur à ~/.gemini/settings.json (tous les projets) ou à .gemini/settings.json (un seul projet) :
{
"mcpServers": {
"quran-gallery": {
"url": "https://qurangallery.com/mcp/shamela",
"type": "http"
}
}
}C’est ce qu’écrit la commande. "httpUrl": "https://qurangallery.com/mcp/shamela" fonctionne aussi. Gardez "type": "http" à côté de url, car les anciennes versions de Gemini CLI lisent un simple url comme un point d’accès SSE.
Premier prompt à essayer
Trouvez le hadith «إنما الأعمال بالنيات» dans les recueils primaires et dites-moi dans quel livre, quelle édition, quel volume et quelle page il est imprimé. Citez l’arabe exactement.
Votre assistant devrait appeler shamela_search_library (ou search puis fetch). Les résultats comprennent صحيح البخاري, ط السلطانية, page 1/6, avec un lien vers cette page dans le lecteur Maktabah. S’il répond de mémoire à la place, dites-lui : « Utilise l’outil de la bibliothèque Quran Gallery et cite ce qu’il renvoie. »
Les requêtes de recherche doivent être en arabe ; votre assistant traduit d’abord les termes français (détails). Des prompts prêts à l’emploi pour le takhrīj, la citation d’un passage et la comparaison de tafsirs figurent dans la liste complète des outils.
Dépannage
- 400, « schema at properties.transmission.items.items must be a boolean or an object ». Une version antérieure de notre serveur envoyait un schéma d’outil que l’API Gemini rejetait, et chaque prompt échouait avec cette erreur. Elle est corrigée. Redémarrez
gemini. - 429, « Keyless limit reached ». Sans clé, vous disposez de 10 appels d’outil par minute et de 200 par jour par adresse IP. Attendez l’en-tête
Retry-After, ou ajoutez une clé gratuite (ci-dessous). Voir Limites et erreurs. - 503. Le serveur ou la bibliothèque qui le soutient est brièvement indisponible. Réessayez après l’en-tête
Retry-After. Si le client n’affiche aucun outil, attendez une minute et reconnectez-vous. - Les outils n’apparaissent pas, ou un outil attendu manque. Redémarrez
geminiet exécutez/mcp list. La liste des outils est lue au démarrage. gemini mcp listaffiche le serveur comme Disabled, ou « Gemini CLI is not running in a trusted directory ». Gemini CLI désactive les serveurs MCP dans un dossier que vous n’avez pas approuvé, etgemini mcp removene les y trouve pas non plus. Ouvrezgeminiune fois dans ce dossier et approuvez-le. Dans un script ou avec-p, vous pouvez plutôt passer--skip-trust.- La connexion échoue immédiatement. Le point d’accès est
/mcp/shamela. L’adresse/mcpseule est une page web, pas le serveur.
Facultatif : une clé gratuite pour des limites plus hautes
Une clé n’est jamais obligatoire. Une clé gratuite porte la limite à 60 appels par minute et lève les plafonds de plages de pages du mode sans clé. Créez-en une sur la page Développeurs de votre compte Quran Gallery (fonctionnement des clés), puis envoyez-la comme jeton bearer.
Ajoutez-la avec --header (ou -H) :
gemini mcp add --transport http quran-gallery
https://qurangallery.com/mcp/shamela
--header "Authorization: Bearer qg_sk_your_key_here"Dans settings.json, la même clé va dans un objet headers à côté de url :
{
"mcpServers": {
"quran-gallery": {
"url": "https://qurangallery.com/mcp/shamela",
"type": "http",
"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
}
}
}Gardez la clé hors de tout fichier de configuration que vous versez dans git.