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.

🚀 Démarrage Rapide

Prérequis

• Python 3.11+

• Instance Supabase (self-hosted ou cloud)

• Variables d'environnement Supabase

Option A — SDK Smithery (recommandé)

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

Avec Docker (Railway / self-hosted)

⚙️ Configuration

Variables d'Environnement

🛠️ 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)

Docker

Intégration avec Hub Central

Ce serveur est conçu pour être intégré avec le MCP Hub Central :

🧪 Test Profile (Smithery)

Lors de la connexion côté Smithery, fournissez les clés suivantes dans le Test Profile:

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