MCP -Asynchrone

MCP-Serveur Asynchrone est un serveur MCP modulaire capable de gérer des tâches synchrones et asynchrones via une architecture basée sur FastMCP, BullMQ et Redis, le tout orchestré via Docker. Le serveur expose une interface d’inspection (Inspecteur MCP) qui vous permet de lister les ressources, les prompts et les outils disponibles, et d’exécuter des prompts ou d’appeler des outils avec des paramètres spécifiques. Pour interagir avec le serveur, vous pouvez lancer l’inspecteur via npx et le connecter à votre instance MCP via un flux HTTP (Streamable HTTP ou SSE) avec une URL du type http://VOTRE_IP:PORT/mcp, et éventuellement fournir un Bearer Token pour l’authentification. En production, le serveur s’appuie sur BullMQ et Redis pour la gestion des tâches asynchrones, et utilise Docker/ Docker Compose pour l’orchestration et isoler les composants.

• À partir d’un navigateur via lInspecteur MCP, vous pouvez accéder aux onglets Resources, Prompts et Tools pour explorer et exécuter des actions sur le serveur.
• Les tâches synchrones peuvent être traitées immédiatement par FastMCP, tandis que les tâches longues ou gourmandes en ressources seront mises en file d’attente et traitées par BullMQ avec Redis comme broker.
• Le serveur s’appuie également sur des environnements Docker Compose pour déployer les services de manière fiable et reproductible.

Prérequis:

• Docker Engine installé et en fonctionnement
• Docker Compose (version 2+) pour l’orchestration des services
• pnpm recommandé pour le développement local (optionnel)

Instructions d’installation (Docker):

1. Installer Docker et Docker Compose sur votre système (suivre les guides officiels Docker).
2. Obtenir l’image du MCP-Serveur Asynchrone:
   • Option A: Pull l’image officielle (si disponible):
     • docker pull mcp-server-asynchrone:latest
   • Option B: Construire localement si un Dockerfile est fourni dans le repo:
     • git clone https://github.com/Jboner-Corvus/MCP-Server-Asynchrone.git
     • cd MCP-Server-Asynchrone
     • docker build -t mcp-server-asynchrone:latest .
3. Préparer la configuration et les variables d’environnement:
   • Créez ou éditez le fichier .env si nécessaire avec des valeurs fortes (AUTH_TOKEN, REDIS_PASSWORD, WEBHOOK_SECRET, etc.).
4. Lancer le serveur via Docker (exemple direct):
   • docker run -d --name mcp-asynchrone -p 8081:8081
     -e AUTH_TOKEN="VOTRE_TOKEN_SECRET_ULTRA_ROBUSTE"
     -e REDIS_PASSWORD="VOTRE_MOT_DE_PASSE_REDIS_COMPLEXE"
     -e WEBHOOK_SECRET="VOTRE_SECRET_WEBHOOK_LONG_ET_UNIQUE"
     -e NODE_ENV=production
     -e LOG_LEVEL=info
     mcp-server-asynchrone:latest
5. Vérifier les logs et l’état du conteneur:
   • docker ps
   • docker logs mcp-asynchrone
6. Accéder à l Inspecteur MCP:
   • Lancer: npx @modelcontextprotocol/inspector
   • Configurer la connexion: Streamable HTTP ou SSE vers http://VOTRE_IP:8081/mcp avec Bearer Token si nécessaire

Remarques utiles:

• Assurez-vous que Redis est accessible et que le mot de passe défini dans REDIS_PASSWORD correspond à celui utilisé par Redis dans votre déploiement.
• Pour des déploiements en production, privilégier Docker Compose ou une orchestrations plus avancée (Kubernetes) et sécuriser les communications via TLS et des secrets gérés.
• Si vous utilisez l Inspecteur, vérifiez que le serveur est exposé sur le port configuré (ici 8081). Si vous rencontrez des problèmes de connexion, vérifiez les règles CORS et les politiques réseau de votre environnement.
• Le fichier .env peut être utilisé pour centraliser les variables sensibles; ne le commitez pas dans les dépôts publics.
• En cas de lenteurs ou de tâches longues, surveillez la file BullMQ et les workers Redis pour ajuster le nombre de workers et les délais de timeout.