Supabase MCP Server - Self-Hosted Edition

# Supabase MCP Server - Self-Hosted Edition 🗄️ **Serveur MCP Supabase Self-Hosted** - Gestion complète de votre instance Supabase privée ## 🌟 Fonctionnalités - 🔐 **Gestion complète** de votre instance Supabase privée - 🛠️ **54+ outils MCP** pour l'administration Supabase - 📊 **Monitoring** et métriques en temps réel - 🚀 **Déploiement automatique** sur Railway - 🔒 **Sécurité renforcée** avec prévention SQL injection - ⚡ **Performance optimisée** pour la production ## 🏗️ Architecture Ce repository contient **uniquement** le serveur MCP Supabase pur, sans interface web ni hub central. ``` Supabase MCP Server (Port 8000) ├── 🗄️ Gestion de base de données ├── 🔐 Authentification et autorisation ├── 📁 Stockage et fichiers ├── 🔄 Temps réel et subscriptions ├── 🛠️ Migrations et schémas ├── 📊 Monitoring et logs └── 🚀 Déploiement automatique ``` ## 🚀 Démarrage Rapide ### Prérequis - Python 3.11+ - Instance Supabase (self-hosted ou cloud) - Variables d'environnement Supabase ### Option A — SDK Smithery (recommandé) ```bash # Cloner le repository git clone https://github.com/MisterSandFR/Supabase-MCP-SelfHosted.git cd Supabase-MCP-SelfHosted # Installer les dépendances pip install -r requirements.txt # (Facultatif) Installer la CLI Smithery si besoin npm i -g @smithery/cli # Lancer le dev SDK (selon votre environnement) smithery dev # ou: smithery playground ``` - Le serveur SDK est défini dans `pyproject.toml` via: - `[tool.smithery] server = "supabase_mcp_server.server:create_server"` - Lors du déploiement dans l’interface Smithery, configurez le Test Profile puis lancez le Scan. ### Option B — HTTP self-hosted (compat) ```bash # Cloner le repository git clone https://github.com/MisterSandFR/Supabase-MCP-SelfHosted.git cd Supabase-MCP-SelfHosted # Installer les dépendances Python pip install -r requirements.txt # Configurer les variables d'environnement export SUPABASE_URL="https://your-project.supabase.co" export SUPABASE_ANON_KEY="your-anon-key" export SUPABASE_SERVICE_KEY="your-service-key" # Optionnel # Démarrer le serveur HTTP externe python src/supabase_server.py ``` ### Avec Docker (Railway / self-hosted) ```bash # Build et démarrage (utilisez Dockerfile.railway si besoin) docker build -f Dockerfile.railway -t supabase-mcp-server . docker run -p 8000:8000 \ -e SUPABASE_URL="https://your-project.supabase.co" \ -e SUPABASE_ANON_KEY="your-anon-key" \ supabase-mcp-server ``` ## ⚙️ Configuration ### Variables d'Environnement ```bash # Supabase Configuration SUPABASE_URL=https://your-project.supabase.co SUPABASE_ANON_KEY=eyJ... (votre clé anonyme) SUPABASE_SERVICE_KEY=eyJ... (optionnel, pour opérations privilégiées) # Server Configuration PORT=8000 PYTHONUNBUFFERED=1 ``` ## 🛠️ Outils MCP Disponibles ### Base de Données (15 outils) - `execute_sql` - Exécution de requêtes SQL - `list_tables` - Liste des tables - `inspect_schema` - Inspection du schéma - `apply_migration` - Application de migrations - `backup_database` - Sauvegarde de base - `restore_database` - Restauration de base - `vacuum_analyze` - Optimisation de base - `get_database_stats` - Statistiques de base - `create_index` - Création d'index - `drop_index` - Suppression d'index - `list_extensions` - Liste des extensions - `manage_extensions` - Gestion des extensions - `execute_psql` - Commandes psql - `check_health` - Vérification de santé - `get_database_connections` - Connexions de base ### Authentification (8 outils) - `list_auth_users` - Liste des utilisateurs - `create_auth_user` - Création d'utilisateur - `update_auth_user` - Mise à jour d'utilisateur - `delete_auth_user` - Suppression d'utilisateur - `get_auth_user` - Récupération d'utilisateur - `verify_jwt_secret` - Vérification JWT - `manage_roles` - Gestion des rôles - `manage_rls_policies` - Gestion des politiques RLS ### Stockage (6 outils) - `list_storage_buckets` - Liste des buckets - `list_storage_objects` - Liste des objets - `manage_storage_policies` - Gestion des politiques - `upload_file` - Upload de fichier - `download_file` - Téléchargement de fichier - `delete_file` - Suppression de fichier ### Temps Réel (4 outils) - `list_realtime_publications` - Liste des publications - `manage_realtime` - Gestion du temps réel - `create_subscription` - Création de subscription - `delete_subscription` - Suppression de subscription ### Migrations (8 outils) - `create_migration` - Création de migration - `list_migrations` - Liste des migrations - `push_migrations` - Push des migrations - `validate_migration` - Validation de migration - `smart_migration` - Migration intelligente - `auto_migrate` - Migration automatique - `sync_schema` - Synchronisation de schéma - `import_schema` - Import de schéma ### Monitoring (5 outils) - `get_logs` - Récupération des logs - `metrics_dashboard` - Tableau de bord métriques - `analyze_performance` - Analyse de performance - `analyze_rls_coverage` - Analyse couverture RLS - `audit_security` - Audit de sécurité ### Utilitaires (8 outils) - `generate_typescript_types` - Génération de types TS - `generate_crud_api` - Génération d'API CRUD - `cache_management` - Gestion du cache - `environment_management` - Gestion d'environnement - `manage_secrets` - Gestion des secrets - `manage_functions` - Gestion des fonctions - `manage_triggers` - Gestion des triggers - `manage_webhooks` - Gestion des webhooks ## 🔧 API Endpoints ### Serveur MCP (HTTP self-hosted) - `GET /health` - Health check - `POST /mcp` - Endpoint JSON-RPC principal - `GET /.well-known/mcp-config` - Configuration MCP - `GET /mcp/tools.json` - Découverte des outils (JSON) ### Outils Spécialisés - `GET /api/tools` - Liste des outils disponibles - `POST /api/execute` - Exécution d'outils ## 🚀 Déploiement ### Smithery (SDK Python) — Recommandé 1. Vérifiez que `pyproject.toml` contient: - `[tool.smithery] server = "supabase_mcp_server.server:create_server"` 2. Dans Smithery → Deploy, sélectionnez SDK Python 3. Configurez le Test Profile puis lancez le Scan - Requis: `SUPABASE_URL`, `SUPABASE_ANON_KEY` ### Railway (Self-hosted) ```bash # Déployer sur Railway railway login railway init railway up ``` ### Docker ```bash # Build et déploiement docker build -t supabase-mcp-server . docker run -p 8000:8000 supabase-mcp-server ``` ### Intégration avec Hub Central Ce serveur est conçu pour être intégré avec le [MCP Hub Central](https://github.com/coupaul/mcp-hub-central) : ```json { "servers": { "supabase": { "name": "Supabase MCP Server", "host": "supabase.mcp.coupaul.fr", "port": 8000, "path": "/", "categories": ["database", "auth", "storage", "realtime", "security", "migration", "monitoring", "performance"] } } } ``` ## 🧪 Test Profile (Smithery) Lors de la connexion côté Smithery, fournissez les clés suivantes dans le Test Profile: ```json { "SUPABASE_URL": "https://your-project.supabase.co", "SUPABASE_ANON_KEY": "eyJ..." } ``` En cas de cache, re-sauvegardez le profil et relancez le Scan. ## 🔒 Sécurité - **Validation des entrées** pour prévenir les injections SQL - **Rate limiting** par IP et utilisateur - **Audit logs** de toutes les opérations - **Chiffrement HTTPS** obligatoire en production - **Gestion des secrets** sécurisée - **Politiques RLS** pour la sécurité des données ## 📊 Monitoring Le serveur fournit un monitoring complet : - **Métriques de performance** en temps réel - **Logs structurés** avec niveaux configurables - **Health checks** automatiques - **Alertes** en cas de problème - **Tableau de bord** métriques - **Analyse de performance** détaillée ## 🤝 Contribution 1. Fork le repository 2. Créer une branche feature (`git checkout -b feature/amazing-feature`) 3. Commit vos changements (`git commit -m 'Add amazing feature'`) 4. Push vers la branche (`git push origin feature/amazing-feature`) 5. Ouvrir une Pull Request ## 📄 Licence Ce projet est sous licence MIT. Voir le fichier [LICENSE](LICENSE) pour plus de détails. ## 🙏 Remerciements - [Supabase](https://supabase.com/) pour la plateforme - [Smithery](https://smithery.ai) pour l'écosystème MCP - La communauté Supabase pour les contributions ## 📞 Support - 📧 Email : contact@coupaul.fr - 💬 Discord : [Serveur MCP Community](https://discord.gg/mcp) - 🐛 Issues : [GitHub Issues](https://github.com/MisterSandFR/Supabase-MCP-SelfHosted/issues) --- **Fait avec ❤️ par [coupaul](https://github.com/coupaul)**