mcp-proxy-adapter 6.4.44__tar.gz → 6.4.46__tar.gz

{mcp_proxy_adapter-6.4.44 → mcp_proxy_adapter-6.4.46}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-proxy-adapter
-Version: 6.4.44
+Version: 6.4.46
 Summary: Powerful JSON-RPC microservices framework with built-in security, authentication, and proxy registration
 Home-page: https://github.com/maverikod/mcp-proxy-adapter
 Author: Vasiliy Zdanovskiy
@@ -138,6 +138,86 @@ The `mcp_proxy_adapter/examples/` directory contains comprehensive examples for
 - **Security Testing**: Comprehensive security test suite
 - **Certificate Generation**: SSL/TLS certificate management
 
+### Test Environment Setup
+
+The framework includes a comprehensive test environment setup that automatically creates configurations, generates certificates, and runs tests:
+
+```bash
+# Create a complete test environment with all configurations and certificates
+python -m mcp_proxy_adapter.examples.setup_test_environment
+
+# Create test environment in a specific directory
+python -m mcp_proxy_adapter.examples.setup_test_environment /path/to/test/dir
+
+# Skip certificate generation (use existing certificates)
+python -m mcp_proxy_adapter.examples.setup_test_environment --skip-certs
+
+# Skip running tests (setup only)
+python -m mcp_proxy_adapter.examples.setup_test_environment --skip-tests
+```
+
+### Configuration Generation
+
+Generate test configurations from a comprehensive template:
+
+```bash
+# Generate all test configurations
+python -m mcp_proxy_adapter.examples.create_test_configs
+
+# Generate from specific comprehensive config
+python -m mcp_proxy_adapter.examples.create_test_configs --comprehensive-config config.json
+
+# Generate specific configuration types
+python -m mcp_proxy_adapter.examples.create_test_configs --types http,https,mtls
+```
+
+### Certificate Generation
+
+Generate SSL/TLS certificates for testing:
+
+```bash
+# Generate all certificates using mcp_security_framework
+python -m mcp_proxy_adapter.examples.generate_all_certificates
+
+# Generate certificates with custom configuration
+python -m mcp_proxy_adapter.examples.generate_certificates_framework --config cert_config.json
+```
+
+### Security Testing
+
+Run comprehensive security tests:
+
+```bash
+# Run all security tests
+python -m mcp_proxy_adapter.examples.run_security_tests_fixed
+
+# Run full test suite (includes setup, config generation, certificate generation, and testing)
+python -m mcp_proxy_adapter.examples.run_full_test_suite
+```
+
+### Complete Workflow Example
+
+```bash
+# 1. Install the package
+pip install mcp-proxy-adapter
+
+# 2. Create test environment (automatically runs tests)
+python -m mcp_proxy_adapter.examples.setup_test_environment
+
+# 3. Or run individual steps:
+# Generate certificates
+python -m mcp_proxy_adapter.examples.generate_all_certificates
+
+# Generate configurations
+python -m mcp_proxy_adapter.examples.create_test_configs
+
+# Run security tests
+python -m mcp_proxy_adapter.examples.run_security_tests_fixed
+
+# 4. Start server with generated configuration
+python -m mcp_proxy_adapter --config configs/http_simple.json
+```
+
 ## Development
 
 The project follows a modular architecture:

{mcp_proxy_adapter-6.4.44 → mcp_proxy_adapter-6.4.46}/README.md

@@ -79,6 +79,86 @@ The `mcp_proxy_adapter/examples/` directory contains comprehensive examples for
 - **Security Testing**: Comprehensive security test suite
 - **Certificate Generation**: SSL/TLS certificate management
 
