mcp-proxy-adapter 6.0.0__py3-none-any.whl → 6.1.0__py3-none-any.whl

mcp_proxy_adapter/commands/proxy_registration_command.py

@@ -1,268 +1,409 @@
 """
-Command for managing proxy registration.
+Proxy Registration Command
 
-This command allows manual registration, unregistration, and status checking
-for the proxy registration functionality.
+This command handles proxy registration functionality with security framework integration.
+It provides endpoints for registration, unregistration, heartbeat, and discovery.
+
+Author: Vasiliy Zdanovskiy
+email: vasilyvz@gmail.com
 """
 
-import asyncio
-from typing import Dict, Any, Optional
+import json
+import time
+import uuid
+from typing import Dict, Any, List, Optional
+from dataclasses import dataclass
 
 from mcp_proxy_adapter.commands.base import Command
-from mcp_proxy_adapter.commands.result import CommandResult
-from mcp_proxy_adapter.core.proxy_registration import (
-    register_with_proxy, 
-    unregister_from_proxy, 
-    get_proxy_registration_status,
-    proxy_registration_manager
-)
+from mcp_proxy_adapter.commands.result import SuccessResult
 from mcp_proxy_adapter.core.logging import logger
 
 
-class ProxyRegistrationResult(CommandResult):
-    """Result class for proxy registration commands."""
+@dataclass
+class ProxyRegistrationCommandResult(SuccessResult):
+    """Result of proxy registration command."""
     
-    def __init__(self, success: bool, message: str, data: Optional[Dict[str, Any]] = None):
-        """
-        Initialize proxy registration result.
+    operation: str
+    success: bool
+    server_key: Optional[str] = None
+    message: str = ""
+    details: Optional[Dict[str, Any]] = None
+    
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert result to dictionary."""
+        result = {
+            "operation": self.operation,
+            "success": self.success,
+            "message": self.message
+        }
         
-        Args:
-            success: Whether the operation was successful.
-            message: Result message.
-            data: Additional data.
-        """
-        self.success = success
-        self.message = message
-        self.data = data
+        if self.server_key:
+            result["server_key"] = self.server_key
+        
+        if self.details:
+            result["details"] = self.details
+        
+        return result
     
     @classmethod
     def get_schema(cls) -> Dict[str, Any]:
-        """
-        Get JSON schema for this result.
-        
-        Returns:
-            JSON schema dictionary.
-        """
+        """Get JSON schema for result."""
         return {
             "type": "object",
             "properties": {
+                "operation": {
+                    "type": "string",
+                    "description": "Operation performed"
+                },
                 "success": {
                     "type": "boolean",
-                    "description": "Whether the operation was successful"
+                    "description": "Whether operation was successful"
+                },
+                "server_key": {
+                    "type": "string",
+                    "description": "Server key for registered server"
                 },
                 "message": {
                     "type": "string",
                     "description": "Result message"
                 },
-                "data": {
+                "details": {
                     "type": "object",
-                    "description": "Additional data",
-                    "additionalProperties": True
+                    "description": "Additional details"
                 }
             },
-            "required": ["success", "message"]
-        }
-    
-    def to_dict(self) -> Dict[str, Any]:
-        """
-        Convert result to dictionary.
-        
-        Returns:
-            Dictionary representation of the result.
-        """
-        result = {
-            "success": self.success,
-            "message": self.message
+            "required": ["operation", "success", "message"]
         }
-        if self.data is not None:
-            result["data"] = self.data
-        return result
 
 
 class ProxyRegistrationCommand(Command):
-    """
-    Command for managing proxy registration.
-    
-    Supports registration, unregistration, and status checking.
-    """
+    """Proxy registration command with security framework integration."""
     
     name = "proxy_registration"
+    descr = "Proxy registration operations (register, unregister, heartbeat, discover)"
+    category = "proxy"
+    author = "Vasiliy Zdanovskiy"
+    email = "vasilyvz@gmail.com"
     
-    def __init__(self):
-        """Initialize the proxy registration command."""
-        super().__init__()
+    # In-memory registry for testing
+    _registry: Dict[str, Dict[str, Any]] = {}
+    _server_counter = 1
     
-    async def execute(self, **kwargs) -> ProxyRegistrationResult:
+    async def execute(self, **kwargs) -> ProxyRegistrationCommandResult:
         """
         Execute proxy registration command.
         
         Args:
