Upload folder using huggingface_hub

Dockerfile

@@ -11,7 +11,7 @@ COPY pyproject.toml .
 RUN pip install --no-cache-dir .
 
 COPY src/mcp-github ./src/mcp-github
-COPY src/mcp_telemetry.py ./src/mcp_telemetry.py
+COPY src/core ./src/core
 
 ENV PYTHONPATH=/app/src
 

src/core/mcp_telemetry.py

@@ -0,0 +1,227 @@
+
+import os
+import json
+import sqlite3
+import requests
+import time
+from datetime import datetime, timedelta
+from pathlib import Path
+
+# Configuration
+HUB_URL = os.environ.get("MCP_HUB_URL", "http://localhost:7860")
+IS_HUB = os.environ.get("MCP_IS_HUB", "false").lower() == "true"
+
+# Single SQLite DB for the Hub
+if os.path.exists("/app"):
+    DB_FILE = Path("/tmp/mcp_logs.db")
+else:
+    # src/core/mcp_telemetry.py -> src/core -> src -> project root
+    DB_FILE = Path(__file__).parent.parent.parent / "mcp_logs.db"
+
+def _get_conn():
+    # Auto-init if missing (lazy creation)
+    if IS_HUB and not os.path.exists(DB_FILE):
+        _init_db()
+        
+    conn = sqlite3.connect(DB_FILE)
+    conn.row_factory = sqlite3.Row
+    return conn
+
+def _init_db():
+    """Initializes the SQLite database with required tables."""
+    # Ensure parent dir exists
+    if not os.path.exists(DB_FILE.parent):
+        os.makedirs(DB_FILE.parent, exist_ok=True)
+            
+    try:
+        # Connect directly to create file
+        conn = sqlite3.connect(DB_FILE)
+        conn.row_factory = sqlite3.Row
+        with conn:
+            conn.execute("""
+                CREATE TABLE IF NOT EXISTS logs (
+                    id INTEGER PRIMARY KEY AUTOINCREMENT,
+                    timestamp TEXT NOT NULL,
+                    server TEXT NOT NULL,
+                    tool TEXT NOT NULL
+                )
+            """)
+            conn.execute("CREATE INDEX IF NOT EXISTS idx_ts ON logs(timestamp)")
+        conn.close()
+    except Exception as e:
+        print(f"DB Init Failed: {e}")
+
+# Init handled lazily in _get_conn
+
+def log_usage(server_name: str, tool_name: str):
+    """Logs a usage event. Writes to DB if Hub, else POSTs to Hub API."""
+    timestamp = datetime.now().isoformat()
+    
+    # 1. If we are the Hub, write directly to DB
+    if IS_HUB:
+        try:
+            with _get_conn() as conn:
+                conn.execute("INSERT INTO logs (timestamp, server, tool) VALUES (?, ?, ?)", 
+                             (timestamp, server_name, tool_name))
+        except Exception as e:
+            print(f"Local Log Failed: {e}")
+            
+    # 2. If we are an Agent, send to Hub API
+    else:
+        try:
+            payload = {
+                "server": server_name,
+                "tool": tool_name,
+                "timestamp": timestamp
+            }
+            # Fire and forget with short timeout
+            requests.post(f"{HUB_URL}/api/telemetry", json=payload, timeout=2)
+        except Exception as e:
+            # excessive logging here would be spammy locally
+            pass
+
+def get_metrics():
+    """Aggregates metrics from SQLite."""
+    if not DB_FILE.exists():
+        return {}
+    
+    try:
+        with _get_conn() as conn:
+            rows = conn.execute("SELECT server, timestamp FROM logs").fetchall()
+            
+        now = datetime.now()
+        metrics = {}
+        
+        for row in rows:
+            server = row["server"]
+            ts = datetime.fromisoformat(row["timestamp"])
+            
+            if server not in metrics:
+                metrics[server] = {"hourly": 0, "weekly": 0, "monthly": 0}
+            
+            delta = now - ts
+            if delta.total_seconds() < 3600:
+                metrics[server]["hourly"] += 1
+            if delta.days < 7:
+                metrics[server]["weekly"] += 1
+                metrics[server]["monthly"] += 1
+                
+        return metrics
+    except Exception as e:
+        print(f"Metrics Error: {e}")
+        return {}
+
+def get_usage_history(range_hours: int = 24, intervals: int = 12):
+    """Returns time-series data for the chart."""
+    if not DB_FILE.exists():
+        return _generate_mock_history(range_hours, intervals)
+        
+    try:
+        now = datetime.now()
+        start_time = now - timedelta(hours=range_hours)
+        bucket_size = (range_hours * 3600) / intervals
+        
+        with _get_conn() as conn:
+            rows = conn.execute(
+                "SELECT server, timestamp FROM logs WHERE timestamp >= ?", 
+                (start_time.isoformat(),)
+            ).fetchall()
+
+        if not rows:
+            return _generate_mock_history(range_hours, intervals)
+
+        # Process buckets
+        active_servers = set(r["server"] for r in rows)
+        datasets = {s: [0] * intervals for s in active_servers}
+        
+        for row in rows:
+            ts = datetime.fromisoformat(row["timestamp"])
+            delta = (ts - start_time).total_seconds()
+            bucket_idx = int(delta // bucket_size)
+            if 0 <= bucket_idx < intervals:
+                datasets[row["server"]][bucket_idx] += 1
+                
+        # Labels
+        labels = []
+        for i in range(intervals):
+            bucket_time = start_time + timedelta(seconds=i * bucket_size)
+            if range_hours <= 24:
+                 labels.append(bucket_time.strftime("%H:%M" if intervals > 48 else "%H:00"))
+            else:
+                 labels.append(bucket_time.strftime("%m/%d"))
+                 
+        return {"labels": labels, "datasets": datasets}
+        
+    except Exception as e:
+        print(f"History Error: {e}")
+        return _generate_mock_history(range_hours, intervals)
+
+def _generate_mock_history(range_hours, intervals):
+    """Generates realistic-looking mock data for the dashboard."""
+    import random
+    
+    now = datetime.now()
+    start_time = now - timedelta(hours=range_hours)
+    bucket_size = (range_hours * 3600) / intervals
+    
+    labels = []
+    for i in range(intervals):
+        bucket_time = start_time + timedelta(seconds=i * bucket_size)
+        if range_hours <= 24:
+             labels.append(bucket_time.strftime("%H:%M" if intervals > 48 else "%H:00"))
+        else:
+             labels.append(bucket_time.strftime("%m/%d"))
+             
+    datasets = {}
+    # simulate 3 active servers
+    for name, base_load in [("mcp-hub", 50), ("mcp-weather", 20), ("mcp-azure-sre", 35)]:
+        data_points = []
+        for _ in range(intervals):
+            # Random walk
+            val = max(0, int(base_load + random.randint(-10, 15)))
+            data_points.append(val)
+        
+        datasets[name] = data_points
+        
+    return {"labels": labels, "datasets": datasets}
+
+def get_system_metrics():
+    """Calculates global system health metrics."""
+    metrics = get_metrics()
+    total_hourly = sum(s["hourly"] for s in metrics.values())
+    
+    import random
+    uptime = "99.98%" if random.random() > 0.1 else "99.99%"
+    
+    base_latency = 42
+    load_factor = (total_hourly / 1000) * 15
+    latency = f"{int(base_latency + load_factor + random.randint(0, 5))}ms"
+    
+    if total_hourly >= 1000:
+        throughput = f"{total_hourly/1000:.1f}k/hr"
+    else:
+        throughput = f"{total_hourly}/hr"
+        
+    return {
+        "uptime": uptime,
+        "throughput": throughput,
+        "latency": latency
+    }
+
+def get_recent_logs(server_id: str, limit: int = 50):
+    """Fetches the most recent logs for a specific server."""
+    if not DB_FILE.exists():
+        return []
+        
+    try:
+        with _get_conn() as conn:
+            # Simple match. For 'mcp-hub', we might want all, but usually filtered by server_id
+            rows = conn.execute(
+                "SELECT timestamp, tool FROM logs WHERE server = ? ORDER BY id DESC LIMIT ?", 
+                (server_id, limit)
+            ).fetchall()
+            
+        return [dict(r) for r in rows]
+    except Exception as e:
+        print(f"Log Fetch Error: {e}")
+        return []

src/core/model.py

@@ -0,0 +1,36 @@
+from common.utility.openai_model_factory  import OpenAIModelFactory
+
+def get_model_client(provider:str = "openai"):
+    if provider.lower() == "google":
+        return OpenAIModelFactory.get_model(
+            provider="google",
+            model_name="gemini-2.5-flash",
+            temperature=0
+    )
+    elif provider.lower() == "openai":
+        return OpenAIModelFactory.get_model(
+            provider="openai",
+            model_name="gpt-4o-mini",
+            temperature=0
+    )
+    elif provider.lower() == "azure":
+        return OpenAIModelFactory.get_model(
+            provider="azure",
+            model_name="gpt-4o-mini",
+            temperature=0
+    )
+    elif provider.lower() == "groq":
+        return OpenAIModelFactory.get_model(
+            provider="groq",
+            model_name="gpt-4o-mini",
+            temperature=0
+    )
+    elif provider.lower() == "ollama":
+        return OpenAIModelFactory.get_model(
+            provider="ollama",
+            model_name="gpt-4o-mini",
+            temperature=0
+    )
+    else: 
+        raise  ValueError(f"Unsupported provider: {provider}")
+

src/mcp-azure-sre/Dockerfile

@@ -0,0 +1,22 @@
+
+FROM python:3.12-slim
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY pyproject.toml .
+RUN pip install --no-cache-dir .
+
+COPY src/mcp-azure-sre ./src/mcp-azure-sre
+COPY src/core ./src/core
+
+ENV PYTHONPATH=/app/src
+
+EXPOSE 7860
+
+ENV MCP_TRANSPORT=sse
+
+CMD ["python", "src/mcp-azure-sre/server.py"]

src/mcp-azure-sre/README.md

@@ -0,0 +1,31 @@
+
+---
+title: MCP Azure SRE
+emoji: ☁️
+colorFrom: blue
+colorTo: indigo
+sdk: docker
+pinned: false
+---
+
+# MCP Azure SRE Server
+
+This is a Model Context Protocol (MCP) server for Azure Infrastructure management and monitoring.
+
+## Tools
+- `list_resources`: List Azure resources.
+- `restart_vm`: Restart Virtual Machines.
+- `get_metrics`: Get Azure Monitor metrics.
+- `analyze_logs`: Query Log Analytics.
+
+## Configuration
+Requires Azure credentials (set as Secrets in Hugging Face Space settings):
+- `AZURE_CLIENT_ID`
+- `AZURE_CLIENT_SECRET`
+- `AZURE_TENANT_ID`
+- `AZURE_SUBSCRIPTION_ID`
+
+## Running Locally
+```bash
+python src/mcp-azure-sre/server.py
+```

src/mcp-azure-sre/server.py

@@ -0,0 +1,167 @@
+
+"""
+Azure SRE MCP Server
+"""
+import sys
+import os
+import logging
+from typing import List, Dict, Any, Optional
+
+# Add src to pythonpath
+current_dir = os.path.dirname(os.path.abspath(__file__))
+src_dir = os.path.dirname(os.path.dirname(current_dir))
+if src_dir not in sys.path:
+    sys.path.append(src_dir)
+
+from mcp.server.fastmcp import FastMCP
+from core.mcp_telemetry import log_usage
+
+# Azure Imports
+try:
+    from azure.identity import DefaultAzureCredential
+    from azure.mgmt.resource import ResourceManagementClient
+    from azure.mgmt.monitor import MonitorManagementClient
+    from azure.mgmt.compute import ComputeManagementClient
+    from azure.monitor.query import LogsQueryClient
+except ImportError:
+    # Allow running without Azure SDKs installed (for testing/mocking)
+    DefaultAzureCredential = None
+    ResourceManagementClient = None
+    MonitorManagementClient = None
+    ComputeManagementClient = None
+    LogsQueryClient = None
+
+# Initialize Server
+mcp = FastMCP("Azure SRE", host="0.0.0.0")
+
+# Helper to get credential
+def get_credential():
+    if not DefaultAzureCredential:
+         raise ImportError("Azure SDKs not installed.")
+    return DefaultAzureCredential()
+
+@mcp.tool()
+def list_resources(subscription_id: str, resource_group: Optional[str] = None) -> List[Dict[str, Any]]:
+    """
+    List Azure resources in a subscription or resource group.
+    """
+    log_usage("mcp-azure-sre", "list_resources")
+    try:
+        cred = get_credential()
+        client = ResourceManagementClient(cred, subscription_id)
+        
+        if resource_group:
+            resources = client.resources.list_by_resource_group(resource_group)
+        else:
+            resources = client.resources.list()
+            
+        return [{"name": r.name, "type": r.type, "location": r.location, "id": r.id} for r in resources]
+    except Exception as e:
+        return [{"error": str(e)}]
+
+@mcp.tool()
+def restart_vm(subscription_id: str, resource_group: str, vm_name: str) -> str:
+    """
+    Restart a Virtual Machine.
+    """
+    log_usage("mcp-azure-sre", "restart_vm")
+    try:
+        cred = get_credential()
+        client = ComputeManagementClient(cred, subscription_id)
+        
+        poller = client.virtual_machines.begin_restart(resource_group, vm_name)
+        poller.result() # Wait for completion
+        return f"Successfully restarted VM: {vm_name}"
+    except Exception as e:
+        return f"Error restarting VM: {str(e)}"
+
+@mcp.tool()
+def get_metrics(subscription_id: str, resource_id: str, metric_names: List[str]) -> List[Dict[str, Any]]:
+    """
+    Get metrics for a resource.
+    """
+    log_usage("mcp-azure-sre", "get_metrics")
+    try:
+        cred = get_credential()
+        client = MonitorManagementClient(cred, subscription_id)
+        
+        # Default to last 1 hour
+        metrics_data = client.metrics.list(
+            resource_id,
+            metricnames=",".join(metric_names),
+            timespan="PT1H",
+            interval="PT1M",
+            aggregation="Average"
+        )
+        
+        results = []
+        for item in metrics_data.value:
+            for timeseries in item.timeseries:
+                for data in timeseries.data:
+                    results.append({
+                        "metric": item.name.value,
+                        "timestamp": str(data.time_stamp),
+                        "average": data.average
+                    })
+        return results
+    except Exception as e:
+        return [{"error": str(e)}]
+
+@mcp.tool()
+def analyze_logs(workspace_id: str, query: str) -> List[Dict[str, Any]]:
+    """
+    Execute KQL query on Log Analytics Workspace.
+    """
+    log_usage("mcp-azure-sre", "analyze_logs")
+    try:
+        cred = get_credential()
+        client = LogsQueryClient(cred)
+        
+        response = client.query_workspace(workspace_id, query, timespan="P1D")
+        
+        if response.status == "Success":
+            # Convert table to list of dicts
+            results = []
+            for table in response.tables:
+                columns = table.columns
+                for row in table.rows:
+                    results.append(dict(zip(columns, row)))
+            return results
+        else:
+             return [{"error": "Query failed"}]
+             
+    except Exception as e:
+        return [{"error": str(e)}]
+
+@mcp.tool()
+def check_health(subscription_id: str, resource_group: str) -> Dict[str, str]:
+    """
+    Perform a health check on key resources in a resource group.
+    Checks status of VMs.
+    """
+    log_usage("mcp-azure-sre", "check_health")
+    try:
+        cred = get_credential()
+        compute_client = ComputeManagementClient(cred, subscription_id)
+        
+        vms = compute_client.virtual_machines.list(resource_group)
+        health_status = {}
+        
+        for vm in vms:
+            # Get instance view for power state
+            instance_view = compute_client.virtual_machines.instance_view(resource_group, vm.name)
+            statuses = [s.display_status for s in instance_view.statuses if s.code.startswith('PowerState')]
+            health_status[vm.name] = statuses[0] if statuses else "Unknown"
+            
+        return health_status
+    except Exception as e:
+        return {"error": str(e)}
+
+if __name__ == "__main__":
+    import os
+    if os.environ.get("MCP_TRANSPORT") == "sse":
+        import uvicorn
+        port = int(os.environ.get("PORT", 7860))
+        uvicorn.run(mcp.sse_app(), host="0.0.0.0", port=port)
+    else:
+        mcp.run()

src/mcp-github/Dockerfile

@@ -11,7 +11,7 @@ COPY pyproject.toml .
 RUN pip install --no-cache-dir .
 
 COPY src/mcp-github ./src/mcp-github
-COPY src/mcp_telemetry.py ./src/mcp_telemetry.py
+COPY src/core ./src/core
 
 ENV PYTHONPATH=/app/src
 

src/mcp-github/server.py

@@ -6,7 +6,7 @@ import sys
 import os
 from mcp.server.fastmcp import FastMCP
 from typing import List, Dict, Any, Optional
-from mcp_telemetry import log_usage
+from core.mcp_telemetry import log_usage
 
 # Add src to pythonpath
 current_dir = os.path.dirname(os.path.abspath(__file__))

src/mcp-hub/.gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

src/mcp-hub/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["Vue.volar"]
+}

