daevosDev/connecteur_SSE_test

Connecteur Distant MCP avec SSE pour Claude

Ce connecteur permet à Claude Desktop d'accéder à des données et outils distants via le protocole MCP (Model Context Protocol) en utilisant Server-Sent Events (SSE).

🚀 Fonctionnalités

• Serveur MCP complet avec 6 outils intégrés
• Transport SSE pour communication temps réel
• Base de données SQLite avec données de démonstration
• Déploiement Docker prêt pour le cloud
• API RESTful avec documentation auto-générée
• Support authentification via headers

📋 Outils MCP Disponibles

🛠️ Installation Locale

Prérequis

• Python 3.11+
• pip (gestionnaire de packages Python)

Étapes d'installation

1. Cloner ou copier le dossier

cd connecteur_SSE

2. Installer les dépendances

pip install -r requirements.txt

3. Démarrer le serveur

python mcp-sse-server.py

Le serveur démarre sur http://localhost:8000 avec l'endpoint SSE sur http://localhost:8000/sse.

🐳 Déploiement avec Docker

Construction de l'image

docker build -t mcp-sse-connector .

Exécution locale

docker run -p 8000:8000 mcp-sse-connector

Déploiement cloud (Render)

1. Créer un compte sur Render
2. Connecter votre repository GitHub
3. Créer un nouveau service Web
4. **Configuration :
   • Environment: Python
   • Build Command: pip install -r requirements.txt
   • Start Command: python mcp-sse-server.py
   • Port: 8000

🔧 Configuration Claude Desktop

Méthode 1: Claude Code (Recommandé)

# Ajouter le serveur distant
claude mcp add --transport sse mon-serveur https://your-domain.com/sse

# Avec authentification
claude mcp add --transport sse mon-serveur https://your-domain.com/sse \
  --header "X-API-Key: votre-cle-secrete"

Méthode 2: Configuration manuelle

1. Ouvrir Claude Desktop
2. Aller dans Paramètres → MCP Servers
3. Cliquer sur "Add Server"
4. Configurer :
   • Type: Remote Server
   • Transport: SSE
   • URL: https://your-domain.com/sse

🧪 Test et Validation

Test local avec curl

# Test de santé
curl http://localhost:8000/health

# Test SSE
curl -N -H "Accept: text/event-stream" http://localhost:8000/sse

Test avec l'inspecteur MCP

pip install mcp-inspector
mcp-inspector --transport sse --url http://localhost:8000/sse

📊 Structure de la Base de Données

Tables

• users: id, name, email, role, created_at
• tasks: id, title, description, status, priority, user_id, created_at

Données de démonstration

Le serveur initialise automatiquement avec des utilisateurs et tâches exemples.

🌐 Endpoints API

🔐 Sécurité

Variables d'environnement

# Configuration serveur
PORT=8000
HOST=0.0.0.0
DB_PATH=mcp_data.db

# Sécurité
API_KEY=votre-cle-secrete
CORS_ORIGINS=https://claude.ai,https://anthropic.com

Headers d'authentification

Support des headers personnalisés pour l'authentification :

• X-API-Key
• Authorization: Bearer <token>

📝 Exemples d'utilisation avec Claude

Lister tous les utilisateurs

Utilise l'outil get_all_users pour voir tous les utilisateurs disponibles

Créer un nouvel utilisateur

Utilise l'outil create_user avec name="Jean Dupont" et email="jean@example.com"

Rechercher des données

Utilise l'outil search_data avec query="Alice" pour trouver toutes les informations liées à Alice

Créer une tâche

Utilise l'outil create_task avec title="Nouvelle tâche", description="Description détaillée", user_id=1

🚨 Dépannage

Problèmes courants

Debug

Activez le mode debug :

export DEBUG=true
python mcp-sse-server.py

📱 Support Mobile

Claude mobile supporte les serveurs MCP distants configurés via claude.ai. Les utilisateurs peuvent accéder aux outils depuis l'application mobile.

🔗 Ressources

• Documentation officielle MCP
• Guide Anthropic Remote MCP
• Exemples Cloudflare MCP

🔄 Mise à jour

Pour mettre à jour le serveur :

1. Pousser les changements sur GitHub
2. La plateforme cloud re-déploiera automatiquement
3. Recharger Claude Desktop pour appliquer les changements

📄 Licence

MIT License - Utilisation libre pour projets personnels et commerciaux.

🤝 Contribution

Les contributions sont les bienvenues ! Veuillez ouvrir une issue ou une pull request.