MCP-Serveur

📜 Table des Matières

• 🌟 Introduction

• 📋 Prérequis

• 🚀 Installation & Configuration Initiale

• ⚙️ Exécution et Gestion du Serveur

• 🔍 Utilisation de l'Inspecteur (Client UI)

• 🤝 Contribution

🌟 Introduction

MCP-Serveur est un serveur robuste, conçu pour la performance et la modularité. Il permet de gérer avec élégance des tâches complexes, qu'elles soient immédiates (synchrones) ou de longue durée (asynchrones), grâce à une architecture découplée s'appuyant sur :

• FastMCP : Pour un traitement efficace des requêtes et une gestion de session.

• Docker & Docker Compose : Pour une conteneurisation fiable et un déploiement simplifié.

• BullMQ & Redis : Pour une file d'attente de tâches asynchrones robuste et performante.

• TypeScript : Pour un code typé, maintenable et évolutif.

Ce document vous guidera à travers l'installation, l'exécution et l'extension du serveur.

📋 Prérequis

Avant de commencer, assurez-vous que les éléments suivants sont installés et configurés sur votre système :

• : Pour l'exécution des conteneurs. Le script de gestion vérifiera sa présence.

• : Pour l'orchestration des services. Le script run.sh vérifiera sa présence.

• : (Optionnel, mais recommandé pour le développement local) Pour la gestion des dépendances Node.js et l'exécution des scripts.

🚀 Installation & Configuration Initiale

Suivez ces étapes pour mettre en place votre environnement :

1. Clonez le Dépôt :

   git clone [https://github.com/Jboner-Corvus/MCP-Server-Asynchrone.git](https://github.com/Jboner-Corvus/MCP-Server-Asynchrone.git)
   cd MCP-Server-Asynchrone

2. Configuration Initiale via run.sh : Le script run.sh est votre console de gestion interactive pour l'environnement Docker.

   • Rendez le script exécutable :

     chmod +x run.sh

   • Lancez le script :

     ./run.sh

   • Fichier d'Environnement (.env) :

     • Si le fichier .env est manquant, créer le en copiant le modèle .env.example.

     • ⚠️ Action Requise : Éditez manuellement le fichier .env pour définir des valeurs fortes et uniques pour AUTH_TOKEN, REDIS_PASSWORD, WEBHOOK_SECRET, et toute autre variable sensible ou spécifique à votre déploiement.

     # variables à personnaliser dans .env
     PORT=8081
     NODE_ENV=production
     LOG_LEVEL=info
     AUTH_TOKEN="VOTRE_TOKEN_SECRET_ULTRA_ROBUSTE"
     REDIS_HOST=redis
     REDIS_PORT=6379
     REDIS_PASSWORD="VOTRE_MOT_DE_PASSE_REDIS_COMPLEXE"
     WEBHOOK_SECRET="VOTRE_SECRET_WEBHOOK_LONG_ET_UNIQUE"

⚙️ Exécution et Gestion du Serveur

Utilisez le script run.sh pour toutes les opérations de gestion du cycle de vie des services.

• Démarrer / Mettre à jour : Option 1. Cette commande construit les images si nécessaire et lance tous les services en arrière-plan.

• Redémarrer complètement : Option 2. Arrête, reconstruit, puis redémarre tous les services.

• Arrêter tous les services : Option 3. Arrête et supprime les conteneurs.

• Reconstruire les images (sans cache) : Option 4. Force une reconstruction complète de toutes les images Docker sans utiliser le cache.

🔍 Utilisation de l'Inspecteur (Client UI)

L'Inspecteur MCP fournit une interface utilisateur web pour interagir avec votre serveur.

1. Lancement : Pour lancer l'inspecteur, exécutez la commande suivante :

   npx @modelcontextprotocol/inspector

   Cette commande démarre un serveur proxy et ouvre automatiquement l'interface client dans votre navigateur, généralement à l'adresse http://localhost:6274.

2. Configuration de la Connexion : Dans la barre latérale de l'interface, vous devez configurer le mode de connexion à votre serveur MCP.

   • Conneion au serveur : Sélectionnez Streamable HTTP ou SSE et entrez l'URL complète du serveur (par exemple http://VOTRE_IP:8081/mcp).

   • Authentification : Si votre serveur nécessite un jeton d'authentification, dépliez la section "Authentication" et entrez votre Bearer Token.

3. Connexion : Une fois la configuration terminée, cliquez sur le bouton "Connect". L'inspecteur tentera d'établir la connexion avec votre serveur MCP.

4. Interaction : Une fois connecté, vous pouvez utiliser les différents onglets pour interagir avec le serveur :

   • Resources : Lister et lire les ressources disponibles.

   • Prompts : Lister et exécuter les prompts.

   • Tools : Lister et appeler les outils avec des paramètres spécifiques.

🤝 Contribution

Les contributions sont les bienvenues ! Ouvrez une issue pour discuter des changements que vous souhaitez apporter.