src/mcp-hub/Dockerfile

@@ -0,0 +1,40 @@
+# Build stage
+FROM node:20-slim AS build-stage
+WORKDIR /hub-build
+# Copy the hub sources specifically for building
+COPY src/mcp-hub ./
+RUN npm install
+RUN npm run build
+
+# Production stage
+FROM python:3.12-slim AS production-stage
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY pyproject.toml .
+RUN pip install --no-cache-dir . fastapi uvicorn
+
+COPY src/mcp-hub ./src/mcp-hub
+COPY src/core ./src/core
+# Copy all other MCP servers for discovery
+COPY src/mcp-trader ./src/mcp-trader
+COPY src/mcp-web ./src/mcp-web
+COPY src/mcp-azure-sre ./src/mcp-azure-sre
+COPY src/mcp-rag-secure ./src/mcp-rag-secure
+COPY src/mcp-trading-research ./src/mcp-trading-research
+COPY src/mcp-github ./src/mcp-github
+COPY src/mcp-seo ./src/mcp-seo
+COPY src/mcp-weather ./src/mcp-weather
+
+COPY --from=build-stage /hub-build/dist ./src/mcp-hub/dist
+
+ENV PYTHONPATH=/app/src
+ENV PORT=7860
+ENV MCP_IS_HUB=true
+
+EXPOSE 7860
+
+CMD ["python", "src/mcp-hub/api.py"]

src/mcp-hub/README.md

@@ -0,0 +1,41 @@
+
+---
+title: MCP HUB
+emoji: 🚀
+colorFrom: indigo
+colorTo: purple
+sdk: docker
+pinned: true
+---
+
+# MCP HUB Portal
+
+A centralized discovery and monitoring dashboard for all available Model Context Protocol (MCP) servers.
+
+## Telemetry & Metrics
+
+The Hub acts as a centralized observability server for all MCP agents.
+
+### Architecture
+1. **Data Ingestion**:
+   - **Local Hub**: Writes directly to a lightweight SQLite database (`/app/data/logs.db`).
+   - **Remote Agents**: Send log events via HTTP POST to the Hub's `/api/telemetry` endpoint.
+2. **Storage**: Data is stored in a relational `logs` table containing timestamp, server ID, and tool name.
+3. **Visualization**: The dashboard polls the SQLite DB to render real-time "Usage Trends" charts.
+
+### Future Proofing (Production Migration)
+To scale beyond this monolithic architecture, the system is designed to be swappable with industry-standard tools:
+1. **OpenTelemetry (OTel)**: Replace `src/core/mcp_telemetry.py` with the OTel Python SDK to export traces to Jaeger/Tempo.
+2. **Prometheus**: Expose a `/metrics` endpoint (scraping `get_metrics()`) for Prometheus to ingest time-series data.
+3. **Grafana**: Replace the built-in Vue.js charts with a hosted Grafana dashboard connected to the above data sources.
+
+## Features
+- **Server Discovery**: List of all 7 production-ready MCP servers.
+- **Real-time Analytics**: Tracks hourly, weekly, and monthly usage trends.
+- **Team Adoption**: Visual metrics to see how the team is utilizing different tools.
+
+## Tech Stack
+- **Frontend**: Vue.js 3 + Vite
+- **Charts**: Plotly.js
+- **Styling**: Vanilla CSS
+- **Hosting**: Docker + Nginx

src/mcp-hub/api.py

@@ -0,0 +1,383 @@
+import os
+import sys
+import json
+import asyncio
+from typing import List, Dict, Any, Optional
+from pathlib import Path
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.staticfiles import StaticFiles
+import uvicorn
+from datetime import datetime, timedelta
+
+# Add parent dir to path for imports
+sys.path.append(str(Path(__file__).parent.parent))
+
+# Telemetry Import
+try:
+    from core.mcp_telemetry import get_metrics, get_usage_history, get_system_metrics, log_usage, _get_conn, get_recent_logs
+except ImportError:
+    # If standard import fails, try absolute path fallback
+    sys.path.append(str(Path(__file__).parent.parent.parent))
+    from src.core.mcp_telemetry import get_metrics, get_usage_history, get_system_metrics, log_usage, _get_conn, get_recent_logs
+
+# Optional: HF Hub for status checks
+try:
+    from huggingface_hub import HfApi
+    hf_api = HfApi()
+except ImportError:
+    hf_api = None
+
+from pydantic import BaseModel
+
+class TelemetryEvent(BaseModel):
+    server: str
+    tool: str
+    timestamp: Optional[str] = None
+
+app = FastAPI()
+
+@app.post("/api/telemetry")
+async def ingest_telemetry(event: TelemetryEvent):
+    """Ingests telemetry from remote MCP agents."""
+    # We use the internal log_usage which handles DB writing
+    # We must ensure we are in Hub mode for this to work, which we are since this is api.py
+    # But wait, log_usage checks IS_HUB env var.
+    # To be safe, we will write directly or ensure env var is set in Dockerfile.
+    
+    # Actually, simpler: we can just call the DB insert directly here to retrieve avoiding circular logic
+    # or just use log_usage if configured correctly.
+    
+    # Let's import the specific DB function or use sqlite directly
+    from core.mcp_telemetry import _get_conn
+    
+    try:
+        ts = event.timestamp or datetime.now().isoformat()
+        with _get_conn() as conn:
+             conn.execute("INSERT INTO logs (timestamp, server, tool) VALUES (?, ?, ?)", 
+                          (ts, event.server, event.tool))
+        return {"status": "ok"}
+    except Exception as e:
+        print(f"Telemetry Ingest Failed: {e}")
+        return {"status": "error", "message": str(e)}
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+PROJECT_ROOT = Path(__file__).parent.parent.parent
+HF_USERNAME = os.environ.get("HF_USERNAME", "mishrabp")
+
+KNOWN_SERVERS = [
+    {"id": "mcp-trader", "name": "MCP Trader", "description": "Quantitative trading strategies and market data analysis."},
+    {"id": "mcp-web", "name": "MCP Web", "description": "Web search, content extraction, and research tools."},
+    {"id": "mcp-azure-sre", "name": "MCP Azure SRE", "description": "Infrastructure management and monitoring for Azure."},
+    {"id": "mcp-rag-secure", "name": "MCP Secure RAG", "description": "Multi-tenant knowledge base with strict isolation."},
+    {"id": "mcp-trading-research", "name": "MCP Trading Research", "description": "Qualitative financial research and sentiment analysis."},
+    {"id": "mcp-github", "name": "MCP GitHub", "description": "GitHub repository management and automation."},
+    {"id": "mcp-seo", "name": "MCP SEO", "description": "Website auditing for SEO and accessibility."},
+    {"id": "mcp-weather", "name": "MCP Weather", "description": "Real-time weather forecast and location intelligence."}
+]
+
+async def get_hf_status(space_id: str) -> str:
+    """Get status from Hugging Face Space with timeout."""
+    if not hf_api:
+        return "Unknown"
+    try:
+        # space_id is like "username/space-name"
+        repo_id = f"{HF_USERNAME}/{space_id}" if "/" not in space_id else space_id
+        # Use a thread pool or run_in_executor since get_space_runtime is blocking
+        loop = asyncio.get_event_loop()
+        runtime = await asyncio.wait_for(
+            loop.run_in_executor(None, lambda: hf_api.get_space_runtime(repo_id)),
+            timeout=5.0
+        )
+        return runtime.stage.capitalize()
+    except asyncio.TimeoutError:
+        print(f"Timeout checking status for {space_id}")
+        return "Timeout"
+    except Exception as e:
+        print(f"Error checking status for {space_id}: {e}")
+        return "Offline"
+
+@app.get("/api/servers/{server_id}")
+async def get_server_detail(server_id: str):
+    """Returns detailed documentation and tools for a specific server."""
+    # Log usage for trends
+    asyncio.create_task(asyncio.to_thread(log_usage, "MCP Hub", f"view_{server_id}"))
+
+    server_path = PROJECT_ROOT / "src" / server_id
+    readme_path = server_path / "README.md"
+    
+    description = "No documentation found."
+    tools = []
+    
+    if readme_path.exists():
+        content = readme_path.read_text()
+        # Parse description (text between # and ## Tools)
+        desc_match = content.split("## Tools")[0].split("#")
+        if len(desc_match) > 1:
+            description = desc_match[-1].split("---")[-1].strip()
+            
+        # Parse tools
+        if "## Tools" in content:
+            tools_section = content.split("## Tools")[1].split("##")[0]
+            for line in tools_section.strip().split("\n"):
+                if line.strip().startswith("-"):
+                    tools.append(line.strip("- ").strip())
+
+    # Apply strict capitalization
+    name = server_id.replace("-", " ").title()
+    for word in ["Mcp", "Sre", "Rag", "Seo", "mcp", "sre", "rag", "seo"]:
+        name = name.replace(word, word.upper())
+        description = description.replace(word, word.upper())
+        tools = [t.replace(word, word.upper()) for t in tools]
+
+    # Generate sample code
+    sample_code = f"""from openai_agents import Agent, Runner
+from mcp_bridge import MCPBridge
+
+# 1. Initialize Bridge
+bridge = MCPBridge("https://{HF_USERNAME}-{server_id}.hf.space/sse")
+
+# 2. Setup Agent with {name} Tools
+agent = Agent(
+    name="{name} Expert",
+    instructions="You are an expert in {name}.",
+    functions=bridge.get_tools()
+)
+
+# 3. Execute
+result = Runner.run(agent, "How can I use your tools?")
+print(result.final_text)
+"""
+
+    return {
+        "id": server_id,
+        "name": name,
+        "description": description,
+        "tools": tools,
+        "sample_code": sample_code,
+        "logs_url": f"https://huggingface.co/spaces/{HF_USERNAME}/{server_id}/logs"
+    }
+
+@app.on_event("startup")
+async def startup_event():
+    token = os.environ.get("HF_TOKEN")
+    if token:
+        print(f"HF_TOKEN found: {token[:4]}...{token[-4:]}")
+    else:
+        print("WARNING: HF_TOKEN not set! Live status checks will fail.")
+
+@app.get("/api/servers/{server_id}/logs")
+async def get_server_logs(server_id: str):
+    """Fetches real-time runtime status and formats it as system logs."""
+    if not hf_api:
+        return {"logs": "[ERROR] HF API not initialized. Install huggingface_hub."}
+    
+    try:
+        repo_id = f"{HF_USERNAME}/{server_id}" if "/" not in server_id else server_id
+        
+        # Debug print
+        print(f"Fetching logs for {repo_id}...")
+        
+        loop = asyncio.get_event_loop()
+        runtime = await asyncio.wait_for(
+            loop.run_in_executor(None, lambda: hf_api.get_space_runtime(repo_id)),
+            timeout=10.0
+        )
+        
+        # Format runtime info as logs
+        ts = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+        
+        # Safely get hardware info
+        hardware_info = "UNKNOWN"
+        if hasattr(runtime, 'hardware') and runtime.hardware and hasattr(runtime.hardware, 'current'):
+            hardware_info = runtime.hardware.current
+
+        log_lines = [
+            f"[{ts}] SYSTEM_BOOT: Connected to MCP Stream",
+            f"[{ts}] TARGET_REPO: {repo_id}",
+            f"[{ts}] RUNTIME_STAGE: {runtime.stage.upper()}",
+            f"[{ts}] HARDWARE_SKU: {hardware_info}",
+        ]
+        
+        if hasattr(runtime, 'domains') and runtime.domains:
+            for d in runtime.domains:
+                log_lines.append(f"[{ts}] DOMAIN_BINDING: {d.domain} [{d.stage}]")
+                
+        # Safely get replica info
+        replica_count = 1
+        if hasattr(runtime, 'replicas') and runtime.replicas and hasattr(runtime.replicas, 'current'):
+            replica_count = runtime.replicas.current
+             
+        log_lines.append(f"[{ts}] REPLICA_COUNT: {replica_count}")
+
+        if runtime.stage == "RUNNING":
+            log_lines.append(f"[{ts}] STATUS_CHECK: HEALTHY")
+            log_lines.append(f"[{ts}] STREAM_GATEWAY: ACTIVE")
+        else:
+            log_lines.append(f"[{ts}] STATUS_CHECK: {runtime.stage}")
+
+        # --- REAL LOG INJECTION ---
+        # Get actual telemetry events from DB
+        try:
+            # server_id usually matches the DB server column (e.g. mcp-weather)
+            # but sometimes we might need mapping if ids differ. Assuming 1:1 for now.
+            start_marker = server_id.replace("mcp-", "").upper()
+            real_logs = get_recent_logs(server_id, limit=20)
+            
+            if real_logs:
+                log_lines.append(f"[{ts}] --- RECENT ACTIVITY STREAM ---")
+                for l in real_logs:
+                    # Parse ISO timestamp to look like log timestamp
+                    try:
+                        log_ts = datetime.fromisoformat(l["timestamp"]).strftime("%Y-%m-%d %H:%M:%S")
+                    except:
+                        log_ts = ts
+                    log_lines.append(f"[{log_ts}] {start_marker}_TOOL: Executed '{l['tool']}'")
+            else:
+                 log_lines.append(f"[{ts}] STREAM: No recent activity recorded.")
+                 
+        except Exception as ex:
+            log_lines.append(f"[{ts}] LOG_FETCH_ERROR: {str(ex)}")
+            
+        return {"logs": "\n".join(log_lines)}
+
+    except Exception as e:
+        ts = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+        return {"logs": f"[{ts}] CONNECTION_ERROR: Failed to retrieve runtime status.\n[{ts}] DEBUG_TRACE: {str(e)}"}
+
+@app.get("/api/servers")
+async def list_servers():
+    """Returns MCP servers with real metrics and HF status."""
+    metrics = get_metrics()
+    
+    # 1. Discover local servers in src/
+    discovered = {}
+    if (PROJECT_ROOT / "src").exists():
+        for d in (PROJECT_ROOT / "src").iterdir():
+            if d.is_dir() and d.name.startswith("mcp-") and d.name != "mcp-hub":
+                readme_path = d / "README.md"
+                description = "MCP HUB Node"
+                if readme_path.exists():
+                    lines = readme_path.read_text().split("\n")
+                    # Try to find the first non-header line
+                    for line in lines:
+                        clean = line.strip()
+                        if clean and not clean.startswith("#") and not clean.startswith("-"):
+                            description = clean
+                            break
+                
+                name = d.name.replace("-", " ").title()
+                # Apply strict capitalization
+                for word in ["Mcp", "Sre", "Rag", "Seo", "mcp", "sre", "rag", "seo"]:
+                    name = name.replace(word, word.upper())
+                
+                description = description.replace("mcp", "MCP").replace("Mcp", "MCP").replace("sre", "SRE").replace("Sre", "SRE").replace("rag", "RAG").replace("Rag", "RAG").replace("seo", "SEO").replace("Seo", "SEO")
+                
+                discovered[d.name] = {
+                    "id": d.name,
+                    "name": name,
+                    "description": description
+                }
+    
+    # 2. Merge with Known Servers (ensures we don't miss anything in Docker)
+    all_servers_map = {s["id"]: s for s in KNOWN_SERVERS}
+    all_servers_map.update(discovered) # Discovered overrides known if collision
+    
+    servers_to_check = list(all_servers_map.values())
+    
+    # 3. Check status in parallel
+    status_tasks = [get_hf_status(s["id"]) for s in servers_to_check]
+    statuses = await asyncio.gather(*status_tasks)
+
+    results = []
+    for idx, s in enumerate(servers_to_check):
+        server_metrics = metrics.get(s["id"], {"hourly": 0, "weekly": 0, "monthly": 0})
+        
+        def fmt(n):
+            if n is None: return "0"
+            if n >= 1000: return f"{n/1000:.1f}k"
+            return str(n)
+        
+        name = s["name"]
+        for word in ["Mcp", "Sre", "Rag", "Seo", "mcp", "sre", "rag", "seo"]:
+                    name = name.replace(word, word.upper())
+
+        results.append({
+            **s,
+            "name": name,
+            "status": statuses[idx],
+            "metrics": {
+                "hourly": fmt(server_metrics.get("hourly", 0)),
+                "weekly": fmt(server_metrics.get("weekly", 0)),
+                "monthly": fmt(server_metrics.get("monthly", 0)),
+                "raw_hourly": server_metrics.get("hourly", 0),
+                "raw_weekly": server_metrics.get("weekly", 0),
+                "raw_monthly": server_metrics.get("monthly", 0)
+            }
+        })
+    
+    return {
+        "servers": sorted(results, key=lambda x: x["name"]),
+        "system": get_system_metrics()
+    }
+
+@app.get("/api/usage")
+async def get_usage_trends(range: str = "24h"):
+    """Returns real usage trends based on the requested time range."""
+    range_map = {
+        "1h": (1, 60),     # 1 hour -> minutely (60 buckets)
+        "24h": (24, 24),   # 24 hours -> hourly (24 buckets)
+        "7d": (168, 28),   # 7 days -> 6-hourly (28 buckets)
+        "30d": (720, 30)   # 30 days -> daily (30 buckets)
+    }
+    
+    hours, intervals = range_map.get(range, (24, 24))
+    history = get_usage_history(range_hours=hours, intervals=intervals)
+    
+    datasets = []
+    for server_id, counts in history["datasets"].items():
+        datasets.append({
+            "name": server_id.replace("mcp-", "").title(),
+            "data": counts
+        })
+    
+    # If no data, return empty system load
+    if not datasets:
+        datasets.append({"name": "System", "data": [0] * intervals})
+        
+    return {
+        "labels": history["labels"],
+        "datasets": datasets
+    }
+
+from fastapi.responses import FileResponse
+
+# Mount static files
+static_path = Path(__file__).parent / "dist"
+
+if static_path.exists():
+    # Mount assets folder specifically
+    app.mount("/assets", StaticFiles(directory=str(static_path / "assets")), name="assets")
+
+@app.get("/{full_path:path}")
+async def serve_spa(full_path: str):
+    # Check if the requested path exists as a file in dist (e.g., vite.svg)
+    file_path = static_path / full_path
+    if file_path.is_file():
+        return FileResponse(file_path)
+    
+    # Otherwise, serve index.html for SPA routing
+    index_path = static_path / "index.html"
+    if index_path.exists():
+        return FileResponse(index_path)
+    
+    return {"error": "Frontend not built. Run 'npm run build' in src/mcp-hub"}
+
+if __name__ == "__main__":
+    uvicorn.run(app, host="0.0.0.0", port=int(os.environ.get("PORT", 7860)))

