Aller au contenu

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

  1. Exécutez la commande ci-dessus dans le dossier de votre projet. Elle écrit le serveur dans .gemini/settings.json de ce dossier. Ajoutez --scope user pour l’écrire dans ~/.gemini/settings.json, afin qu’il fonctionne dans tous les projets.

  2. Exécutez gemini mcp list. quran-gallery doit apparaître comme Connected.

    Un terminal : gemini mcp add écrit le serveur dans .gemini/settings.json, et gemini mcp list affiche quran-gallery comme Connected.

  3. Lancez gemini et 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 :

Un terminal : gemini répond avec Sahih al-Bukhari, édition Sultaniyya, volume 1 page 6, avec un lien vers la page.

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 gemini et exécutez /mcp list. La liste des outils est lue au démarrage.
  • gemini mcp list affiche 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é, et gemini mcp remove ne les y trouve pas non plus. Ouvrez gemini une 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 /mcp seule 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.

Étapes suivantes

Modifier cette page sur GitHub