Ajouter le serveur MCP de la bibliothèque islamique à VS Code
Ajoutez le serveur MCP de Quran Gallery à VS Code avec mcp.json, sans clé, et cherchez des livres arabes classiques avec pages imprimées dans le chat.
Sur cette page
Ni compte, ni connexion, ni clé. VS Code lit les serveurs MCP dans un fichier mcp.json.
Étapes
- Dans votre espace de travail, créez
.vscode/mcp.json. (Ou exécutez MCP: Add Server depuis la palette de commandes et suivez le parcours guidé, en choisissant le type HTTP et l’URL ci-dessous.) - Ajoutez le serveur :
{
"servers": {
"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
}
}- Enregistrez. VS Code affiche une action Start au-dessus de l’entrée du serveur ; démarrez-le et faites-lui confiance lorsqu’on vous le demande.
- Ouvrez la vue de discussion en mode agent, vérifiez que quran-gallery figure dans la liste des outils, et posez une question (ci-dessous).
Pour la même configuration via GitHub Copilot, voir GitHub Copilot dans VS Code. La page /mcp propose un bouton d’installation en un clic pour 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. Redémarrez le serveur depuis l’éditeur
mcp.json(action Restart en ligne) ou exécutez MCP: List Servers et redémarrez-le. - 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 une entrée headers au serveur :
{
"servers": {
"quran-gallery": {
"type": "http",
"url": "https://qurangallery.com/mcp/shamela",
"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
}
}
}Ne versez pas dans git un fichier d’espace de travail qui contient une clé.