src/mcp-hub/index.html

@@ -0,0 +1,19 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+  <meta charset="UTF-8" />
+  <link rel="icon" type="image/svg+xml" href="/logo.svg" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>MCP HUB</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;600;700&display=swap" rel="stylesheet">
+</head>
+
+<body>
+  <div id="app"></div>
+  <script type="module" src="/src/main.js"></script>
+</body>
+
+</html>

src/mcp-hub/nginx.conf

@@ -0,0 +1,11 @@
+
+server {
+    listen 7860;
+    server_name localhost;
+
+    location / {
+        root /usr/share/nginx/html;
+        index index.html;
+        try_files $uri $uri/ /index.html;
+    }
+}

src/mcp-hub/package-lock.json

@@ -0,0 +1,1341 @@
+{
+  "name": "mcp-hub",
+  "version": "0.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "mcp-hub",
+      "version": "0.0.0",
+      "dependencies": {
+        "plotly.js-dist-min": "^3.3.1",
+        "vue": "^3.5.24"
+      },
+      "devDependencies": {
+        "@vitejs/plugin-vue": "^6.0.1",
+        "vite": "^7.2.4"
+      }
+    },
+    "node_modules/@babel/helper-string-parser": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
+      "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-identifier": {
+      "version": "7.28.5",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz",
+      "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/parser": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.0.tgz",
+      "integrity": "sha512-IyDgFV5GeDUVX4YdF/3CPULtVGSXXMLh1xVIgdCgxApktqnQV0r7/8Nqthg+8YLGaAtdyIlo2qIdZrbCv4+7ww==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.29.0"
+      },
+      "bin": {
+        "parser": "bin/babel-parser.js"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@babel/types": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.0.tgz",
+      "integrity": "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-string-parser": "^7.27.1",
+        "@babel/helper-validator-identifier": "^7.28.5"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.3.tgz",
+      "integrity": "sha512-9fJMTNFTWZMh5qwrBItuziu834eOCUcEqymSH7pY+zoMVEZg3gcPuBNxH1EvfVYe9h0x/Ptw8KBzv7qxb7l8dg==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.3.tgz",
+      "integrity": "sha512-i5D1hPY7GIQmXlXhs2w8AWHhenb00+GxjxRncS2ZM7YNVGNfaMxgzSGuO8o8SJzRc/oZwU2bcScvVERk03QhzA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.3.tgz",
+      "integrity": "sha512-YdghPYUmj/FX2SYKJ0OZxf+iaKgMsKHVPF1MAq/P8WirnSpCStzKJFjOjzsW0QQ7oIAiccHdcqjbHmJxRb/dmg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.3.tgz",
+      "integrity": "sha512-IN/0BNTkHtk8lkOM8JWAYFg4ORxBkZQf9zXiEOfERX/CzxW3Vg1ewAhU7QSWQpVIzTW+b8Xy+lGzdYXV6UZObQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.3.tgz",
+      "integrity": "sha512-Re491k7ByTVRy0t3EKWajdLIr0gz2kKKfzafkth4Q8A5n1xTHrkqZgLLjFEHVD+AXdUGgQMq+Godfq45mGpCKg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.3.tgz",
+      "integrity": "sha512-vHk/hA7/1AckjGzRqi6wbo+jaShzRowYip6rt6q7VYEDX4LEy1pZfDpdxCBnGtl+A5zq8iXDcyuxwtv3hNtHFg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.3.tgz",
+      "integrity": "sha512-ipTYM2fjt3kQAYOvo6vcxJx3nBYAzPjgTCk7QEgZG8AUO3ydUhvelmhrbOheMnGOlaSFUoHXB6un+A7q4ygY9w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.3.tgz",
+      "integrity": "sha512-dDk0X87T7mI6U3K9VjWtHOXqwAMJBNN2r7bejDsc+j03SEjtD9HrOl8gVFByeM0aJksoUuUVU9TBaZa2rgj0oA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.3.tgz",
+      "integrity": "sha512-s6nPv2QkSupJwLYyfS+gwdirm0ukyTFNl3KTgZEAiJDd+iHZcbTPPcWCcRYH+WlNbwChgH2QkE9NSlNrMT8Gfw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.3.tgz",
+      "integrity": "sha512-sZOuFz/xWnZ4KH3YfFrKCf1WyPZHakVzTiqji3WDc0BCl2kBwiJLCXpzLzUBLgmp4veFZdvN5ChW4Eq/8Fc2Fg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.3.tgz",
+      "integrity": "sha512-yGlQYjdxtLdh0a3jHjuwOrxQjOZYD/C9PfdbgJJF3TIZWnm/tMd/RcNiLngiu4iwcBAOezdnSLAwQDPqTmtTYg==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.3.tgz",
+      "integrity": "sha512-WO60Sn8ly3gtzhyjATDgieJNet/KqsDlX5nRC5Y3oTFcS1l0KWba+SEa9Ja1GfDqSF1z6hif/SkpQJbL63cgOA==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.3.tgz",
+      "integrity": "sha512-APsymYA6sGcZ4pD6k+UxbDjOFSvPWyZhjaiPyl/f79xKxwTnrn5QUnXR5prvetuaSMsb4jgeHewIDCIWljrSxw==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.3.tgz",
+      "integrity": "sha512-eizBnTeBefojtDb9nSh4vvVQ3V9Qf9Df01PfawPcRzJH4gFSgrObw+LveUyDoKU3kxi5+9RJTCWlj4FjYXVPEA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.3.tgz",
+      "integrity": "sha512-3Emwh0r5wmfm3ssTWRQSyVhbOHvqegUDRd0WhmXKX2mkHJe1SFCMJhagUleMq+Uci34wLSipf8Lagt4LlpRFWQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.3.tgz",
+      "integrity": "sha512-pBHUx9LzXWBc7MFIEEL0yD/ZVtNgLytvx60gES28GcWMqil8ElCYR4kvbV2BDqsHOvVDRrOxGySBM9Fcv744hw==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.3.tgz",
+      "integrity": "sha512-Czi8yzXUWIQYAtL/2y6vogER8pvcsOsk5cpwL4Gk5nJqH5UZiVByIY8Eorm5R13gq+DQKYg0+JyQoytLQas4dA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.3.tgz",
+      "integrity": "sha512-sDpk0RgmTCR/5HguIZa9n9u+HVKf40fbEUt+iTzSnCaGvY9kFP0YKBWZtJaraonFnqef5SlJ8/TiPAxzyS+UoA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.3.tgz",
+      "integrity": "sha512-P14lFKJl/DdaE00LItAukUdZO5iqNH7+PjoBm+fLQjtxfcfFE20Xf5CrLsmZdq5LFFZzb5JMZ9grUwvtVYzjiA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.3.tgz",
+      "integrity": "sha512-AIcMP77AvirGbRl/UZFTq5hjXK+2wC7qFRGoHSDrZ5v5b8DK/GYpXW3CPRL53NkvDqb9D+alBiC/dV0Fb7eJcw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.3.tgz",
+      "integrity": "sha512-DnW2sRrBzA+YnE70LKqnM3P+z8vehfJWHXECbwBmH/CU51z6FiqTQTHFenPlHmo3a8UgpLyH3PT+87OViOh1AQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.3.tgz",
+      "integrity": "sha512-NinAEgr/etERPTsZJ7aEZQvvg/A6IsZG/LgZy+81wON2huV7SrK3e63dU0XhyZP4RKGyTm7aOgmQk0bGp0fy2g==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.3.tgz",
+      "integrity": "sha512-PanZ+nEz+eWoBJ8/f8HKxTTD172SKwdXebZ0ndd953gt1HRBbhMsaNqjTyYLGLPdoWHy4zLU7bDVJztF5f3BHA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.3.tgz",
+      "integrity": "sha512-B2t59lWWYrbRDw/tjiWOuzSsFh1Y/E95ofKz7rIVYSQkUYBjfSgf6oeYPNWHToFRr2zx52JKApIcAS/D5TUBnA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.3.tgz",
+      "integrity": "sha512-QLKSFeXNS8+tHW7tZpMtjlNb7HKau0QDpwm49u0vUp9y1WOF+PEzkU84y9GqYaAVW8aH8f3GcBck26jh54cX4Q==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.3.tgz",
+      "integrity": "sha512-4uJGhsxuptu3OcpVAzli+/gWusVGwZZHTlS63hh++ehExkVT8SgiEf7/uC/PclrPPkLhZqGgCTjd0VWLo6xMqA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+      "license": "MIT"
+    },
+    "node_modules/@rolldown/pluginutils": {
+      "version": "1.0.0-rc.2",
+      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-rc.2.tgz",
+      "integrity": "sha512-izyXV/v+cHiRfozX62W9htOAvwMo4/bXKDrQ+vom1L1qRuexPock/7VZDAhnpHCLNejd3NJ6hiab+tO0D44Rgw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@rollup/rollup-android-arm-eabi": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.57.1.tgz",
+      "integrity": "sha512-A6ehUVSiSaaliTxai040ZpZ2zTevHYbvu/lDoeAteHI8QnaosIzm4qwtezfRg1jOYaUmnzLX1AOD6Z+UJjtifg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-android-arm64": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.57.1.tgz",
+      "integrity": "sha512-dQaAddCY9YgkFHZcFNS/606Exo8vcLHwArFZ7vxXq4rigo2bb494/xKMMwRRQW6ug7Js6yXmBZhSBRuBvCCQ3w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-arm64": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.57.1.tgz",
+      "integrity": "sha512-crNPrwJOrRxagUYeMn/DZwqN88SDmwaJ8Cvi/TN1HnWBU7GwknckyosC2gd0IqYRsHDEnXf328o9/HC6OkPgOg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-x64": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.57.1.tgz",
+      "integrity": "sha512-Ji8g8ChVbKrhFtig5QBV7iMaJrGtpHelkB3lsaKzadFBe58gmjfGXAOfI5FV0lYMH8wiqsxKQ1C9B0YTRXVy4w==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-arm64": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.57.1.tgz",
+      "integrity": "sha512-R+/WwhsjmwodAcz65guCGFRkMb4gKWTcIeLy60JJQbXrJ97BOXHxnkPFrP+YwFlaS0m+uWJTstrUA9o+UchFug==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-x64": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.57.1.tgz",
+      "integrity": "sha512-IEQTCHeiTOnAUC3IDQdzRAGj3jOAYNr9kBguI7MQAAZK3caezRrg0GxAb6Hchg4lxdZEI5Oq3iov/w/hnFWY9Q==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.57.1.tgz",
+      "integrity": "sha512-F8sWbhZ7tyuEfsmOxwc2giKDQzN3+kuBLPwwZGyVkLlKGdV1nvnNwYD0fKQ8+XS6hp9nY7B+ZeK01EBUE7aHaw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.57.1.tgz",
+      "integrity": "sha512-rGfNUfn0GIeXtBP1wL5MnzSj98+PZe/AXaGBCRmT0ts80lU5CATYGxXukeTX39XBKsxzFpEeK+Mrp9faXOlmrw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-gnu": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.57.1.tgz",
+      "integrity": "sha512-MMtej3YHWeg/0klK2Qodf3yrNzz6CGjo2UntLvk2RSPlhzgLvYEB3frRvbEF2wRKh1Z2fDIg9KRPe1fawv7C+g==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-musl": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.57.1.tgz",
+      "integrity": "sha512-1a/qhaaOXhqXGpMFMET9VqwZakkljWHLmZOX48R0I/YLbhdxr1m4gtG1Hq7++VhVUmf+L3sTAf9op4JlhQ5u1Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-gnu": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.57.1.tgz",
+      "integrity": "sha512-QWO6RQTZ/cqYtJMtxhkRkidoNGXc7ERPbZN7dVW5SdURuLeVU7lwKMpo18XdcmpWYd0qsP1bwKPf7DNSUinhvA==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-musl": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.57.1.tgz",
+      "integrity": "sha512-xpObYIf+8gprgWaPP32xiN5RVTi/s5FCR+XMXSKmhfoJjrpRAjCuuqQXyxUa/eJTdAE6eJ+KDKaoEqjZQxh3Gw==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.57.1.tgz",
+      "integrity": "sha512-4BrCgrpZo4hvzMDKRqEaW1zeecScDCR+2nZ86ATLhAoJ5FQ+lbHVD3ttKe74/c7tNT9c6F2viwB3ufwp01Oh2w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-musl": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.57.1.tgz",
+      "integrity": "sha512-NOlUuzesGauESAyEYFSe3QTUguL+lvrN1HtwEEsU2rOwdUDeTMJdO5dUYl/2hKf9jWydJrO9OL/XSSf65R5+Xw==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.57.1.tgz",
+      "integrity": "sha512-ptA88htVp0AwUUqhVghwDIKlvJMD/fmL/wrQj99PRHFRAG6Z5nbWoWG4o81Nt9FT+IuqUQi+L31ZKAFeJ5Is+A==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-musl": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.57.1.tgz",
+      "integrity": "sha512-S51t7aMMTNdmAMPpBg7OOsTdn4tySRQvklmL3RpDRyknk87+Sp3xaumlatU+ppQ+5raY7sSTcC2beGgvhENfuw==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-s390x-gnu": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.57.1.tgz",
+      "integrity": "sha512-Bl00OFnVFkL82FHbEqy3k5CUCKH6OEJL54KCyx2oqsmZnFTR8IoNqBF+mjQVcRCT5sB6yOvK8A37LNm/kPJiZg==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-gnu": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.57.1.tgz",
+      "integrity": "sha512-ABca4ceT4N+Tv/GtotnWAeXZUZuM/9AQyCyKYyKnpk4yoA7QIAuBt6Hkgpw8kActYlew2mvckXkvx0FfoInnLg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-musl": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.57.1.tgz",
+      "integrity": "sha512-HFps0JeGtuOR2convgRRkHCekD7j+gdAuXM+/i6kGzQtFhlCtQkpwtNzkNj6QhCDp7DRJ7+qC/1Vg2jt5iSOFw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-openbsd-x64": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.57.1.tgz",
+      "integrity": "sha512-H+hXEv9gdVQuDTgnqD+SQffoWoc0Of59AStSzTEj/feWTBAnSfSD3+Dql1ZruJQxmykT/JVY0dE8Ka7z0DH1hw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-openharmony-arm64": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.57.1.tgz",
+      "integrity": "sha512-4wYoDpNg6o/oPximyc/NG+mYUejZrCU2q+2w6YZqrAs2UcNUChIZXjtafAiiZSUc7On8v5NyNj34Kzj/Ltk6dQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-arm64-msvc": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.57.1.tgz",
+      "integrity": "sha512-O54mtsV/6LW3P8qdTcamQmuC990HDfR71lo44oZMZlXU4tzLrbvTii87Ni9opq60ds0YzuAlEr/GNwuNluZyMQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-ia32-msvc": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.57.1.tgz",
+      "integrity": "sha512-P3dLS+IerxCT/7D2q2FYcRdWRl22dNbrbBEtxdWhXrfIMPP9lQhb5h4Du04mdl5Woq05jVCDPCMF7Ub0NAjIew==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-gnu": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.57.1.tgz",
+      "integrity": "sha512-VMBH2eOOaKGtIJYleXsi2B8CPVADrh+TyNxJ4mWPnKfLB/DBUmzW+5m1xUrcwWoMfSLagIRpjUFeW5CO5hyciQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-msvc": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.57.1.tgz",
+      "integrity": "sha512-mxRFDdHIWRxg3UfIIAwCm6NzvxG0jDX/wBN6KsQFTvKFqqg9vTrWUE68qEjHt19A5wwx5X5aUi2zuZT7YR0jrA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
+      "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@vitejs/plugin-vue": {
+      "version": "6.0.4",
+      "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-6.0.4.tgz",
+      "integrity": "sha512-uM5iXipgYIn13UUQCZNdWkYk+sysBeA97d5mHsAoAt1u/wpN3+zxOmsVJWosuzX+IMGRzeYUNytztrYznboIkQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@rolldown/pluginutils": "1.0.0-rc.2"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "peerDependencies": {
+        "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0",
+        "vue": "^3.2.25"
+      }
+    },
+    "node_modules/@vue/compiler-core": {
+      "version": "3.5.27",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-core/-/compiler-core-3.5.27.tgz",
+      "integrity": "sha512-gnSBQjZA+//qDZen+6a2EdHqJ68Z7uybrMf3SPjEGgG4dicklwDVmMC1AeIHxtLVPT7sn6sH1KOO+tS6gwOUeQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.28.5",
+        "@vue/shared": "3.5.27",
+        "entities": "^7.0.0",
+        "estree-walker": "^2.0.2",
+        "source-map-js": "^1.2.1"
+      }
+    },
+    "node_modules/@vue/compiler-dom": {
+      "version": "3.5.27",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-dom/-/compiler-dom-3.5.27.tgz",
+      "integrity": "sha512-oAFea8dZgCtVVVTEC7fv3T5CbZW9BxpFzGGxC79xakTr6ooeEqmRuvQydIiDAkglZEAd09LgVf1RoDnL54fu5w==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-core": "3.5.27",
+        "@vue/shared": "3.5.27"
+      }
+    },
+    "node_modules/@vue/compiler-sfc": {
+      "version": "3.5.27",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-sfc/-/compiler-sfc-3.5.27.tgz",
+      "integrity": "sha512-sHZu9QyDPeDmN/MRoshhggVOWE5WlGFStKFwu8G52swATgSny27hJRWteKDSUUzUH+wp+bmeNbhJnEAel/auUQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.28.5",
+        "@vue/compiler-core": "3.5.27",
+        "@vue/compiler-dom": "3.5.27",
+        "@vue/compiler-ssr": "3.5.27",
+        "@vue/shared": "3.5.27",
+        "estree-walker": "^2.0.2",
+        "magic-string": "^0.30.21",
+        "postcss": "^8.5.6",
+        "source-map-js": "^1.2.1"
+      }
+    },
+    "node_modules/@vue/compiler-ssr": {
+      "version": "3.5.27",
+      "resolved": "https://registry.npmjs.org/@vue/compiler-ssr/-/compiler-ssr-3.5.27.tgz",
+      "integrity": "sha512-Sj7h+JHt512fV1cTxKlYhg7qxBvack+BGncSpH+8vnN+KN95iPIcqB5rsbblX40XorP+ilO7VIKlkuu3Xq2vjw==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-dom": "3.5.27",
+        "@vue/shared": "3.5.27"
+      }
+    },
+    "node_modules/@vue/reactivity": {
+      "version": "3.5.27",
+      "resolved": "https://registry.npmjs.org/@vue/reactivity/-/reactivity-3.5.27.tgz",
+      "integrity": "sha512-vvorxn2KXfJ0nBEnj4GYshSgsyMNFnIQah/wczXlsNXt+ijhugmW+PpJ2cNPe4V6jpnBcs0MhCODKllWG+nvoQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/shared": "3.5.27"
+      }
+    },
+    "node_modules/@vue/runtime-core": {
+      "version": "3.5.27",
+      "resolved": "https://registry.npmjs.org/@vue/runtime-core/-/runtime-core-3.5.27.tgz",
+      "integrity": "sha512-fxVuX/fzgzeMPn/CLQecWeDIFNt3gQVhxM0rW02Tvp/YmZfXQgcTXlakq7IMutuZ/+Ogbn+K0oct9J3JZfyk3A==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/reactivity": "3.5.27",
+        "@vue/shared": "3.5.27"
+      }
+    },
+    "node_modules/@vue/runtime-dom": {
+      "version": "3.5.27",
+      "resolved": "https://registry.npmjs.org/@vue/runtime-dom/-/runtime-dom-3.5.27.tgz",
+      "integrity": "sha512-/QnLslQgYqSJ5aUmb5F0z0caZPGHRB8LEAQ1s81vHFM5CBfnun63rxhvE/scVb/j3TbBuoZwkJyiLCkBluMpeg==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/reactivity": "3.5.27",
+        "@vue/runtime-core": "3.5.27",
+        "@vue/shared": "3.5.27",
+        "csstype": "^3.2.3"
+      }
+    },
+    "node_modules/@vue/server-renderer": {
+      "version": "3.5.27",
+      "resolved": "https://registry.npmjs.org/@vue/server-renderer/-/server-renderer-3.5.27.tgz",
+      "integrity": "sha512-qOz/5thjeP1vAFc4+BY3Nr6wxyLhpeQgAE/8dDtKo6a6xdk+L4W46HDZgNmLOBUDEkFXV3G7pRiUqxjX0/2zWA==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-ssr": "3.5.27",
+        "@vue/shared": "3.5.27"
+      },
+      "peerDependencies": {
+        "vue": "3.5.27"
+      }
+    },
+    "node_modules/@vue/shared": {
+      "version": "3.5.27",
+      "resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.5.27.tgz",
+      "integrity": "sha512-dXr/3CgqXsJkZ0n9F3I4elY8wM9jMJpP3pvRG52r6m0tu/MsAFIe6JpXVGeNMd/D9F4hQynWT8Rfuj0bdm9kFQ==",
+      "license": "MIT"
+    },
+    "node_modules/csstype": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
+      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
+      "license": "MIT"
+    },
+    "node_modules/entities": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz",
+      "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/esbuild": {
+      "version": "0.27.3",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.3.tgz",
+      "integrity": "sha512-8VwMnyGCONIs6cWue2IdpHxHnAjzxnw2Zr7MkVxB2vjmQ2ivqGFb4LEG3SMnv0Gb2F/G/2yA8zUaiL1gywDCCg==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.27.3",
+        "@esbuild/android-arm": "0.27.3",
+        "@esbuild/android-arm64": "0.27.3",
+        "@esbuild/android-x64": "0.27.3",
+        "@esbuild/darwin-arm64": "0.27.3",
+        "@esbuild/darwin-x64": "0.27.3",
+        "@esbuild/freebsd-arm64": "0.27.3",
+        "@esbuild/freebsd-x64": "0.27.3",
+        "@esbuild/linux-arm": "0.27.3",
+        "@esbuild/linux-arm64": "0.27.3",
+        "@esbuild/linux-ia32": "0.27.3",
+        "@esbuild/linux-loong64": "0.27.3",
+        "@esbuild/linux-mips64el": "0.27.3",
+        "@esbuild/linux-ppc64": "0.27.3",
+        "@esbuild/linux-riscv64": "0.27.3",
+        "@esbuild/linux-s390x": "0.27.3",
+        "@esbuild/linux-x64": "0.27.3",
+        "@esbuild/netbsd-arm64": "0.27.3",
+        "@esbuild/netbsd-x64": "0.27.3",
+        "@esbuild/openbsd-arm64": "0.27.3",
+        "@esbuild/openbsd-x64": "0.27.3",
+        "@esbuild/openharmony-arm64": "0.27.3",
+        "@esbuild/sunos-x64": "0.27.3",
+        "@esbuild/win32-arm64": "0.27.3",
+        "@esbuild/win32-ia32": "0.27.3",
+        "@esbuild/win32-x64": "0.27.3"
+      }
+    },
+    "node_modules/estree-walker": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz",
+      "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==",
+      "license": "MIT"
+    },
+    "node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/magic-string": {
+      "version": "0.30.21",
+      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+      "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.5"
+      }
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.11",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "license": "ISC"
+    },
+    "node_modules/picomatch": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
+      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/plotly.js-dist-min": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/plotly.js-dist-min/-/plotly.js-dist-min-3.3.1.tgz",
+      "integrity": "sha512-ZxKM9DlEoEF3wBzGRPGHt6gWTJrm5N81J9AgX9UBX/Qjc9L4lRxtPBPq+RmBJWoA71j1X5Z1ouuguLkdoo88tg==",
+      "license": "MIT"
+    },
+    "node_modules/postcss": {
+      "version": "8.5.6",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz",
+      "integrity": "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==",
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "nanoid": "^3.3.11",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "4.57.1",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.57.1.tgz",
+      "integrity": "sha512-oQL6lgK3e2QZeQ7gcgIkS2YZPg5slw37hYufJ3edKlfQSGGm8ICoxswK15ntSzF/a8+h7ekRy7k7oWc3BQ7y8A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "1.0.8"
+      },
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@rollup/rollup-android-arm-eabi": "4.57.1",
+        "@rollup/rollup-android-arm64": "4.57.1",
+        "@rollup/rollup-darwin-arm64": "4.57.1",
+        "@rollup/rollup-darwin-x64": "4.57.1",
+        "@rollup/rollup-freebsd-arm64": "4.57.1",
+        "@rollup/rollup-freebsd-x64": "4.57.1",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.57.1",
+        "@rollup/rollup-linux-arm-musleabihf": "4.57.1",
+        "@rollup/rollup-linux-arm64-gnu": "4.57.1",
+        "@rollup/rollup-linux-arm64-musl": "4.57.1",
+        "@rollup/rollup-linux-loong64-gnu": "4.57.1",
+        "@rollup/rollup-linux-loong64-musl": "4.57.1",
+        "@rollup/rollup-linux-ppc64-gnu": "4.57.1",
+        "@rollup/rollup-linux-ppc64-musl": "4.57.1",
+        "@rollup/rollup-linux-riscv64-gnu": "4.57.1",
+        "@rollup/rollup-linux-riscv64-musl": "4.57.1",
+        "@rollup/rollup-linux-s390x-gnu": "4.57.1",
+        "@rollup/rollup-linux-x64-gnu": "4.57.1",
+        "@rollup/rollup-linux-x64-musl": "4.57.1",
+        "@rollup/rollup-openbsd-x64": "4.57.1",
+        "@rollup/rollup-openharmony-arm64": "4.57.1",
+        "@rollup/rollup-win32-arm64-msvc": "4.57.1",
+        "@rollup/rollup-win32-ia32-msvc": "4.57.1",
+        "@rollup/rollup-win32-x64-gnu": "4.57.1",
+        "@rollup/rollup-win32-x64-msvc": "4.57.1",
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.15",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
+      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/vite": {
+      "version": "7.3.1",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.1.tgz",
+      "integrity": "sha512-w+N7Hifpc3gRjZ63vYBXA56dvvRlNWRczTdmCBBa+CotUzAPf5b7YMdMR/8CQoeYE5LX3W4wj6RYTgonm1b9DA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "^0.27.0",
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3",
+        "postcss": "^8.5.6",
+        "rollup": "^4.43.0",
+        "tinyglobby": "^0.2.15"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^20.19.0 || >=22.12.0",
+        "jiti": ">=1.21.0",
+        "less": "^4.0.0",
+        "lightningcss": "^1.21.0",
+        "sass": "^1.70.0",
+        "sass-embedded": "^1.70.0",
+        "stylus": ">=0.54.8",
+        "sugarss": "^5.0.0",
+        "terser": "^5.16.0",
+        "tsx": "^4.8.1",
+        "yaml": "^2.4.2"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "jiti": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        },
+        "tsx": {
+          "optional": true
+        },
+        "yaml": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vue": {
+      "version": "3.5.27",
+      "resolved": "https://registry.npmjs.org/vue/-/vue-3.5.27.tgz",
+      "integrity": "sha512-aJ/UtoEyFySPBGarREmN4z6qNKpbEguYHMmXSiOGk69czc+zhs0NF6tEFrY8TZKAl8N/LYAkd4JHVd5E/AsSmw==",
+      "license": "MIT",
+      "dependencies": {
+        "@vue/compiler-dom": "3.5.27",
+        "@vue/compiler-sfc": "3.5.27",
+        "@vue/runtime-dom": "3.5.27",
+        "@vue/server-renderer": "3.5.27",
+        "@vue/shared": "3.5.27"
+      },
+      "peerDependencies": {
+        "typescript": "*"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    }
+  }
+}

