Connecter Cursor au serveur MCP des textes islamiques
Ajoutez le serveur MCP de Quran Gallery à Cursor via mcp.json : cherchez dans des livres arabes classiques avec pages imprimées citées, sans clé.
Sur cette page
Ni compte, ni connexion, ni clé. Cursor lit les serveurs MCP dans mcp.json.
Étapes
- Ouvrez
~/.cursor/mcp.json(tous les projets) ou.cursor/mcp.jsondans un projet (ce projet seulement). Créez le fichier s’il n’existe pas. - Ajoutez le serveur :
{
"mcpServers": {
"quran-gallery": { "url": "https://qurangallery.com/mcp/shamela" }
}
}- Enregistrez. Cursor liste les serveurs MCP sur sa page Customize ;
quran-gallerydoit apparaître comme activé, avec ses outils. - Ouvrez une discussion en mode Agent et posez une question qui nécessite un texte (ci-dessous).
La page /mcp propose aussi un bouton d’installation en un clic pour Cursor.
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. Désactivez puis réactivez le serveur dans la liste MCP de Cursor, ou redémarrez Cursor ; la liste des outils est mise en cache par session.
- 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 :
{
"mcpServers": {
"quran-gallery": {
"url": "https://qurangallery.com/mcp/shamela",
"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
}
}
}Gardez hors de git tout fichier contenant une clé.