+### Test Environment Setup
+
+The framework includes a comprehensive test environment setup that automatically creates configurations, generates certificates, and runs tests:
+
+```bash
+# Create a complete test environment with all configurations and certificates
+python -m mcp_proxy_adapter.examples.setup_test_environment
+
+# Create test environment in a specific directory
+python -m mcp_proxy_adapter.examples.setup_test_environment /path/to/test/dir
+
+# Skip certificate generation (use existing certificates)
+python -m mcp_proxy_adapter.examples.setup_test_environment --skip-certs
+
+# Skip running tests (setup only)
+python -m mcp_proxy_adapter.examples.setup_test_environment --skip-tests
+```
+
+### Configuration Generation
+
+Generate test configurations from a comprehensive template:
+
+```bash
+# Generate all test configurations
+python -m mcp_proxy_adapter.examples.create_test_configs
+
+# Generate from specific comprehensive config
+python -m mcp_proxy_adapter.examples.create_test_configs --comprehensive-config config.json
+
+# Generate specific configuration types
+python -m mcp_proxy_adapter.examples.create_test_configs --types http,https,mtls
+```
+
+### Certificate Generation
+
+Generate SSL/TLS certificates for testing:
+
+```bash
+# Generate all certificates using mcp_security_framework
+python -m mcp_proxy_adapter.examples.generate_all_certificates
+
+# Generate certificates with custom configuration
+python -m mcp_proxy_adapter.examples.generate_certificates_framework --config cert_config.json
+```
+
+### Security Testing
+
+Run comprehensive security tests:
+
+```bash
+# Run all security tests
+python -m mcp_proxy_adapter.examples.run_security_tests_fixed
+
+# Run full test suite (includes setup, config generation, certificate generation, and testing)
+python -m mcp_proxy_adapter.examples.run_full_test_suite
+```
+
+### Complete Workflow Example
+
+```bash
+# 1. Install the package
+pip install mcp-proxy-adapter
+
+# 2. Create test environment (automatically runs tests)
+python -m mcp_proxy_adapter.examples.setup_test_environment
+
+# 3. Or run individual steps:
+# Generate certificates
+python -m mcp_proxy_adapter.examples.generate_all_certificates
+
+# Generate configurations
+python -m mcp_proxy_adapter.examples.create_test_configs
+
+# Run security tests
+python -m mcp_proxy_adapter.examples.run_security_tests_fixed
+
+# 4. Start server with generated configuration
+python -m mcp_proxy_adapter --config configs/http_simple.json
+```
+
 ## Development
 
 The project follows a modular architecture:

{mcp_proxy_adapter-6.4.44 → mcp_proxy_adapter-6.4.46}/mcp_proxy_adapter/core/proxy_registration.py

@@ -68,84 +68,116 @@ class ProxyRegistrationManager:
         except Exception:
             pass
 
-        # Basic registration settings
-        self.proxy_url = self.registration_config.get("proxy_url")
-        if not self.proxy_url:
-            raise ValueError(
-                "proxy_url is required in registration configuration. "
-                "Please specify a valid proxy URL in your configuration."
-            )
-        self.server_id = self.registration_config.get("server_id")
-        if not self.server_id:
-            # Try to get from proxy_info.name as fallback
-            self.server_id = self.registration_config.get("proxy_info", {}).get("name")
-            if not self.server_id:
+        # Check if registration is enabled
+        self.enabled = self.registration_config.get("enabled", False)
+        
+        # Basic registration settings - only validate if enabled
+        if self.enabled:
+            self.proxy_url = self.registration_config.get("proxy_url")
+            if not self.proxy_url:
                 raise ValueError(
-                    "server_id is required in registration configuration. "
-                    "Please specify a server_id or proxy_info.name in your configuration."
+                    "proxy_url is required in registration configuration. "
+                    "Please specify a valid proxy URL in your configuration."
                 )
-        self.server_name = self.registration_config.get("server_name")
-        if not self.server_name:
-            # Try to get from proxy_info.name as fallback
-            self.server_name = self.registration_config.get("proxy_info", {}).get("name")
+        else:
+            self.proxy_url = None
+            
+        if self.enabled:
+            self.server_id = self.registration_config.get("server_id")
+            if not self.server_id:
+                # Try to get from proxy_info.name as fallback
+                self.server_id = self.registration_config.get("proxy_info", {}).get("name")
+                if not self.server_id:
+                    raise ValueError(
+                        "server_id is required in registration configuration. "
+                        "Please specify a server_id or proxy_info.name in your configuration."
+                    )
+            self.server_name = self.registration_config.get("server_name")
             if not self.server_name:
+                # Try to get from proxy_info.name as fallback
+                self.server_name = self.registration_config.get("proxy_info", {}).get("name")
+                if not self.server_name:
+                    raise ValueError(
+                        "server_name is required in registration configuration. "
+                        "Please specify a server_name or proxy_info.name in your configuration."
+                    )
+            self.description = self.registration_config.get("description")
+            if not self.description:
+                # Try to get from proxy_info.description as fallback
+                self.description = self.registration_config.get("proxy_info", {}).get("description")
+                if not self.description:
+                    raise ValueError(
+                        "description is required in registration configuration. "
+                        "Please specify a description or proxy_info.description in your configuration."
+                    )
+        else:
+            self.server_id = None
+            self.server_name = None
+            self.description = None
+            
+        if self.enabled:
+            self.version = self.registration_config.get("version")
+            if not self.version:
+                # Try to get from proxy_info.version as fallback
+                self.version = self.registration_config.get("proxy_info", {}).get("version")
+                if not self.version:
+                    raise ValueError(
+                        "version is required in registration configuration. "
+                        "Please specify a version or proxy_info.version in your configuration."
+                    )
+        else:
+            self.version = None
+
+        # Heartbeat settings - only validate if enabled
+        if self.enabled:
+            heartbeat_config = self.registration_config.get("heartbeat", {})
+            self.timeout = heartbeat_config.get("timeout")
+            if self.timeout is None:
                 raise ValueError(
-                    "server_name is required in registration configuration. "
-                    "Please specify a server_name or proxy_info.name in your configuration."
+                    "heartbeat.timeout is required in registration configuration. "
+                    "Please specify a timeout value."
                 )
-        self.description = self.registration_config.get("description")
-        if not self.description:
-            # Try to get from proxy_info.description as fallback
-            self.description = self.registration_config.get("proxy_info", {}).get("description")
-            if not self.description:
+            self.retry_attempts = heartbeat_config.get("retry_attempts")
+            if self.retry_attempts is None:
                 raise ValueError(
-                    "description is required in registration configuration. "
-                    "Please specify a description or proxy_info.description in your configuration."
+                    "heartbeat.retry_attempts is required in registration configuration. "
+                    "Please specify a retry_attempts value."
                 )
-        self.version = self.registration_config.get("version")
-        if not self.version:
-            # Try to get from proxy_info.version as fallback
-            self.version = self.registration_config.get("proxy_info", {}).get("version")
-            if not self.version:
+        else:
+            self.timeout = None
+            self.retry_attempts = None
+            
+        if self.enabled:
+            self.retry_delay = heartbeat_config.get("retry_delay")
+            if self.retry_delay is None:
                 raise ValueError(
-                    "version is required in registration configuration. "
-                    "Please specify a version or proxy_info.version in your configuration."
+                    "heartbeat.retry_delay is required in registration configuration. "
+                    "Please specify a retry_delay value."
                 )
-
-        # Heartbeat settings
-        heartbeat_config = self.registration_config.get("heartbeat", {})
-        self.timeout = heartbeat_config.get("timeout")
-        if self.timeout is None:
-            raise ValueError(
-                "heartbeat.timeout is required in registration configuration. "
-                "Please specify a timeout value."
-            )
-        self.retry_attempts = heartbeat_config.get("retry_attempts")
-        if self.retry_attempts is None:
-            raise ValueError(
-                "heartbeat.retry_attempts is required in registration configuration. "
-                "Please specify a retry_attempts value."
-            )
-        self.retry_delay = heartbeat_config.get("retry_delay")
-        if self.retry_delay is None:
-            raise ValueError(
-                "heartbeat.retry_delay is required in registration configuration. "
-                "Please specify a retry_delay value."
-            )
-        self.heartbeat_interval = heartbeat_config.get("interval")
-        if self.heartbeat_interval is None:
-            raise ValueError(
-                "heartbeat.interval is required in registration configuration. "
-                "Please specify an interval value."
-            )
+        else:
+            self.retry_delay = None
+            
+        if self.enabled:
+            self.heartbeat_interval = heartbeat_config.get("interval")
+            if self.heartbeat_interval is None:
+                raise ValueError(
+                    "heartbeat.interval is required in registration configuration. "
+                    "Please specify an interval value."
+                )
+        else:
+            self.heartbeat_interval = None
 
         # Auto registration settings
-        self.auto_register = self.registration_config.get("enabled")
-        if self.auto_register is None:
-            raise ValueError(
-                "enabled is required in registration configuration. "
-                "Please specify whether registration is enabled (true/false)."
-            )
+        if self.enabled:
+            self.auto_register = self.registration_config.get("enabled")
+            if self.auto_register is None:
+                raise ValueError(
+                    "enabled is required in registration configuration. "
+                    "Please specify whether registration is enabled (true/false)."
+                )
+        else:
+            self.auto_register = False
+            
         self.auto_unregister = True  # Always unregister on shutdown
 
         # Initialize client security manager
@@ -168,7 +200,7 @@ class ProxyRegistrationManager:
         Returns:
             True if registration is enabled, False otherwise.
         """
-        return self.registration_config.get("enabled", False)
+        return self.enabled
 
     def set_server_url(self, server_url: str) -> None:
         """