-            **kwargs: Command parameters containing:
-                - action: "register", "unregister", or "status"
-                - server_url: (optional) Server URL for registration
-                
+            operation: Operation to perform (register, unregister, heartbeat, discover)
+            server_id: Server ID for registration
+            server_url: Server URL for registration
+            server_name: Server name
+            description: Server description
+            version: Server version
+            capabilities: Server capabilities
+            endpoints: Server endpoints
+            auth_method: Authentication method
+            security_enabled: Whether security is enabled
+            server_key: Server key for unregistration/heartbeat
+            copy_number: Copy number for unregistration
+            timestamp: Timestamp for heartbeat
+            status: Status for heartbeat
+            
         Returns:
-            ProxyRegistrationResult with operation result.
+            ProxyRegistrationCommandResult
         """
-        action = kwargs.get("action", "status")
+        operation = kwargs.get("operation", "register")
+        
+        # Check user permissions
+        context = kwargs.get("context", {})
+        user_info = context.get("user", {})
+        user_permissions = user_info.get("permissions", [])
+        
+        # Define required permissions for each operation
+        operation_permissions = {
+            "register": ["register"],
+            "unregister": ["unregister"],
+            "heartbeat": ["heartbeat"],
+            "discover": ["discover"]
+        }
+        
+        required_permissions = operation_permissions.get(operation, ["read"])
+        
+        # Check if user has required permissions
+        logger.info(f"Checking permissions: user_permissions={user_permissions}, required={required_permissions}")
+        if not self._check_permissions(user_permissions, required_permissions):
+            return ProxyRegistrationCommandResult(
+                operation=operation,
+                success=False,
+                message=f"Permission denied: {operation} requires {required_permissions}"
+            )
         
-        try:
-            if action == "register":
-                return await self._handle_register(kwargs)
-            elif action == "unregister":
-                return await self._handle_unregister(kwargs)
-            elif action == "status":
-                return await self._handle_status(kwargs)
-            else:
-                return ProxyRegistrationResult(
-                    success=False,
-                    message=f"Unknown action: {action}. Supported actions: register, unregister, status"
-                )
-                
-        except Exception as e:
-            logger.error(f"Proxy registration command failed: {e}")
-            return ProxyRegistrationResult(
+        logger.info(f"Executing proxy registration operation: {operation}")
+        logger.debug(f"User permissions: {user_permissions}, required: {required_permissions}")
+        
+        if operation == "register":
+            return await self._handle_register(kwargs)
+        elif operation == "unregister":
+            return await self._handle_unregister(kwargs)
+        elif operation == "heartbeat":
+            return await self._handle_heartbeat(kwargs)
+        elif operation == "discover":
+            return await self._handle_discover(kwargs)
+        else:
+            return ProxyRegistrationCommandResult(
+                operation=operation,
                 success=False,
-                message=f"Command execution failed: {str(e)}"
+                message=f"Unknown operation: {operation}"
             )
     
-    async def _handle_register(self, params: Dict[str, Any]) -> ProxyRegistrationResult:
-        """
-        Handle registration action.
+    async def _handle_register(self, kwargs: Dict[str, Any]) -> ProxyRegistrationCommandResult:
+        """Handle registration operation."""
+        server_id = kwargs.get("server_id")
+        server_url = kwargs.get("server_url")
+        server_name = kwargs.get("server_name", "Unknown Server")
+        description = kwargs.get("description", "")
+        version = kwargs.get("version", "1.0.0")
+        capabilities = kwargs.get("capabilities", ["jsonrpc", "rest"])
+        endpoints = kwargs.get("endpoints", {})
+        auth_method = kwargs.get("auth_method", "none")
+        security_enabled = kwargs.get("security_enabled", False)
         
