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é)

#  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)

#  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)

#  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

#  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)

#  Déployer sur Railway
railway login
railway init
railway up

# # Docker

#  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 :

{
  "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:

{
  "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 pour plus de détails.

# 🙏 Remerciements

• Supabase pour la plateforme
• Smithery pour l'écosystème MCP
• La communauté Supabase pour les contributions

# 📞 Support

• 📧 Email : contact@coupaul.fr
• 💬 Discord : Serveur MCP Community
• 🐛 Issues : GitHub Issues

Fait avec ❤️ par coupaul