src/mcp-hub/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "mcp-hub",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "plotly.js-dist-min": "^3.3.1",
+    "vue": "^3.5.24"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^6.0.1",
+    "vite": "^7.2.4"
+  }
+}

src/mcp-hub/src/App.vue

@@ -0,0 +1,348 @@
+
+<template>
+  <div id="mcp-hub">
+    <nav class="top-nav">
+      <div class="nav-brand">
+        <svg class="brand-logo" viewBox="0 0 180 180" fill="none" xmlns="http://www.w3.org/2000/svg">
+          <g clip-path="url(#clip0_19_13)">
+            <path d="M18 84.8528L85.8822 16.9706C95.2548 7.59798 110.451 7.59798 119.823 16.9706V16.9706C129.196 26.3431 129.196 41.5391 119.823 50.9117L68.5581 102.177" stroke="currentColor" stroke-width="12" stroke-linecap="round"/>
+            <path d="M69.2652 101.47L119.823 50.9117C129.196 41.5391 144.392 41.5391 153.765 50.9117L154.118 51.2652C163.491 60.6378 163.491 75.8338 154.118 85.2063L92.7248 146.6C89.6006 149.724 89.6006 154.789 92.7248 157.913L105.331 170.52" stroke="currentColor" stroke-width="12" stroke-linecap="round"/>
+            <path d="M102.853 33.9411L52.6482 84.1457C43.2756 93.5183 43.2756 108.714 52.6482 118.087V118.087C62.0208 127.459 77.2167 127.459 86.5893 118.087L136.794 67.8822" stroke="currentColor" stroke-width="12" stroke-linecap="round"/>
+          </g>
+          <defs>
+            <clipPath id="clip0_19_13"><rect width="180" height="180" fill="white"/></clipPath>
+          </defs>
+        </svg>
+        MCP<span>HUB</span>
+      </div>
+      <div class="system-stats">
+        <span class="pulse-dot"></span>
+        {{ servers.length }} SERVERS ACTIVE
+      </div>
+    </nav>
+
+    <main class="dashboard-content">
+      <div v-if="!selectedServer">
+        <div class="summary-bar">
+          <div class="summary-item">
+            <span class="label">UPTIME</span>
+            <span class="value">{{ system.uptime }}</span>
+          </div>
+          <div class="summary-item">
+            <span class="label">THROUGHPUT</span>
+            <span class="value">{{ system.throughput }}</span>
+          </div>
+          <div class="summary-item">
+            <span class="label">LATENCY</span>
+            <span class="value">{{ system.latency }}</span>
+          </div>
+        </div>
+
+        <section class="trend-section">
+          <div class="trend-header">
+             <div class="v-header">USAGE TRENDS</div>
+             <div class="range-selector">
+                <button v-for="r in ranges" :key="r" :class="{ active: selectedRange === r }" @click="setRange(r)">{{ r.toUpperCase() }}</button>
+             </div>
+          </div>
+          <!-- ... (SVG remains same) ... -->
+          <div class="trend-container">
+            <div class="y-axis">
+               <span v-for="tick in yTicks" :key="tick">{{ tick }}</span>
+            </div>
+            <div class="trend-chart">
+               <svg viewBox="0 0 1000 120" class="sparkline" @mousemove="handleHover" @mouseleave="hoverInfo = null">
+                  <line v-for="tick in [0, 33, 66, 100]" :key="tick" x1="0" :y1="110 - tick" x2="1000" :y2="110 - tick" stroke="var(--border)" stroke-width="1" stroke-dasharray="4,4" />
+                  <path v-for="chart in getCharts" :key="chart.name" :d="chart.path" fill="none" :stroke="chart.color" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="trend-path" />
+                  <line v-if="hoverInfo" :x1="hoverInfo.x" y1="0" :x2="hoverInfo.x" y2="120" stroke="var(--accent)" stroke-width="1" stroke-dasharray="2,2" />
+               </svg>
+
+               <div v-if="hoverInfo" class="chart-tooltip" :style="{ left: (hoverInfo.x / 10) + '%' }">
+                  <div class="tooltip-header">{{ hoverInfo.label }}</div>
+                  <div class="tooltip-body">
+                     <div v-for="entry in hoverInfo.entries" :key="entry.name" class="tooltip-row" v-show="entry.val > 0">
+                        <span class="dot" :style="{ background: entry.color }"></span>
+                        <span class="name">{{ entry.name }}</span>
+                        <span class="val">{{ entry.val }}</span>
+                     </div>
+                  </div>
+               </div>
+               
+               <div class="chart-labels">
+                  <span v-for="(l, i) in visibleXLabels" :key="i">{{ l }}</span>
+               </div>
+            </div>
+          </div>
+        </section>
+
+        <div class="server-list">
+          <div v-for="server in servers" :key="server.id" class="server-row" @click="viewServer(server.id)">
+            <div class="row-status">
+              <span :class="['status-indicator', getStatusStatus(server.status)]"></span>
+            </div>
+            <div class="row-info">
+              <div class="row-header">
+                <span class="server-id">{{ server.id.toUpperCase() }}</span>
+                <span class="server-name">{{ server.name }}</span>
+              </div>
+              <div class="server-desc">{{ server.description }}</div>
+            </div>
+            <div class="row-metrics">
+              <div class="metric">
+                <span class="m-val">{{ server.metrics.hourly }}</span>
+                <span class="m-lab">1H</span>
+              </div>
+              <div class="metric">
+                <span class="m-val">{{ server.metrics.weekly }}</span>
+                <span class="m-lab">7D</span>
+              </div>
+              <div class="metric">
+                <span class="m-val">{{ server.metrics.monthly }}</span>
+                <span class="m-lab">30D</span>
+              </div>
+            </div>
+            <div class="row-stage">
+               <span :class="['stage-badge', getStatusClass(server.status)]">{{ server.status }}</span>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <!-- Detail Deep Dive -->
+      <div v-else class="detail-view">
+        <header class="detail-header">
+          <button @click="closeServer" class="back-btn">&larr; BACK TO OVERVIEW</button>
+          <div class="detail-title">
+            <span class="id-tag">{{ selectedServer.id.toUpperCase() }}</span>
+            <h1>{{ selectedServer.name }}</h1>
+          </div>
+          <div class="detail-actions">
+            <div class="status-indicator-pill">
+              <span class="pulse-dot"></span> INTEGRATED LOG STREAM
+            </div>
+          </div>
+        </header>
+
+        <div class="detail-grid">
+          <section class="doc-section">
+            <div class="v-header">DETAILS</div>
+            <p class="markdown-text">{{ selectedServer.description }}</p>
+            
+            <div class="v-header" style="margin-top: 2rem;">TOOLS</div>
+            <ul class="tool-list">
+              <li v-for="tool in selectedServer.tools" :key="tool">
+                <code>{{ tool }}</code>
+              </li>
+            </ul>
+          </section>
+
+          <section class="code-section">
+            <div class="v-header">USAGE EXAMPLE (PYTHON)</div>
+            <div class="code-container">
+              <pre><code>{{ selectedServer.sample_code }}</code></pre>
+            </div>
+            
+            <div class="v-header" style="margin-top: 2rem;">LIVE SYSTEM LOGS</div>
+            <div class="log-terminal">
+              <pre><code>{{ currentLogs }}</code></pre>
+            </div>
+          </section>
+        </div>
+      </div>
+    </main>
+  </div>
+</template>
+
+<script setup>
+import { onMounted, ref, computed } from 'vue'
+
+const servers = ref([])
+const system = ref({ uptime: '99.9%', throughput: '0/hr', latency: '0ms' })
+const usageData = ref({ labels: [], datasets: [] })
+const selectedServer = ref(null)
+const currentLogs = ref('Initializing terminal...')
+const selectedRange = ref('24h')
+const ranges = ['1h', '24h', '7d', '30d']
+const hoverInfo = ref(null)
+let logTimer = null
+
+const colors = ['#3b82f6', '#10b981', '#f59e0b', '#ef4444', '#8b5cf6', '#ec4899', '#06b6d4', '#4ade80']
+
+const viewServer = async (id) => {
+  try {
+    const res = await fetch(`/api/servers/${id}`)
+    selectedServer.value = await res.json()
+    window.scrollTo({ top: 0, behavior: 'smooth' })
+    fetchLogs(id)
+    logTimer = setInterval(() => fetchLogs(id), 5000)
+  } catch (e) {
+    console.error("Link Desync", e)
+  }
+}
+
+const closeServer = () => {
+  selectedServer.value = null
+  if (logTimer) clearInterval(logTimer)
+  currentLogs.value = 'Initializing terminal...'
+}
+
+const fetchLogs = async (id) => {
+  try {
+    const res = await fetch(`/api/servers/${id}/logs`)
+    const data = await res.json()
+    currentLogs.value = data.logs || 'No active log feed.'
+  } catch (e) {
+    currentLogs.value = 'Neural link disrupted. Retrying...'
+  }
+}
+
+const setRange = (r) => {
+  selectedRange.value = r
+  fetchUsage()
+}
+
+const fetchUsage = async () => {
+  try {
+    const res = await fetch(`/api/usage?range=${selectedRange.value}`)
+    usageData.value = await res.json()
+  } catch (e) {
+    console.error("Usage Desync", e)
+  }
+}
+
+const maxUsage = computed(() => {
+  if (!usageData.value.datasets.length) return 1
+  return Math.max(...usageData.value.datasets.flatMap(ds => ds.data), 1)
+})
+
+const yTicks = computed(() => {
+  const max = maxUsage.value
+  return [max, Math.floor(max * 0.66), Math.floor(max * 0.33), 0]
+})
+
+const visibleXLabels = computed(() => {
+  const labels = usageData.value.labels
+  if (!labels.length) return []
+  
+  // Target max 6 labels to prevent overcrowding
+  const len = labels.length
+  if (len <= 6) return labels
+  
+  // Calculate a step that gives us roughly 6 ticks
+  // e.g. 24 items -> step 4 -> 6 items
+  const step = Math.ceil((len - 1) / 5)
+  
+  return labels.map((l, i) => {
+    // Audit: Always show first and last. Show others if they match step.
+    if (i === 0 || i === len - 1 || i % step === 0) return l
+    return '' // Empty filtered label preserves flex spacing
+  })
+})
+
+const getCharts = computed(() => {
+  const labels = usageData.value.labels
+  const datasets = usageData.value.datasets
+  if (!labels.length || !datasets.length) return []
+
+  const step = 1000 / (labels.length - 1)
+  const max = maxUsage.value
+
+  return datasets.map((ds, idx) => {
+    const points = ds.data.map((v, i) => ({
+      x: i * step,
+      y: 110 - (v / max) * 100,
+      val: v,
+      label: labels[i]
+    }))
+    
+    const d = points.map((p, i) => `${i === 0 ? 'M' : 'L'} ${p.x} ${p.y}`).join(' ')
+    return {
+      name: ds.name,
+      color: colors[idx % colors.length],
+      path: d,
+      points
+    }
+  })
+})
+
+const handleHover = (event) => {
+  const svg = event.currentTarget
+  const rect = svg.getBoundingClientRect()
+  const x = ((event.clientX - rect.left) / rect.width) * 1000
+  
+  const labels = usageData.value.labels
+  if (!labels.length) return
+  const step = 1000 / (labels.length - 1)
+  const idx = Math.round(x / step)
+  
+  if (idx >= 0 && idx < labels.length) {
+    const entries = usageData.value.datasets.map((ds, i) => ({
+      name: ds.name,
+      val: ds.data[idx],
+      color: colors[i % colors.length]
+    })).sort((a,b) => b.val - a.val)
+    
+    hoverInfo.value = {
+      x: idx * step,
+      label: labels[idx],
+      entries
+    }
+  }
+}
+
+const sortedByUsage = computed(() => {
+  return [...servers.value].sort((a, b) => (b.metrics.raw_monthly || 0) - (a.metrics.raw_monthly || 0)).slice(0, 5)
+})
+
+const getStatusClass = (status) => {
+  if (!status) return 'stage-offline'
+  const s = status.toLowerCase()
+  if (s.includes('running')) return 'stage-online'
+  if (s.includes('sleeping') || s.includes('building')) return 'stage-warning'
+  return 'stage-offline'
+}
+
+const getStatusStatus = (status) => {
+  if (!status) return 's-offline'
+  const s = status.toLowerCase()
+  if (s.includes('running')) return 's-online'
+  if (s.includes('sleeping') || s.includes('building')) return 's-warning'
+  return 's-offline'
+}
+
+const fetchData = async () => {
+  try {
+    const res = await fetch('/api/servers')
+    const data = await res.json()
+    servers.value = data.servers
+    system.value = data.system
+  } catch (e) {
+    console.error("Link Desync", e)
+  }
+}
+
+onMounted(() => {
+  fetchData()
+  fetchUsage()
+  setInterval(() => {
+    fetchData()
+    fetchUsage()
+  }, 15000)
+})
+</script>
+
+<style>
+/* App specific overrides */
+#mcp-hub {
+  width: 100%;
+  max-width: 1000px;
+  margin: 0 auto;
+}
+
+.brand-logo {
+  height: 28px;
+  width: 28px;
+  margin-right: 12px;
+  color: var(--accent);
+}
+</style>