-        Args:
-            params: Command parameters.
-            
-        Returns:
-            ProxyRegistrationResult.
-        """
-        server_url = params.get("server_url")
+        if not server_id or not server_url:
+            return ProxyRegistrationCommandResult(
+                operation="register",
+                success=False,
+                message="Missing required parameters: server_id and server_url"
+            )
         
-        if not server_url:
-            # Use current server configuration
-            from mcp_proxy_adapter.config import config
-            
-            server_config = config.get("server", {})
-            server_host = server_config.get("host", "0.0.0.0")
-            server_port = server_config.get("port", 8000)
-            
-            # Determine server URL based on SSL configuration
-            ssl_config = config.get("ssl", {})
-            if ssl_config.get("enabled", False):
-                protocol = "https"
-            else:
-                protocol = "http"
-            
-            # Use localhost for external access if host is 0.0.0.0
-            if server_host == "0.0.0.0":
-                server_host = "localhost"
-            
-            server_url = f"{protocol}://{server_host}:{server_port}"
+        # Check if server already exists
+        existing_servers = [key for key in self._registry.keys() if key.startswith(server_id)]
+        copy_number = len(existing_servers) + 1
+        server_key = f"{server_id}_{copy_number}"
+        
+        # Create server record
+        server_record = {
+            "server_id": server_id,
+            "server_url": server_url,
+            "server_name": server_name,
+            "description": description,
+            "version": version,
+            "capabilities": capabilities,
+            "endpoints": endpoints,
+            "auth_method": auth_method,
+            "security_enabled": security_enabled,
+            "registered_at": int(time.time()),
+            "last_heartbeat": int(time.time()),
+            "status": "active"
+        }
+        
+        self._registry[server_key] = server_record
+        
+        logger.info(f"Registered server: {server_key} at {server_url}")
+        
+        return ProxyRegistrationCommandResult(
+            operation="register",
+            success=True,
+            server_key=server_key,
+            message=f"Server registered successfully with key: {server_key}",
+            details={
+                "server_id": server_id,
+                "copy_number": copy_number,
+                "registered_at": server_record["registered_at"]
+            }
+        )
+    
+    async def _handle_unregister(self, kwargs: Dict[str, Any]) -> ProxyRegistrationCommandResult:
+        """Handle unregistration operation."""
+        server_id = kwargs.get("server_id")
+        copy_number = kwargs.get("copy_number", 1)
         
-        logger.info(f"Attempting to register with proxy using URL: {server_url}")
+        if not server_id:
+            return ProxyRegistrationCommandResult(
+                operation="unregister",
+                success=False,
+                message="Missing required parameter: server_id"
+            )
         
-        success = await register_with_proxy(server_url)
+        server_key = f"{server_id}_{copy_number}"
         
-        if success:
-            status = get_proxy_registration_status()
-            return ProxyRegistrationResult(
+        if server_key in self._registry:
+            del self._registry[server_key]
+            logger.info(f"Unregistered server: {server_key}")
+            
+            return ProxyRegistrationCommandResult(
+                operation="unregister",
                 success=True,
-                message="✅ Successfully registered with proxy",
-                data={
-                    "server_url": server_url,
-                    "server_key": status.get("server_key"),
-                    "registration_status": status
-                }
+                message=f"Server unregistered successfully: {server_key}",
+                details={"unregistered": True}
             )
         else:
-            return ProxyRegistrationResult(
-                success=False,
-                message="❌ Failed to register with proxy"
+            return ProxyRegistrationCommandResult(
+                operation="unregister",
+                success=True,
+                message=f"Server not found in registry: {server_key}",
+                details={"unregistered": False}
             )
     
-    async def _handle_unregister(self, params: Dict[str, Any]) -> ProxyRegistrationResult:
-        """
-        Handle unregistration action.
+    async def _handle_heartbeat(self, kwargs: Dict[str, Any]) -> ProxyRegistrationCommandResult:
+        """Handle heartbeat operation."""
+        server_id = kwargs.get("server_id")
+        server_key = kwargs.get("server_key")
+        timestamp = kwargs.get("timestamp", int(time.time()))
+        status = kwargs.get("status", "healthy")
         
-        Args:
-            params: Command parameters.
-            
-        Returns:
-            ProxyRegistrationResult.
-        """
-        logger.info("Attempting to unregister from proxy")
-        
-        success = await unregister_from_proxy()
+        if not server_key:
+            return ProxyRegistrationCommandResult(
+                operation="heartbeat",
+                success=False,
+                message="Missing required parameter: server_key"
+            )
         
-        if success:
-            return ProxyRegistrationResult(
+        if server_key in self._registry:
+            self._registry[server_key]["last_heartbeat"] = timestamp
+            self._registry[server_key]["status"] = status
+            
+            logger.debug(f"Heartbeat received for server: {server_key}")
+            
+            return ProxyRegistrationCommandResult(
+                operation="heartbeat",
                 success=True,
-                message="✅ Successfully unregistered from proxy"
+                message="Heartbeat processed successfully",
+                details={
+                    "server_key": server_key,
+                    "timestamp": timestamp,
+                    "status": status
+                }
             )
         else:
-            return ProxyRegistrationResult(
+            return ProxyRegistrationCommandResult(
+                operation="heartbeat",
                 success=False,
-                message="❌ Failed to unregister from proxy"
+                message=f"Server not found: {server_key}"
             )
     
-    async def _handle_status(self, params: Dict[str, Any]) -> ProxyRegistrationResult:
+    async def _handle_discover(self, kwargs: Dict[str, Any]) -> ProxyRegistrationCommandResult:
+        """Handle discovery operation."""
+        # Return all registered servers
+        proxies = []
+        
+        for server_key, server_record in self._registry.items():
+            # Check if server is active (heartbeat within last 5 minutes)
+            last_heartbeat = server_record.get("last_heartbeat", 0)
+            if time.time() - last_heartbeat < 300:  # 5 minutes
+                proxy_info = {
+                    "server_key": server_key,
+                    "server_id": server_record["server_id"],
+                    "server_url": server_record["server_url"],
+                    "server_name": server_record["server_name"],
+                    "description": server_record["description"],
+                    "version": server_record["version"],
+                    "capabilities": server_record["capabilities"],
+                    "endpoints": server_record["endpoints"],
+                    "auth_method": server_record["auth_method"],
+                    "security_enabled": server_record["security_enabled"],
+                    "registered_at": server_record["registered_at"],
+                    "last_heartbeat": server_record["last_heartbeat"],
+                    "status": server_record["status"]
+                }
+                proxies.append(proxy_info)
+        
+        logger.info(f"Discovery request returned {len(proxies)} active servers")
+        
+        return ProxyRegistrationCommandResult(
+            operation="discover",
+            success=True,
+            message=f"Found {len(proxies)} active proxy servers",
+            details={"proxies": proxies}
+        )
+    
+    def _check_permissions(self, user_permissions: List[str], required_permissions: List[str]) -> bool:
         """
