fix(analytics): make Supabase optional and update websockets for MCP server

backend/mcp_server/common/database.py

@@ -14,7 +14,16 @@ from typing import Optional, List, Dict, Any
 import psycopg2
 import psycopg2.extras
 from dotenv import load_dotenv
-from supabase import Client, create_client
+
+try:
+    # Supabase client is optional; in environments without Supabase (e.g. HF Spaces demo),
+    # we don't want import errors (including websockets.asyncio) to crash the MCP server.
+    from supabase import Client, create_client  # type: ignore
+    SUPABASE_AVAILABLE = True
+except Exception:
+    Client = None  # type: ignore
+    create_client = None  # type: ignore
+    SUPABASE_AVAILABLE = False
 
 # Load environment variables
 load_dotenv()
@@ -28,7 +37,7 @@ SUPABASE_URL = os.getenv("SUPABASE_URL")
 SUPABASE_KEY = os.getenv("SUPABASE_SERVICE_KEY")  # MUST be service role key
 
 # Global Supabase client instance
-_supabase_client: Optional[Client] = None
+_supabase_client: Optional["Client"] = None
 
 
 # -----------------------------------
@@ -399,6 +408,12 @@ def get_supabase_client() -> Client:
     """
     global _supabase_client
 
+    if not SUPABASE_AVAILABLE:
+        raise RuntimeError(
+            "Supabase client is not available in this deployment. "
+            "Install and configure Supabase to use MCP Supabase features."
+        )
+
     if _supabase_client is None:
         if not SUPABASE_URL or not SUPABASE_KEY:
             raise ValueError(