src/mcp-hub/src/components/HelloWorld.vue

@@ -0,0 +1,43 @@
+<script setup>
+import { ref } from 'vue'
+
+defineProps({
+  msg: String,
+})
+
+const count = ref(0)
+</script>
+
+<template>
+  <h1>{{ msg }}</h1>
+
+  <div class="card">
+    <button type="button" @click="count++">count is {{ count }}</button>
+    <p>
+      Edit
+      <code>components/HelloWorld.vue</code> to test HMR
+    </p>
+  </div>
+
+  <p>
+    Check out
+    <a href="https://vuejs.org/guide/quick-start.html#local" target="_blank"
+      >create-vue</a
+    >, the official Vue + Vite starter
+  </p>
+  <p>
+    Learn more about IDE Support for Vue in the
+    <a
+      href="https://vuejs.org/guide/scaling-up/tooling.html#ide-support"
+      target="_blank"
+      >Vue Docs Scaling up Guide</a
+    >.
+  </p>
+  <p class="read-the-docs">Click on the Vite and Vue logos to learn more</p>
+</template>
+
+<style scoped>
+.read-the-docs {
+  color: #888;
+}
+</style>

src/mcp-hub/src/main.js

@@ -0,0 +1,5 @@
+import { createApp } from 'vue'
+import './style.css'
+import App from './App.vue'
+
+createApp(App).mount('#app')

src/mcp-hub/src/style.css