-        Handle status action.
+        Check if user has required permissions.
         
         Args:
-            params: Command parameters.
+            user_permissions: User's permissions
+            required_permissions: Required permissions
             
         Returns:
-            ProxyRegistrationResult.
+            True if user has required permissions
         """
-        status = get_proxy_registration_status()
+        # Admin has all permissions
+        if "*" in user_permissions:
+            return True
         
-        return ProxyRegistrationResult(
-            success=True,
-            message="Proxy registration status retrieved successfully",
-            data={
-                "registration_status": status,
-                "enabled": status.get("enabled", False),
-                "registered": status.get("registered", False),
-                "server_key": status.get("server_key"),
-                "server_url": status.get("server_url"),
-                "proxy_url": status.get("proxy_url")
-            }
-        )
+        # Check if user has all required permissions
+        for required in required_permissions:
+            if required not in user_permissions:
+                return False
+        
+        return True
     
     @classmethod
     def get_schema(cls) -> Dict[str, Any]:
-        """
-        Get command schema.
-        
-        Returns:
-            Command schema.
-        """
+        """Get JSON schema for command parameters."""
         return {
             "type": "object",
             "properties": {
-                "action": {
+                "operation": {
+                    "type": "string",
+                    "enum": ["register", "unregister", "heartbeat", "discover"],
+                    "description": "Operation to perform",
+                    "default": "register"
+                },
+                "server_id": {
                     "type": "string",
-                    "enum": ["register", "unregister", "status"],
-                    "description": "Action to perform: register, unregister, or status"
+                    "description": "Server ID for registration"
                 },
                 "server_url": {
                     "type": "string",
-                    "description": "Server URL for registration (optional, uses current config if not provided)"
+                    "description": "Server URL for registration"
+                },
+                "server_name": {
+                    "type": "string",
+                    "description": "Server name"
+                },
+                "description": {
+                    "type": "string",
+                    "description": "Server description"
+                },
+                "version": {
+                    "type": "string",
+                    "description": "Server version"
+                },
+                "capabilities": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": "Server capabilities"
+                },
+                "endpoints": {
+                    "type": "object",
+                    "description": "Server endpoints"
+                },
+                "auth_method": {
+                    "type": "string",
+                    "description": "Authentication method"
+                },
+                "security_enabled": {
+                    "type": "boolean",
+                    "description": "Whether security is enabled"
+                },
+                "server_key": {
+                    "type": "string",
+                    "description": "Server key for unregistration/heartbeat"
+                },
+                "copy_number": {
+                    "type": "integer",
+                    "description": "Copy number for unregistration"
+                },
+                "timestamp": {
+                    "type": "integer",
+                    "description": "Timestamp for heartbeat"
+                },
+                "status": {
+                    "type": "string",
+                    "description": "Status for heartbeat"
                 }
             },
-            "required": ["action"]
-        }
-    
-    def to_dict(self) -> Dict[str, Any]:
-        """
-        Convert command to dictionary.
-        
-        Returns:
-            Command dictionary representation.
-        """
-        return {
-            "name": self.name,
-            "description": "Manage proxy registration (register, unregister, status)",
-            "schema": self.__class__.get_schema()
+            "required": ["operation"],
+            "additionalProperties": False
         }