Aller au contenu

Utiliser le serveur MCP de la bibliothèque islamique avec GitHub Copilot

Donnez au mode agent de GitHub Copilot dans VS Code le serveur MCP de Quran Gallery : livres arabes classiques, pages imprimées citées, sans compte ni clé.

Sur cette page

Ni compte, ni connexion, ni clé. GitHub Copilot dans VS Code utilise la même configuration MCP que VS Code lui-même, et appelle les outils MCP depuis le mode agent.

Étapes

  1. Créez .vscode/mcp.json dans votre espace de travail (ou exécutez MCP: Add Server depuis la palette de commandes) :
{
	"servers": {
		"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. Démarrez le serveur avec l’action Start au-dessus de son entrée et faites-lui confiance.
  2. Ouvrez la vue de discussion Copilot et passez en mode Agent. Ouvrez le sélecteur d’outils et vérifiez que les outils quran-gallery sont cochés.
  3. Posez une question qui nécessite un texte (ci-dessous).

La politique de votre organisation peut désactiver les serveurs MCP pour Copilot ; si les outils n’apparaissent jamais, demandez à votre administrateur si MCP est autorisé. Les étapes complètes et la configuration de la clé se trouvent sur la page VS Code.

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

  • 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. Ouvrez le sélecteur d’outils et vérifiez que le serveur est coché ; redémarrez le serveur depuis MCP: List Servers.
  • 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é. Ajoutez une entrée headers exactement comme indiqué sur la page VS Code. Créez une clé sur la page Développeurs de votre compte Quran Gallery (fonctionnement des clés).

Étapes suivantes

Modifier cette page sur GitHub