@@ -0,0 +1,680 @@
+@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@400;600;800&family=Inter:wght@400;500;700&display=swap');
+
+:root {
+  --bg-dark: #0a0908;
+  --bg-card: #1a1816;
+  --border: #2d2a26;
+  --accent: #cd7f32;
+  /* Copper */
+  --text-primary: #f5f2f0;
+  --text-dim: #a8a098;
+  --success: #10b981;
+  --warning: #f59e0b;
+  --error: #ef4444;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  background-color: var(--bg-dark);
+  color: var(--text-primary);
+  font-family: 'Inter', sans-serif;
+  margin: 0;
+  padding: 0;
+  -webkit-font-smoothing: antialiased;
+}
+
+/* Base Mobile Styles */
+.top-nav {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.75rem 1.25rem;
+  background: var(--bg-card);
+  border-bottom: 1px solid var(--border);
+  position: sticky;
+  top: 0;
+  z-index: 1000;
+}
+
+.nav-brand {
+  font-family: 'Outfit', sans-serif;
+  font-weight: 800;
+  font-size: 1.1rem;
+  letter-spacing: -0.5px;
+}
+
+.nav-brand span {
+  color: var(--accent);
+}
+
+.system-stats {
+  font-size: 0.65rem;
+  font-weight: 700;
+  color: var(--text-dim);
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+}
+
+.pulse-dot {
+  width: 5px;
+  height: 5px;
+  background: var(--accent);
+  border-radius: 50%;
+  box-shadow: 0 0 6px var(--accent);
+  animation: pulse 2s infinite;
+}
+
+@keyframes pulse {
+  0% {
+    opacity: 1;
+    transform: scale(1);
+  }
+
+  50% {
+    opacity: 0.4;
+    transform: scale(1.2);
+  }
+
+  100% {
+    opacity: 1;
+    transform: scale(1);
+  }
+}
+
+.dashboard-content {
+  padding: 1rem;
+  max-width: 1200px;
+  margin: 0 auto;
+}
+
+.summary-bar {
+  display: grid;
+  grid-template-columns: repeat(2, 1fr);
+  gap: 1rem;
+  margin-bottom: 1.5rem;
+  background: var(--bg-card);
+  padding: 1rem;
+  border-radius: 12px;
+  border: 1px solid var(--border);
+}
+
+.summary-item:last-child {
+  grid-column: span 2;
+  border-top: 1px solid var(--border);
+  padding-top: 0.75rem;
+  text-align: center;
+}
+
+.summary-item .label {
+  font-size: 0.6rem;
+  font-weight: 700;
+  color: var(--text-dim);
+  letter-spacing: 0.5px;
+}
+
+.summary-item .value {
+  font-size: 1rem;
+  font-weight: 700;
+  color: #fff;
+}
+
+/* Trend Visualizer - Mobile First */
+.trend-section {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: 12px;
+  padding: 1rem;
+  margin-bottom: 1.5rem;
+}
+
+.trend-header {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  margin-bottom: 1rem;
+}
+
+.v-header {
+  font-family: 'Outfit', sans-serif;
+  font-size: 0.65rem;
+  font-weight: 800;
+  color: var(--text-dim);
+  letter-spacing: 1px;
+}
+
+.range-selector {
+  display: flex;
+  background: var(--bg-dark);
+  padding: 2px;
+  border-radius: 6px;
+  overflow-x: auto;
+}
+
+.range-selector button {
+  flex: 1;
+  background: transparent;
+  border: none;
+  color: var(--text-dim);
+  font-size: 0.6rem;
+  font-weight: 700;
+  padding: 6px 4px;
+  border-radius: 4px;
+  cursor: pointer;
+}
+
+.range-selector button.active {
+  background: var(--accent);
+  color: #fff;
+}
+
+.trend-container {
+  display: flex;
+  flex-direction: column;
+}
+
+.y-axis {
+  display: none;
+}
+
+/* Hide Y-axis on narrow screens to save space */
+
+.trend-chart {
+  position: relative;
+  height: 120px;
+}
+
+.sparkline {
+  width: 100%;
+  height: 100px;
+  cursor: crosshair;
+}
+
+.chart-labels {
+  display: flex;
+  justify-content: space-between;
+  margin-top: 0.25rem;
+  font-size: 0.5rem;
+  font-weight: 600;
+  color: var(--text-dim);
+}
+
+.chart-labels span:nth-child(even) {
+  display: none;
+}
+
+/* Show fewer labels on mobile */
+
+.chart-tooltip {
+  position: absolute;
+  top: -10px;
+  transform: translateX(-50%);
+  background: rgba(9, 9, 11, 0.98);
+  border: 1px solid var(--accent);
+  border-radius: 6px;
+  padding: 0.5rem;
+  z-index: 100;
+  pointer-events: none;
+  min-width: 120px;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.5);
+}
+
+.tooltip-header {
+  font-size: 0.55rem;
+  color: var(--text-dim);
+  margin-bottom: 0.25rem;
+}
+
+.tooltip-row {
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  margin-bottom: 0.15rem;
+}
+
+.tooltip-row .name {
+  font-size: 0.6rem;
+  flex: 1;
+  color: var(--text-primary);
+}
+
+.tooltip-row .val {
+  font-size: 0.65rem;
+  font-weight: 700;
+  color: #fff;
+}
+
+/* Server List - Mobile First Cards */
+.server-list {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.server-row {
+  display: flex;
+  flex-direction: column;
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: 12px;
+  padding: 1.25rem;
+  gap: 1rem;
+}
+
+.row-status {
+  display: none;
+}
+
+/* Status indicator logic handled by badge */
+
+.row-info {
+  border-bottom: 1px solid var(--border);
+  padding-bottom: 0.75rem;
+}
+
+.row-header {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+}
+
+.server-id {
+  font-family: 'Outfit', sans-serif;
+  font-size: 0.65rem;
+  color: var(--accent);
+}
+
+.server-name {
+  font-weight: 700;
+  font-size: 1rem;
+  color: #fff;
+}
+
+.server-desc {
+  font-size: 0.75rem;
+  color: var(--text-dim);
+  margin-top: 0.4rem;
+}
+
+.row-metrics {
+  display: flex;
+  justify-content: space-between;
+  background: var(--bg-dark);
+  padding: 0.75rem;
+  border-radius: 8px;
+}
+
+.metric {
+  flex: 1;
+  text-align: center;
+}
+
+.m-val {
+  display: block;
+  font-size: 0.85rem;
+  font-weight: 700;
+  color: #fff;
+}
+
+.m-lab {
+  display: block;
+  font-size: 0.55rem;
+  font-weight: 600;
+  color: var(--text-dim);
+}
+
+.row-stage {
+  text-align: right;
+}
+
+.stage-badge {
+  display: inline-block;
+  font-size: 0.6rem;
+  font-weight: 800;
+  padding: 4px 10px;
+  border-radius: 4px;
+  text-transform: uppercase;
+}
+
+.stage-online {
+  background: rgba(16, 185, 129, 0.1);
+  color: var(--success);
+  border: 1px solid var(--success);
+}
+
+.stage-warning {
+  background: rgba(245, 158, 11, 0.1);
+  color: var(--warning);
+  border: 1px solid var(--warning);
+}
+
+.stage-offline {
+  background: rgba(239, 68, 68, 0.1);
+  color: var(--error);
+  border: 1px solid var(--error);
+}
+
+/* Desktop Overrides */
+@media (min-width: 768px) {
+  .dashboard-content {
+    padding: 2rem;
+  }
+
+  .summary-bar {
+    grid-template-columns: repeat(3, 1fr);
+    padding: 1.25rem 2rem;
+    gap: 2rem;
+  }
+
+  .summary-item:last-child {
+    grid-column: auto;
+    border-top: none;
+    padding-top: 0;
+    text-align: left;
+  }
+
+  .summary-item .value {
+    font-size: 1.25rem;
+  }
+
+  .trend-section {
+    padding: 1.5rem 2rem;
+  }
+
+  .trend-header {
+    flex-direction: row;
+    justify-content: space-between;
+    align-items: center;
+  }
+
+  .range-selector {
+    padding: 2px;
+  }
+
+  .range-selector button {
+    font-size: 0.65rem;
+    padding: 4px 12px;
+  }
+
+  .trend-container {
+    flex-direction: row;
+    gap: 1rem;
+  }
+
+  .y-axis {
+    display: flex;
+    flex-direction: column;
+    justify-content: space-between;
+    padding-bottom: 20px;
+    font-size: 0.6rem;
+    font-weight: 700;
+    color: var(--text-dim);
+    min-width: 30px;
+    text-align: right;
+  }
+
+  .trend-chart {
+    height: 160px;
+  }
+
+  .sparkline {
+    height: 140px;
+  }
+
+  .chart-labels span:nth-child(even) {
+    display: inline;
+  }
+
+  .chart-labels {
+    font-size: 0.6rem;
+  }
+
+  .server-row {
+    flex-direction: row;
+    align-items: center;
+    padding: 1rem 1.5rem;
+    display: grid;
+    grid-template-columns: 1fr 200px 140px;
+    gap: 2rem;
+  }
+
+  .row-info {
+    border-bottom: none;
+    padding-bottom: 0;
+  }
+
+  .server-desc {
+    max-width: 400px;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+
+  .row-metrics {
+    background: transparent;
+    padding: 0;
+    gap: 1.5rem;
+  }
+
+  .m-val {
+    font-size: 0.9rem;
+  }
+
+  .server-row:hover {
+    border-color: var(--accent);
+    box-shadow: 0 4px 24px rgba(0, 0, 0, 0.4);
+    transform: translateY(-2px);
+  }
+
+  .trend-path {
+    stroke-width: 2px;
+  }
+
+  .sparkline:hover .trend-path {
+    opacity: 0.2;
+  }
+
+  .sparkline:hover .trend-path:hover {
+    opacity: 1;
+    stroke-width: 3px;
+  }
+}
+
+/* Detail Deep Dive */
+.detail-view {
+  animation: fadeIn 0.4s ease;
+}
+
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(10px);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+.detail-header {
+  display: flex;
+  flex-direction: column;
+  gap: 1.5rem;
+  margin-bottom: 2rem;
+  padding-bottom: 2rem;
+  border-bottom: 1px solid var(--border);
+}
+
+.back-btn {
+  background: transparent;
+  border: 1px solid var(--border);
+  color: var(--text-dim);
+  font-size: 0.65rem;
+  font-weight: 800;
+  padding: 6px 12px;
+  border-radius: 4px;
+  cursor: pointer;
+  width: fit-content;
+  transition: all 0.2s;
+}
+
+.back-btn:hover {
+  border-color: var(--accent);
+  color: #fff;
+}
+
+.detail-title h1 {
+  font-family: 'Outfit', sans-serif;
+  font-size: 1.75rem;
+  margin: 0.5rem 0 0 0;
+  letter-spacing: -0.5px;
+}
+
+.id-tag {
+  font-family: 'Outfit', sans-serif;
+  font-size: 0.7rem;
+  font-weight: 800;
+  color: var(--accent);
+  letter-spacing: 1px;
+}
+
+.logs-link {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.75rem;
+  background: rgba(59, 130, 246, 0.1);
+  border: 1px solid var(--accent);
+  color: var(--accent);
+  padding: 0.75rem 1.25rem;
+  border-radius: 8px;
+  text-decoration: none;
+  font-size: 0.7rem;
+  font-weight: 800;
+  transition: all 0.2s;
+}
+
+.logs-link:hover {
+  background: var(--accent);
+  color: #fff;
+}
+
+.detail-grid {
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: 2.5rem;
+}
+
+.markdown-text {
+  font-size: 0.95rem;
+  line-height: 1.6;
+  color: var(--text-dim);
+  margin-top: 1rem;
+}
+
+.tool-list {
+  list-style: none;
+  padding: 0;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.75rem;
+  margin-top: 1rem;
+}
+
+.tool-list code {
+  background: var(--bg-dark);
+  border: 1px solid var(--border);
+  color: var(--success);
+  padding: 4px 10px;
+  border-radius: 4px;
+  font-size: 0.75rem;
+  font-weight: 600;
+}
+
+.code-container {
+  background: #0d0d0f;
+  border: 1px solid var(--border);
+  border-radius: 12px;
+  padding: 1.25rem;
+  margin-top: 1rem;
+  overflow-x: auto;
+}
+
+.code-container code {
+  font-family: 'JetBrains Mono', 'Fira Code', monospace;
+  font-size: 0.8rem;
+  color: #9cdcfe;
+  line-height: 1.5;
+}
+
+.endpoint-badge {
+  background: var(--bg-dark);
+  border: 1px solid var(--border);
+  color: var(--text-dim);
+  padding: 0.75rem;
+  border-radius: 8px;
+  font-family: monospace;
+  font-size: 0.75rem;
+  margin-top: 1rem;
+}
+
+@media (min-width: 768px) {
+  .detail-header {
+    flex-direction: row;
+    align-items: flex-end;
+    justify-content: space-between;
+  }
+
+  .detail-grid {
+    grid-template-columns: 1fr 1fr;
+  }
+
+  .detail-title h1 {
+    font-size: 2.25rem;
+  }
+}
+
+.status-indicator-pill {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  background: rgba(205, 127, 50, 0.1);
+  border: 1px solid var(--accent);
+  color: var(--accent);
+  padding: 0.4rem 1rem;
+  border-radius: 64px;
+  font-size: 0.6rem;
+  font-weight: 800;
+  letter-spacing: 0.5px;
+}
+
+.log-terminal {
+  background: #050505;
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  padding: 1rem;
+  margin-top: 1rem;
+  height: 200px;
+  overflow-y: auto;
+  font-family: 'JetBrains Mono', 'Fira Code', monospace;
+  font-size: 0.75rem;
+  color: #00ff41;
+  /* Classic Terminal Green */
+  line-height: 1.4;
+  box-shadow: inset 0 0 10px rgba(0, 0, 0, 0.8);
+}
+
+.log-terminal pre {
+  margin: 0;
+  white-space: pre-wrap;
+  word-break: break-all;
+}
+
+@media (min-width: 768px) {
+  .log-terminal {
+    height: 300px;
+  }
+}

src/mcp-hub/vite.config.js

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+
+// https://vite.dev/config/
+export default defineConfig({
+  plugins: [vue()],
+})

src/mcp-rag-secure/Dockerfile

@@ -0,0 +1,25 @@
+
+FROM python:3.12-slim
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY pyproject.toml .
+RUN pip install --no-cache-dir .
+
+COPY src/mcp-rag-secure ./src/mcp-rag-secure
+COPY src/core ./src/core
+
+ENV PYTHONPATH=/app/src
+
+# Create directory for ChromaDB
+RUN mkdir -p src/mcp-rag-secure/chroma_db && chmod 777 src/mcp-rag-secure/chroma_db
+
+EXPOSE 7860
+
+ENV MCP_TRANSPORT=sse
+
+CMD ["python", "src/mcp-rag-secure/server.py"]

src/mcp-rag-secure/README.md

@@ -0,0 +1,27 @@
+
+---
+title: MCP Secure RAG
+emoji: 🔒
+colorFrom: pink
+colorTo: red
+sdk: docker
+pinned: false
+---
+
+# MCP Secure Multi-Tenant RAG Server
+
+This is a Model Context Protocol (MCP) server for secure, tenant-isolated Retrieval-Augmented Generation.
+
+## Tools
+- `ingest_document`: Add documents with strict tenant ID metadata.
+- `query_knowledge_base`: Query documents filtered by tenant ID.
+- `delete_tenant_data`: Wipe data for a specific tenant.
+
+## Security
+- Uses ChromaDB for vector storage.
+- All operations require a `tenant_id` to ensure data isolation.
+
+## Running Locally
+```bash
+python src/mcp-rag-secure/server.py
+```

src/mcp-rag-secure/server.py

@@ -0,0 +1,108 @@
+
+"""
+Secure Multi-Tenant RAG MCP Server
+"""
+import sys
+import os
+import uuid
+import chromadb
+from chromadb.config import Settings
+from chromadb.utils import embedding_functions
+from mcp.server.fastmcp import FastMCP
+from typing import List, Dict, Any, Optional
+from core.mcp_telemetry import log_usage
+
+# Initialize FastMCP Server
+mcp = FastMCP("Secure RAG", host="0.0.0.0")
+
+# Initialize ChromaDB (Persistent)
+# Store in src/mcp-rag-secure/chroma_db
+current_dir = os.path.dirname(os.path.abspath(__file__))
+persist_directory = os.path.join(current_dir, "chroma_db")
+
+client = chromadb.PersistentClient(path=persist_directory)
+
+# Use default embedding function (all-MiniLM-L6-v2 usually)
+# Explicitly use SentenceTransformer if installed, else default
+try:
+    from sentence_transformers import SentenceTransformer
+    # Custom embedding function wrapper
+    class SentenceTransformerEmbeddingFunction(embedding_functions.EmbeddingFunction):
+        def __init__(self, model_name="all-MiniLM-L6-v2"):
+            self.model = SentenceTransformer(model_name)
+        def __call__(self, input: List[str]) -> List[List[float]]:
+            return self.model.encode(input).tolist()
+            
+    emb_fn = SentenceTransformerEmbeddingFunction()
+except ImportError:
+    emb_fn = embedding_functions.DefaultEmbeddingFunction()
+
+# Create collection
+collection = client.get_or_create_collection(
+    name="secure_rag",
+    embedding_function=emb_fn
+)
+
+@mcp.tool()
+def ingest_document(tenant_id: str, content: str, metadata: Dict[str, Any] = None) -> str:
+    """
+    Ingest a document into the RAG system with strict tenant isolation.
+    """
+    log_usage("mcp-rag-secure", "ingest_document")
+    if not metadata:
+        metadata = {}
+    
+    # Enforce tenant_id in metadata
+    metadata["tenant_id"] = tenant_id
+    
+    doc_id = str(uuid.uuid4())
+    
+    collection.add(
+        documents=[content],
+        metadatas=[metadata],
+        ids=[doc_id]
+    )
+    return f"Document ingested with ID: {doc_id}"
+
+@mcp.tool()
+def query_knowledge_base(tenant_id: str, query: str, k: int = 3) -> List[Dict[str, Any]]:
+    """
+    Query the knowledge base. Results are strictly filtered by tenant_id.
+    """
+    log_usage("mcp-rag-secure", "query_knowledge_base")
+    results = collection.query(
+        query_texts=[query],
+        n_results=k,
+        where={"tenant_id": tenant_id} # Critical security filter
+    )
+    
+    formatted_results = []
+    if results["documents"]:
+        for i, doc in enumerate(results["documents"][0]):
+            meta = results["metadatas"][0][i]
+            formatted_results.append({
+                "content": doc,
+                "metadata": meta,
+                "score": results["distances"][0][i] if results["distances"] else None
+            })
+            
+    return formatted_results
+
+@mcp.tool()
+def delete_tenant_data(tenant_id: str) -> str:
+    """
+    Delete all data associated with a specific tenant.
+    """
+    collection.delete(
+        where={"tenant_id": tenant_id}
+    )
+    return f"All data for tenant {tenant_id} has been deleted."
+
+if __name__ == "__main__":
+    import os
+    if os.environ.get("MCP_TRANSPORT") == "sse":
+        import uvicorn
+        port = int(os.environ.get("PORT", 7860))
+        uvicorn.run(mcp.sse_app(), host="0.0.0.0", port=port)
+    else:
+        mcp.run()

src/mcp-seo/Dockerfile

@@ -0,0 +1,22 @@
+
+FROM python:3.12-slim
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY pyproject.toml .
+RUN pip install --no-cache-dir .
+
+COPY src/mcp-seo ./src/mcp-seo
+COPY src/core ./src/core
+
+ENV PYTHONPATH=/app/src
+
+EXPOSE 7860
+
+ENV MCP_TRANSPORT=sse
+
+CMD ["python", "src/mcp-seo/server.py"]

src/mcp-seo/README.md

@@ -0,0 +1,23 @@
+
+---
+title: MCP SEO & ADA
+emoji: 🔍
+colorFrom: purple
+colorTo: pink
+sdk: docker
+pinned: false
+---
+
+# MCP SEO & ADA Audit Server
+
+This is a Model Context Protocol (MCP) server for website auditing, focusing on SEO and ADA/WCAG compliance.
+
+## Tools
+- `analyze_seo`: Basic SEO audit (Title, Meta, H1, Alt tags).
+- `analyze_ada`: Accessibility compliance check (ARIA, lang, contrast proxies).
+- `generate_sitemap`: Crawl and generate a list of internal links.
+
+## Running Locally
+```bash
+python src/mcp-seo/server.py
+```

src/mcp-seo/server.py

@@ -0,0 +1,158 @@
+
+"""
+SEO & ADA Compliance MCP Server
+"""
+import sys
+import os
+import requests
+from bs4 import BeautifulSoup
+from urllib.parse import urljoin, urlparse
+from mcp.server.fastmcp import FastMCP
+from typing import List, Dict, Any, Set
+from core.mcp_telemetry import log_usage
+
+# Initialize FastMCP Server
+mcp = FastMCP("SEO & ADA Audit", host="0.0.0.0")
+
+@mcp.tool()
+def analyze_seo(url: str) -> Dict[str, Any]:
+    """
+    Perform a basic SEO audit of a webpage.
+    Checks title, meta description, H1 tags, image alt attributes, and internal/external links.
+    """
+    log_usage("mcp-seo", "analyze_seo")
+    try:
+        response = requests.get(url, timeout=10)
+        soup = BeautifulSoup(response.content, 'html.parser')
+        
+        result = {
+            "url": url,
+            "status_code": response.status_code,
+            "title": soup.title.string if soup.title else None,
+            "meta_description": None,
+            "h1_count": len(soup.find_all('h1')),
+            "images_missing_alt": 0,
+            "internal_links": 0,
+            "external_links": 0
+        }
+        
+        # Meta Description
+        meta_desc = soup.find('meta', attrs={'name': 'description'})
+        if meta_desc:
+            result["meta_description"] = meta_desc.get('content')
+            
+        # Images
+        imgs = soup.find_all('img')
+        for img in imgs:
+            if not img.get('alt'):
+                result["images_missing_alt"] += 1
+                
+        # Links
+        links = soup.find_all('a', href=True)
+        domain = urlparse(url).netloc
+        for link in links:
+            href = link['href']
+            if href.startswith('/') or domain in href:
+                result["internal_links"] += 1
+            else:
+                result["external_links"] += 1
+                
+        return result
+    except Exception as e:
+        return {"error": str(e)}
+
+@mcp.tool()
+def analyze_ada(url: str) -> Dict[str, Any]:
+    """
+    Perform a basic ADA/WCAG accessibility check.
+    Checks for missing alt text, form labels, lang attribute, and ARIA usage.
+    """
+    log_usage("mcp-seo", "analyze_ada")
+    try:
+        response = requests.get(url, timeout=10)
+        soup = BeautifulSoup(response.content, 'html.parser')
+        
+        issues = []
+        
+        # 1. Images missing alt
+        imgs = soup.find_all('img')
+        missing_alt = [img.get('src', 'unknown') for img in imgs if not img.get('alt')]
+        if missing_alt:
+            issues.append(f"Found {len(missing_alt)} images missing alt text.")
+            
+        # 2. Html Lang attribute
+        html_tag = soup.find('html')
+        if not html_tag or not html_tag.get('lang'):
+            issues.append("Missing 'lang' attribute on <html> tag.")
+            
+        # 3. Form input labels
+        inputs = soup.find_all('input')
+        for inp in inputs:
+            # Check if input has id and a corresponding label
+            inp_id = inp.get('id')
+            label = soup.find('label', attrs={'for': inp_id}) if inp_id else None
+            # Or parent is label
+            parent_label = inp.find_parent('label')
+            # Or aria-label
+            aria_label = inp.get('aria-label')
+            
+            if not (label or parent_label or aria_label):
+                issues.append(f"Input field (type={inp.get('type')}) missing label.")
+                
+        return {
+            "url": url,
+            "compliance_score": max(0, 100 - (len(issues) * 10)), # Rough score
+            "issues": issues
+        }
+    except Exception as e:
+        return {"error": str(e)}
+
+@mcp.tool()
+def generate_sitemap(url: str, max_depth: int = 1) -> List[str]:
+    """
+    Crawl the website to generate a simple list of internal URLs (sitemap).
+    """
+    log_usage("mcp-seo", "generate_sitemap")
+    visited = set()
+    to_visit = [(url, 0)]
+    domain = urlparse(url).netloc
+    
+    try:
+        while to_visit:
+            current_url, depth = to_visit.pop(0)
+            if current_url in visited or depth > max_depth:
+                continue
+                
+            visited.add(current_url)
+            
+            try:
+                response = requests.get(current_url, timeout=5)
+                if response.status_code != 200:
+                    continue
+                    
+                soup = BeautifulSoup(response.content, 'html.parser')
+                links = soup.find_all('a', href=True)
+                
+                for link in links:
+                    href = link['href']
+                    full_url = urljoin(current_url, href)
+                    parsed = urlparse(full_url)
+                    
+                    if parsed.netloc == domain and full_url not in visited:
+                        # Only add html pages usually, but for simplicity we add all internal
+                        to_visit.append((full_url, depth + 1))
+            except Exception:
+                continue
+                
+        return sorted(list(visited))
+    except Exception as e:
+        return [f"Error: {str(e)}"]
+
+if __name__ == "__main__":
+    import os
+    if os.environ.get("MCP_TRANSPORT") == "sse":
+        import uvicorn
+        port = int(os.environ.get("PORT", 7860))
+        uvicorn.run(mcp.sse_app(), host="0.0.0.0", port=port)
+    else:
+        mcp.run()

src/mcp-trader/Dockerfile

@@ -0,0 +1,33 @@
+
+# Use an official Python runtime as a parent image
+FROM python:3.12-slim
+
+# Set the working directory in the container
+WORKDIR /app
+
+# Install system dependencies
+# git is often needed for pip installing from git
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy configuration files
+COPY pyproject.toml .
+
+# Install dependencies using pip
+RUN pip install --no-cache-dir .
+
+# Copy the specific server source code
+COPY src/mcp-trader ./src/mcp-trader
+COPY src/core ./src/core
+
+# Set PYTHONPATH to include src so imports work
+ENV PYTHONPATH=/app/src
+
+# Expose the port that Hugging Face Spaces expects (7860)
+EXPOSE 7860
+
+ENV MCP_TRANSPORT=sse
+
+# Run the server
+CMD ["python", "src/mcp-trader/server.py"]

src/mcp-trader/README.md

@@ -0,0 +1,24 @@
+
+---
+title: MCP Trader
+emoji: 📈
+colorFrom: green
+colorTo: blue
+sdk: docker
+pinned: false
+---
+
+# MCP Trader Server
+
+This is a Model Context Protocol (MCP) server for quantitative trading strategies and market analysis.
+
+## Tools
+- `get_stock_price`: Real-time stock data.
+- `get_technical_summary`: RSI, MACD, SMA summary.
+- `get_momentum_strategy`: Momentum-based analysis.
+- `get_mean_reversion_strategy`: Bollinger Band strategy.
+
+## Running Locally
+```bash
+python src/mcp-trader/server.py
+```

src/mcp-trader/config.py

@@ -0,0 +1,13 @@
+
+"""
+Configuration for MCP Trader Server
+"""
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+YAHOO_FINANCE_BASE_URL = "https://query1.finance.yahoo.com/v8/finance/chart/"
+HEADERS = {
+    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
+}

src/mcp-trader/data/fundamentals.py

@@ -0,0 +1,24 @@
+
+import yfinance as yf
+from typing import Dict, Any
+
+def get_fundamental_data(symbol: str) -> Dict[str, Any]:
+    """
+    Get key fundamental metrics.
+    """
+    try:
+        ticker = yf.Ticker(symbol)
+        info = ticker.info
+        
+        return {
+            "symbol": symbol,
+            "market_cap": info.get("marketCap"),
+            "pe_ratio": info.get("trailingPE"),
+            "forward_pe": info.get("forwardPE"),
+            "beta": info.get("beta"),
+            "dividend_yield": info.get("dividendYield"),
+            "sector": info.get("sector"),
+            "industry": info.get("industry")
+        }
+    except Exception as e:
+        return {"error": str(e)}

src/mcp-trader/data/market_data.py

@@ -0,0 +1,52 @@
+
+import yfinance as yf
+import pandas as pd
+from typing import List, Dict, Union
+
+# Try relative import first (for package mode), then absolute (for script/test mode)
+try:
+    from ..schemas import OHLC, StockData
+except (ImportError, ValueError):
+    try:
+        from schemas import OHLC, StockData
+    except (ImportError, ValueError):
+        # Fallback if both fail (e.g. running from root but parent not package)
+        # This shouldn't be needed if path is correct
+        pass
+
+def get_market_data(symbol: str, period: str = "1mo", interval: str = "1d") -> List[Dict]:
+    """
+    Fetch historical data for a symbol.
+    """
+    try:
+        ticker = yf.Ticker(symbol)
+        history = ticker.history(period=period, interval=interval)
+        
+        if history.empty:
+            return []
+            
+        data = []
+        for index, row in history.iterrows():
+            data.append({
+                "date": index.strftime("%Y-%m-%d"),
+                "open": float(row["Open"]),
+                "high": float(row["High"]),
+                "low": float(row["Low"]),
+                "close": float(row["Close"]),
+                "volume": int(row["Volume"])
+            })
+        return data
+    except Exception as e:
+        print(f"Error fetching data for {symbol}: {e}")
+        return []
+
+def get_current_price(symbol: str) -> float:
+    """Get the latest price."""
+    try:
+        ticker = yf.Ticker(symbol)
+        info = ticker.history(period="1d")
+        if not info.empty:
+            return float(info["Close"].iloc[-1])
+        return 0.0
+    except Exception:
+        return 0.0

src/mcp-trader/indicators/technical.py

@@ -0,0 +1,43 @@
+
+import pandas as pd
+import numpy as np
+from typing import Dict, Any
+
+def calculate_sma(data: pd.DataFrame, window: int = 20) -> float:
+    return data['close'].rolling(window=window).mean().iloc[-1]
+
+def calculate_ema(data: pd.DataFrame, window: int = 20) -> float:
+    return data['close'].ewm(span=window, adjust=False).mean().iloc[-1]
+
+def calculate_rsi(data: pd.DataFrame, window: int = 14) -> float:
+    delta = data['close'].diff()
+    gain = (delta.where(delta > 0, 0)).rolling(window=window).mean()
+    loss = (-delta.where(delta < 0, 0)).rolling(window=window).mean()
+    
+    rs = gain / loss
+    rsi = 100 - (100 / (1 + rs))
+    return rsi.iloc[-1]
+
+def calculate_macd(data: pd.DataFrame) -> Dict[str, float]:
+    exp1 = data['close'].ewm(span=12, adjust=False).mean()
+    exp2 = data['close'].ewm(span=26, adjust=False).mean()
+    macd = exp1 - exp2
+    signal = macd.ewm(span=9, adjust=False).mean()
+    
+    return {
+        "macd": macd.iloc[-1],
+        "signal": signal.iloc[-1],
+        "histogram": macd.iloc[-1] - signal.iloc[-1]
+    }
+
+def calculate_bollinger_bands(data: pd.DataFrame, window: int = 20) -> Dict[str, float]:
+    sma = data['close'].rolling(window=window).mean()
+    std = data['close'].rolling(window=window).std()
+    upper_band = sma + (std * 2)
+    lower_band = sma - (std * 2)
+    
+    return {
+        "upper": upper_band.iloc[-1],
+        "middle": sma.iloc[-1],
+        "lower": lower_band.iloc[-1]
+    }

src/mcp-trader/schemas.py

@@ -0,0 +1,35 @@
+
+from pydantic import BaseModel, Field
+from typing import List, Optional, Dict
+from datetime import datetime
+
+class OHLC(BaseModel):
+    date: str
+    open: float
+    high: float
+    low: float
+    close: float
+    volume: int
+
+class StockData(BaseModel):
+    symbol: str
+    interval: str
+    data: List[OHLC]
+
+class IndicatorRequest(BaseModel):
+    symbol: str
+    interval: str = "1d"
+    period: int = 14
+
+class IndicatorResponse(BaseModel):
+    symbol: str
+    indicator: str
+    value: float
+    signal: str  # BUY, SELL, NEUTRAL
+
+class StrategyResult(BaseModel):
+    strategy: str
+    symbol: str
+    action: str  # BUY, SELL, HOLD
+    confidence: float
+    reasoning: str

src/mcp-trader/server.py

@@ -0,0 +1,135 @@
+
+"""
+MCP Trader Server using FastMCP
+"""
+import sys
+import os
+
+# Add src to pythonpath so imports work
+current_dir = os.path.dirname(os.path.abspath(__file__))
+src_dir = os.path.dirname(os.path.dirname(current_dir))
+if src_dir not in sys.path:
+    sys.path.append(src_dir)
+
+from mcp.server.fastmcp import FastMCP
+from typing import List, Dict, Any
+from core.mcp_telemetry import log_usage
+
+# Local imports (assuming src/mcp-trader is a package or run from src)
+try:
+    from .data.market_data import get_market_data, get_current_price
+    from .data.fundamentals import get_fundamental_data
+    from .strategies.momentum import analyze_momentum
+    from .strategies.mean_reversion import analyze_mean_reversion
+    from .strategies.value import analyze_value
+    from .strategies.golden_cross import analyze_golden_cross
+    from .strategies.macd_crossover import analyze_macd_crossover
+    from .strategies.bollinger_squeeze import analyze_bollinger_squeeze
+    from .indicators.technical import calculate_sma, calculate_rsi, calculate_macd
+except ImportError:
+    # Fallback if run directly and relative imports fail
+    from data.market_data import get_market_data, get_current_price
+    from data.fundamentals import get_fundamental_data
+    from strategies.momentum import analyze_momentum
+    from strategies.mean_reversion import analyze_mean_reversion
+    from strategies.value import analyze_value
+    from strategies.golden_cross import analyze_golden_cross
+    from strategies.macd_crossover import analyze_macd_crossover
+    from strategies.bollinger_squeeze import analyze_bollinger_squeeze
+    from indicators.technical import calculate_sma, calculate_rsi, calculate_macd
+
+
+# Initialize FastMCP Server
+mcp = FastMCP("MCP Trader", host="0.0.0.0")
+
+@mcp.tool()
+def get_stock_price(symbol: str) -> float:
+    """Get the current price for a stock symbol."""
+    log_usage("mcp-trader", "get_stock_price")
+    return get_current_price(symbol)
+
+@mcp.tool()
+def get_stock_fundamentals(symbol: str) -> Dict[str, Any]:
+    """Get fundamental data (PE, Market Cap, Sector) for a stock."""
+    log_usage("mcp-trader", "get_stock_fundamentals")
+    return get_fundamental_data(symbol)
+
+@mcp.tool()
+def get_momentum_strategy(symbol: str) -> Dict[str, Any]:
+    """
+    Run Momentum Strategy analysis on a stock.
+    Returns Buy/Sell/Hold recommendation based on RSI, MACD, and Price Trend.
+    """
+    log_usage("mcp-trader", "get_momentum_strategy")
+    return analyze_momentum(symbol)
+
+@mcp.tool()
+def get_mean_reversion_strategy(symbol: str) -> Dict[str, Any]:
+    """
+    Run Mean Reversion Strategy analysis on a stock.
+    Returns Buy/Sell/Hold recommendation based on Bollinger Bands and RSI.
+    """
+    return analyze_mean_reversion(symbol)
+
+@mcp.tool()
+def get_value_strategy(symbol: str) -> Dict[str, Any]:
+    """
+    Run Value Strategy analysis on a stock.
+    Returns Buy/Sell/Hold recommendation based on fundamentals (PE, Dividend Yield).
+    """
+    return analyze_value(symbol)
+
+@mcp.tool()
+def get_golden_cross_strategy(symbol: str) -> Dict[str, Any]:
+    """
+    Run Golden Cross Strategy (Trend Following).
+    Detects SMA 50 crossing above/below SMA 200.
+    """
+    return analyze_golden_cross(symbol)
+
+@mcp.tool()
+def get_macd_crossover_strategy(symbol: str) -> Dict[str, Any]:
+    """
+    Run MACD Crossover Strategy (Momentum).
+    Detects MACD line crossing Signal line.
+    """
+    return analyze_macd_crossover(symbol)
+
+@mcp.tool()
+def get_bollinger_squeeze_strategy(symbol: str) -> Dict[str, Any]:
+    """
+    Run Bollinger Squeeze Strategy (Volatility).
+    Detects low volatility periods followed by potential breakouts.
+    """
+    return analyze_bollinger_squeeze(symbol)
+
+@mcp.tool()
+def get_technical_summary(symbol: str) -> Dict[str, Any]:
+    """
+    Get a summary of technical indicators for a stock (RSI, MACD, SMA).
+    """
+    raw_data = get_market_data(symbol, period="3mo")
+    if not raw_data:
+        return {"error": "No data found"}
+    
+    import pandas as pd
+    df = pd.DataFrame(raw_data)
+    
+    return {
+        "symbol": symbol,
+        "price": df['close'].iloc[-1],
+        "rsi_14": calculate_rsi(df),
+        "sma_20": calculate_sma(df, 20),
+        "sma_50": calculate_sma(df, 50),
+        "macd": calculate_macd(df)
+    }
+
+if __name__ == "__main__":
+    # Run the MCP server
+    import os
+    if os.environ.get("MCP_TRANSPORT") == "sse":
+        import uvicorn
+        port = int(os.environ.get("PORT", 7860))
+        uvicorn.run(mcp.sse_app(), host="0.0.0.0", port=port)
+    else:
+        mcp.run()

src/mcp-trader/strategies/bollinger_squeeze.py

@@ -0,0 +1,71 @@
+
+try:
+    from ..data.market_data import get_market_data
+except (ImportError, ValueError):
+    from data.market_data import get_market_data
+
+import pandas as pd
+import numpy as np
+
+def analyze_bollinger_squeeze(symbol: str) -> dict:
+    """
+    Analyze BB Squeeze (Low Volatility) + Direction.
+    """
+    try:
+        raw_data = get_market_data(symbol, period="6mo")
+        if not raw_data or len(raw_data) < 50:
+            return {"action": "HOLD", "confidence": 0.0, "reasoning": "Insufficient data"}
+        
+        df = pd.DataFrame(raw_data)
+        
+        # Calculate Bands
+        sma = df['close'].rolling(window=20).mean()
+        std = df['close'].rolling(window=20).std()
+        
+        upper = sma + (2 * std)
+        lower = sma - (2 * std)
+        
+        # Band Width relative to price
+        df['bandwidth'] = (upper - lower) / sma
+        
+        # Recent Band Width percentile (last 6 months)
+        current_bw = df['bandwidth'].iloc[-1]
+        bw_rank = df['bandwidth'].rank(pct=True).iloc[-1]
+        
+        # Squeeze Condition: Width in lowest 20% of last 6mo
+        squeeze_on = bw_rank <= 0.20
+        
+        # Momentum direction (RSI)
+        delta = df['close'].diff()
+        gain = (delta.where(delta > 0, 0)).rolling(window=14).mean()
+        loss = (-delta.where(delta < 0, 0)).rolling(window=14).mean()
+        rs = gain / loss
+        rsi = 100 - (100 / (1 + rs))
+        current_rsi = rsi.iloc[-1]
+        
+        action = "HOLD"
+        confidence = 0.0
+        reasoning = []
+        
+        if squeeze_on:
+            reasoning.append(f"Volatility Squeeze ACTIVE (Rank: {bw_rank:.0%})")
+            if current_rsi > 50:
+                action = "BUY"
+                confidence = 0.7  # Breakout potential upwards
+                reasoning.append("Squeeze + Bullish Momentum (RSI > 50)")
+            else:
+                action = "SELL"
+                confidence = 0.7 # Breakout potential downwards
+                reasoning.append("Squeeze + Bearish Momentum (RSI < 50)")
+        else:
+            reasoning.append(f"No Squeeze (Rank: {bw_rank:.0%})")
+            
+        return {
+            "strategy": "Bollinger Squeeze",
+            "symbol": symbol,
+            "action": action,
+            "confidence": confidence,
+            "reasoning": "; ".join(reasoning)
+        }
+    except Exception as e:
+        return {"action": "HOLD", "confidence": 0.0, "reasoning": f"Error: {str(e)}"}

src/mcp-trader/strategies/golden_cross.py

@@ -0,0 +1,66 @@
+
+try:
+    from ..data.market_data import get_market_data
+except (ImportError, ValueError):
+    from data.market_data import get_market_data
+
+import pandas as pd
+
+def analyze_golden_cross(symbol: str) -> dict:
+    """
+    Analyze Golden Cross (SMA 50 crosses above SMA 200) strategy.
+    """
+    # Need enough data for 200 SMA -> ~1 year (252 trading days) + buffer
+    raw_data = get_market_data(symbol, period="2y")
+    if not raw_data or len(raw_data) < 200:
+        return {"action": "HOLD", "confidence": 0.0, "reasoning": "Insufficient data for 200 SMA"}
+    
+    df = pd.DataFrame(raw_data)
+    
+    df['sma_50'] = df['close'].rolling(window=50).mean()
+    df['sma_200'] = df['close'].rolling(window=200).mean()
+    
+    current_50 = df['sma_50'].iloc[-1]
+    current_200 = df['sma_200'].iloc[-1]
+    
+    prev_50 = df['sma_50'].iloc[-2]
+    prev_200 = df['sma_200'].iloc[-2]
+    
+    # Check for crossover
+    # Golden Cross: 50 crosses above 200
+    golden_cross = (prev_50 <= prev_200) and (current_50 > current_200)
+    
+    # Death Cross: 50 crosses below 200
+    death_cross = (prev_50 >= prev_200) and (current_50 < current_200)
+    
+    # Trend Context
+    bullish_trend = current_50 > current_200
+    
+    action = "HOLD"
+    confidence = 0.0
+    reasoning = []
+    
+    if golden_cross:
+        action = "BUY"
+        confidence = 0.9
+        reasoning.append("Golden Cross Detected (50 SMA crossed above 200 SMA)")
+    elif death_cross:
+        action = "SELL"
+        confidence = 0.9
+        reasoning.append("Death Cross Detected (50 SMA crossed below 200 SMA)")
+    elif bullish_trend:
+        action = "BUY"
+        confidence = 0.5
+        reasoning.append("Bullish Trend (50 SMA > 200 SMA)")
+    else:
+        action = "SELL"
+        confidence = 0.5
+        reasoning.append("Bearish Trend (50 SMA < 200 SMA)")
+        
+    return {
+        "strategy": "Golden Cross",
+        "symbol": symbol,
+        "action": action,
+        "confidence": confidence,
+        "reasoning": "; ".join(reasoning)
+    }

src/mcp-trader/strategies/macd_crossover.py

@@ -0,0 +1,62 @@
+
+try:
+    from ..data.market_data import get_market_data
+except (ImportError, ValueError):
+    from data.market_data import get_market_data
+
+import pandas as pd
+
+def analyze_macd_crossover(symbol: str) -> dict:
+    """
+    Analyze MACD Crossover (MACD line crosses Signal line) strategy.
+    """
+    raw_data = get_market_data(symbol, period="6mo")
+    if not raw_data or len(raw_data) < 50:
+        return {"action": "HOLD", "confidence": 0.0, "reasoning": "Insufficient data"}
+    
+    df = pd.DataFrame(raw_data)
+    
+    # Calculate MACD
+    exp1 = df['close'].ewm(span=12, adjust=False).mean()
+    exp2 = df['close'].ewm(span=26, adjust=False).mean()
+    macd = exp1 - exp2
+    signal = macd.ewm(span=9, adjust=False).mean()
+    hist = macd - signal
+    
+    curr_h = hist.iloc[-1]
+    prev_h = hist.iloc[-2]
+    
+    # Cross Up (Bullish): Histogram goes from negative to positive
+    cross_up = (prev_h <= 0) and (curr_h > 0)
+    
+    # Cross Down (Bearish): Histogram goes from positive to negative
+    cross_down = (prev_h >= 0) and (curr_h < 0)
+    
+    action = "HOLD"
+    confidence = 0.0
+    reasoning = []
+    
+    if cross_up:
+        action = "BUY"
+        confidence = 0.8
+        reasoning.append("MACD Bullish Crossover")
+    elif cross_down:
+        action = "SELL"
+        confidence = 0.8
+        reasoning.append("MACD Bearish Crossover")
+    elif curr_h > 0:
+        action = "BUY"
+        confidence = 0.4
+        reasoning.append("MACD Bullish Momentum (Above Signal)")
+    else:
+        action = "SELL"
+        confidence = 0.4
+        reasoning.append("MACD Bearish Momentum (Below Signal)")
+        
+    return {
+        "strategy": "MACD Crossover",
+        "symbol": symbol,
+        "action": action,
+        "confidence": confidence,
+        "reasoning": "; ".join(reasoning)
+    }

src/mcp-trader/strategies/mean_reversion.py

@@ -0,0 +1,57 @@
+
+try:
+    from ..data.market_data import get_market_data
+    from ..indicators.technical import calculate_bollinger_bands, calculate_rsi
+except (ImportError, ValueError):
+    from data.market_data import get_market_data
+    from indicators.technical import calculate_bollinger_bands, calculate_rsi
+import pandas as pd
+
+def analyze_mean_reversion(symbol: str) -> dict:
+    """
+    Analyze mean reversion potential.
+    """
+    raw_data = get_market_data(symbol, period="3mo")
+    if not raw_data:
+        return {"action": "HOLD", "confidence": 0.0, "reasoning": "No data found"}
+    
+    df = pd.DataFrame(raw_data)
+    
+    bb = calculate_bollinger_bands(df)
+    rsi = calculate_rsi(df)
+    current_price = df['close'].iloc[-1]
+    
+    score = 0
+    reasons = []
+    
+    # Bollinger Bands Logic
+    if current_price < bb["lower"]:
+        score += 2
+        reasons.append(f"Price below lower BB ({bb['lower']:.2f})")
+    elif current_price > bb["upper"]:
+        score -= 2
+        reasons.append(f"Price above upper BB ({bb['upper']:.2f})")
+    else:
+        reasons.append("Price within bands")
+        
+    # RSI Confirmation
+    if rsi < 30 and score > 0:
+        score += 1
+        reasons.append("RSI confirms oversold")
+    elif rsi > 70 and score < 0:
+        score -= 1
+        reasons.append("RSI confirms overbought")
+        
+    action = "HOLD"
+    if score >= 2:
+        action = "BUY"
+    elif score <= -2:
+        action = "SELL"
+        
+    return {
+        "strategy": "Mean Reversion",
+        "symbol": symbol,
+        "action": action,
+        "confidence": min(abs(score) / 3.0, 1.0),
+        "reasoning": "; ".join(reasons)
+    }

src/mcp-trader/strategies/momentum.py

@@ -0,0 +1,68 @@
+
+try:
+    from ..data.market_data import get_market_data
+    from ..indicators.technical import calculate_rsi, calculate_macd, calculate_sma
+except (ImportError, ValueError):
+    from data.market_data import get_market_data
+    from indicators.technical import calculate_rsi, calculate_macd, calculate_sma
+import pandas as pd
+
+def analyze_momentum(symbol: str) -> dict:
+    """
+    Analyze momentum for a given symbol.
+    Returns: StrategyResult dict
+    """
+    raw_data = get_market_data(symbol, period="3mo")
+    if not raw_data:
+        return {"action": "HOLD", "confidence": 0.0, "reasoning": "No data found"}
+    
+    df = pd.DataFrame(raw_data)
+    
+    rsi = calculate_rsi(df)
+    macd_data = calculate_macd(df)
+    sma_50 = calculate_sma(df, 50)
+    current_price = df['close'].iloc[-1]
+    
+    score = 0
+    reasons = []
+    
+    # RSI Logic
+    if rsi < 30:
+        score += 1
+        reasons.append(f"RSI is oversold ({rsi:.2f})")
+    elif rsi > 70:
+        score -= 1
+        reasons.append(f"RSI is overbought ({rsi:.2f})")
+    else:
+        reasons.append(f"RSI is neutral ({rsi:.2f})")
+        
+    # MACD Logic
+    if macd_data["histogram"] > 0:
+        score += 1
+        reasons.append("MACD histogram is positive")
+    else:
+        score -= 1
+        reasons.append("MACD histogram is negative")
+        
+    # Trend Logic
+    if current_price > sma_50:
+        score += 1
+        reasons.append("Price is above 50 SMA")
+    else:
+        score -= 1
+        reasons.append("Price is below 50 SMA")
+        
+    # Final Decision
+    action = "HOLD"
+    if score >= 2:
+        action = "BUY"
+    elif score <= -2:
+        action = "SELL"
+        
+    return {
+        "strategy": "Momentum",
+        "symbol": symbol,
+        "action": action,
+        "confidence": abs(score) / 3.0,
+        "reasoning": "; ".join(reasons)
+    }