Aller au contenu

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

  1. Ouvrez ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json dans un projet (ce projet seulement). Créez le fichier s’il n’existe pas.
  2. Ajoutez le serveur :
{
	"mcpServers": {
		"quran-gallery": { "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. Enregistrez. Cursor liste les serveurs MCP sur sa page Customize ; quran-gallery doit apparaître comme activé, avec ses outils.
  2. 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 /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 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é.

Étapes suivantes

Modifier cette page sur GitHub