mcp-proxy-adapter 6.2.5__py3-none-any.whl → 6.2.7__py3-none-any.whl

mcp_proxy_adapter/__main__.py

@@ -16,7 +16,7 @@ from mcp_proxy_adapter.api.app import create_app
 
 def main():
     """Main CLI entry point."""
-    print("MCP Proxy Adapter v6.2.5")
+    print("MCP Proxy Adapter v6.2.7")
     print("========================")
     print()
     print("Usage:")

mcp_proxy_adapter/examples/__init__.py

@@ -13,4 +13,4 @@ Examples include:
 For detailed documentation, see the main README.md file.
 """
 
-__version__ = "6.2.5"
+__version__ = "6.2.7"

mcp_proxy_adapter/examples/basic_framework/__init__.py

@@ -2,6 +2,8 @@
 
 This example demonstrates the fundamental usage of MCP Proxy Adapter
 with minimal configuration and basic command registration.
-"""
 
-from .main import app
+Note: This package provides a basic example of MCP Proxy Adapter usage.
+The main application is created dynamically in main.py and not exported
+as a global variable for this example.
+"""

mcp_proxy_adapter/examples/generate_certificates.py

@@ -2,105 +2,176 @@
 """
 Certificate Generation Script
 This script generates all necessary certificates for the examples using
-mcp_security_framework certificate management tools.
+mcp_security_framework API directly.
 Author: Vasiliy Zdanovskiy
 email: vasilyvz@gmail.com
 """
 import os
-import subprocess
 import sys
 from pathlib import Path
-def run_command(cmd, description):
-    """Run a command and handle errors."""
-    print(f"🔧 {description}...")
-    try:
-        result = subprocess.run(cmd, shell=True, check=True, capture_output=True, text=True)
-        print(f"✅ {description} completed successfully")
-        return True
-    except subprocess.CalledProcessError as e:
-        print(f"❌ {description} failed: {e}")
-        print(f"Error output: {e.stderr}")
-        return False
+from datetime import datetime, timedelta, timezone
+
 def main():
     """Generate all certificates for examples."""
     print("🔐 Certificate Generation Script")
     print("=" * 50)
+
     # Create directories
     cert_dir = Path("certs")
+    key_dir = Path("keys")
     cert_dir.mkdir(exist_ok=True)
+    key_dir.mkdir(exist_ok=True)
+
     # Check if mcp_security_framework is available
     try:
-        import mcp_security_framework
-        print(f"✅ mcp_security_framework version {mcp_security_framework.__version__} found")
-    except ImportError:
-        print("❌ mcp_security_framework not found")
-        return False
-    # Generate CA certificate
-    if not run_command(
-        "python -m mcp_security_framework.cli.cert_cli create-ca "
-        "--common-name 'MCP Proxy Adapter CA' "
-        "--organization 'MCP Proxy Adapter' "
-        "--country 'US' "
-        "--state 'State' "
-        "--locality 'City' "
-        "--validity-years 10 "
-        "--key-size 2048",
-        "Creating root CA certificate"
-    ):
-        return False
-    # Generate server certificate
-    if not run_command(
-        "python -m mcp_security_framework.cli.cert_cli -c cert_config.json create-server "
-        "--common-name 'localhost' "
-        "--organization 'MCP Proxy Adapter' "
-        "--country 'US' "
-        "--validity-days 365 "
-        "--key-size 2048",
-        "Creating server certificate"
-    ):
+        from mcp_security_framework.core.cert_manager import CertificateManager
+        from mcp_security_framework.schemas import (
+            CAConfig, ServerCertConfig, ClientCertConfig, CertificateConfig
+        )
+        print("✅ mcp_security_framework API available")
+    except ImportError as e:
+        print(f"❌ mcp_security_framework not found: {e}")
         return False
-    # Generate admin client certificate
-    if not run_command(
-        "python -m mcp_security_framework.cli.cert_cli -c cert_config.json create-client "
-        "--common-name 'admin' "
-        "--organization 'MCP Proxy Adapter' "
-        "--country 'US' "
-        "--validity-days 365 "
-        "--key-size 2048 "
-        "--roles 'admin' "
-        "--permissions 'read,write,delete'",
-        "Creating admin client certificate"
-    ):
-        return False
-    # Generate user client certificate
-    if not run_command(
-        "python -m mcp_security_framework.cli.cert_cli -c cert_config.json create-client "
-        "--common-name 'user' "
-        "--organization 'MCP Proxy Adapter' "
-        "--country 'US' "
-        "--validity-days 365 "
-        "--key-size 2048 "
-        "--roles 'user' "
-        "--permissions 'read,write'",
-        "Creating user client certificate"
-    ):
-        return False
-    # Generate readonly client certificate
-    if not run_command(
-        "python -m mcp_security_framework.cli.cert_cli -c cert_config.json create-client "
-        "--common-name 'readonly' "
-        "--organization 'MCP Proxy Adapter' "
-        "--country 'US' "
-        "--validity-days 365 "
-        "--key-size 2048 "
-        "--roles 'readonly' "
-        "--permissions 'read'",
-        "Creating readonly client certificate"
-    ):
+
+    try:
+        print("🔧 Creating root CA certificate...")
+        
+        # Initialize certificate manager first
+        cert_config = CertificateConfig(
+            cert_storage_path=str(cert_dir),
+            key_storage_path=str(key_dir),
+            default_validity_days=365,
+            key_size=2048,
+            hash_algorithm="sha256"
+        )
+        cert_manager = CertificateManager(cert_config)
+        
+        # Create CA certificate using API
+        ca_config = CAConfig(
+            common_name="MCP Proxy Adapter CA",
+            organization="MCP Proxy Adapter",
+            organizational_unit="Development",
+            country="US",
+            state="State",
+            locality="City",
+            validity_years=10,
+            key_size=2048,
+            hash_algorithm="sha256"
+        )
+        
+        ca_cert_pair = cert_manager.create_root_ca(ca_config)
+        if not ca_cert_pair or not ca_cert_pair.certificate_path:
+            print("❌ Failed to create CA certificate")
+            return False
+            
+        ca_cert_path = ca_cert_pair.certificate_path
+        ca_key_path = ca_cert_pair.private_key_path
+        print(f"✅ Root CA certificate created: {ca_cert_path}")
+
+        print("🔧 Creating server certificate...")
+        # Create server certificate
+        server_config = ServerCertConfig(
+            common_name="localhost",
+            organization="MCP Proxy Adapter",
+            country="US",
+            validity_days=365,
+            key_size=2048,
+            subject_alt_names=["localhost", "127.0.0.1"],
+            ca_cert_path=str(ca_cert_path),
+            ca_key_path=str(ca_key_path)
+        )
+
+        server_cert_pair = cert_manager.create_server_certificate(server_config)
+        print(f"✅ Server certificate created: {server_cert_pair.certificate_path}")
+
+        print("🔧 Creating admin client certificate...")
+        # Create admin client certificate
+        admin_config = ClientCertConfig(
+            common_name="admin",
+            organization="MCP Proxy Adapter",
+            country="US",
+            validity_days=365,
+            key_size=2048,
+            roles=["admin"],
+            permissions=["read", "write", "delete"],
+            ca_cert_path=str(ca_cert_path),
+            ca_key_path=str(ca_key_path)
+        )
+
+        admin_cert_pair = cert_manager.create_client_certificate(admin_config)
+        print(f"✅ Admin client certificate created: {admin_cert_pair.certificate_path}")
+
+        print("🔧 Creating user client certificate...")
+        # Create user client certificate
+        user_config = ClientCertConfig(
+            common_name="user",
+            organization="MCP Proxy Adapter",
+            country="US",
+            validity_days=365,
+            key_size=2048,
+            roles=["user"],
+            permissions=["read", "write"],
+            ca_cert_path=str(ca_cert_path),
+            ca_key_path=str(ca_key_path)
+        )
+
+        user_cert_pair = cert_manager.create_client_certificate(user_config)
+        print(f"✅ User client certificate created: {user_cert_pair.certificate_path}")
+
+        print("🔧 Creating readonly client certificate...")
+        # Create readonly client certificate
+        readonly_config = ClientCertConfig(
+            common_name="readonly",
+            organization="MCP Proxy Adapter",
+            country="US",
+            validity_days=365,
+            key_size=2048,
+            roles=["readonly"],
+            permissions=["read"],
+            ca_cert_path=str(ca_cert_path),
+            ca_key_path=str(ca_key_path)
+        )
+
+        readonly_cert_pair = cert_manager.create_client_certificate(readonly_config)
+        print(f"✅ Readonly client certificate created: {readonly_cert_pair.certificate_path}")
+
+        print("\n🎉 All certificates generated successfully!")
+        print(f"📁 Certificates are stored in the '{cert_dir}' directory")
+        print(f"🔑 Private keys are stored in the '{key_dir}' directory")
+        print(f"🔐 CA certificate: {ca_cert_path}")
+        print(f"🔐 Server certificate: {server_cert_pair.certificate_path}")
+        
+        print("\n" + "=" * 60)
+        print("✅ CERTIFICATE GENERATION COMPLETED SUCCESSFULLY")
+        print("=" * 60)
+        print("\n📋 NEXT STEPS:")
+        print("1. Generate test configurations:")
+        print("   python -m mcp_proxy_adapter.examples.generate_test_configs --output-dir configs")
+        print("\n2. Run security tests:")
+        print("   python -m mcp_proxy_adapter.examples.run_security_tests")
+        print("\n3. Start basic framework example:")
+        print("   python -m mcp_proxy_adapter.examples.basic_framework.main --config configs/https_simple.json")
+        print("=" * 60)
+        return True
+
+    except Exception as e:
+        print(f"\n❌ CERTIFICATE GENERATION FAILED: {e}")
+        print("=" * 60)
+        import traceback
+        traceback.print_exc()
+        print("\n🔧 TROUBLESHOOTING:")
+        print("1. Check if mcp_security_framework is installed:")
+        print("   pip install mcp_security_framework")
+        print("\n2. Verify write permissions in current directory")
+        print("\n3. Check if certs/ and keys/ directories exist")
+        print("=" * 60)
         return False
-    print("\n🎉 All certificates generated successfully!")
-    print("📁 Certificates are stored in the 'certs' directory")
-    return True
+
 if __name__ == "__main__":
+    print("🔐 Starting certificate generation...")
     success = main()
+    if success:
+        print("\n✅ Script completed successfully!")
+    else:
+        print("\n❌ Script failed with errors!")
     sys.exit(0 if success else 1)

mcp_proxy_adapter/examples/generate_test_configs.py

@@ -182,6 +182,18 @@ def generate_all_configs(output_dir: str) -> None:
             json.dump(roles_config, f, indent=2, ensure_ascii=False)
         print(f"Generated: {certs_roles_filename}")
     print(f"\nGenerated {len(configs)} configuration files and roles.json in {output_dir}")
+    
+    print("\n" + "=" * 60)
+    print("✅ CONFIGURATION GENERATION COMPLETED SUCCESSFULLY")
+    print("=" * 60)
+    print("\n📋 NEXT STEPS:")
+    print("1. Run security tests:")
+    print("   python -m mcp_proxy_adapter.examples.run_security_tests")
+    print("\n2. Start basic framework example:")
+    print("   python -m mcp_proxy_adapter.examples.basic_framework.main --config configs/https_simple.json")
+    print("\n3. Start full application example:")
+    print("   python -m mcp_proxy_adapter.examples.full_application.main --config configs/mtls_with_roles.json")
+    print("=" * 60)
 def main():
     """Main function for command line execution."""
     parser = argparse.ArgumentParser(
@@ -197,7 +209,13 @@ def main():
         generate_all_configs(args.output_dir)
         print("Configuration generation completed successfully!")
     except Exception as e:
-        print(f"Error generating configurations: {e}")
+        print(f"\n❌ CONFIGURATION GENERATION FAILED: {e}")
+        print("=" * 60)
+        print("\n🔧 TROUBLESHOOTING:")
+        print("1. Check if output directory is writable")
+        print("2. Verify JSON encoding support")
+        print("3. Check available disk space")
+        print("=" * 60)
         return 1
     return 0
 if __name__ == "__main__":

mcp_proxy_adapter/examples/run_security_tests.py

@@ -19,10 +19,8 @@ import sys
 import time
 from pathlib import Path
 from typing import Dict, List, Optional, Any
-# Add project root to path
-project_root = Path(__file__).parent.parent.parent
-sys.path.insert(0, str(project_root))
-from security_test_client import SecurityTestClient, TestResult
+# Import security test client with proper module path
+from mcp_proxy_adapter.examples.security_test_client import SecurityTestClient, TestResult
 class SecurityTestRunner:
     """Main test runner for security testing."""
     def __init__(self):
@@ -207,10 +205,36 @@ class SecurityTestRunner:
         # Overall status
         if total_passed == total_tests and total_tests > 0:
             print("🎉 ALL TESTS PASSED!")
+            print("\n" + "=" * 60)
+            print("✅ SECURITY TESTS COMPLETED SUCCESSFULLY")
+            print("=" * 60)
+            print("\n📋 NEXT STEPS:")
+            print("1. Start basic framework example:")
+            print("   python -m mcp_proxy_adapter.examples.basic_framework.main --config configs/https_simple.json")
+            print("\n2. Start full application example:")
+            print("   python -m mcp_proxy_adapter.examples.full_application.main --config configs/mtls_with_roles.json")
+            print("\n3. Test with custom configurations:")
+            print("   python -m mcp_proxy_adapter.examples.basic_framework.main --config configs/http_simple.json")
+            print("=" * 60)
         elif total_passed > 0:
             print("⚠️ SOME TESTS FAILED")
+            print("\n🔧 TROUBLESHOOTING:")
+            print("1. Check if certificates are generated:")
+            print("   python -m mcp_proxy_adapter.examples.generate_certificates")
+            print("\n2. Verify configuration files exist:")
+            print("   python -m mcp_proxy_adapter.examples.generate_test_configs --output-dir configs")
+            print("\n3. Check if ports are available (8000-8005, 8443-8445)")
+            print("=" * 60)
         else:
             print("❌ ALL TESTS FAILED")
+            print("\n🔧 TROUBLESHOOTING:")
+            print("1. Run setup test environment:")
+            print("   python -m mcp_proxy_adapter.examples.setup_test_environment")
+            print("\n2. Generate certificates:")
+            print("   python -m mcp_proxy_adapter.examples.generate_certificates")
+            print("\n3. Generate configurations:")
+            print("   python -m mcp_proxy_adapter.examples.generate_test_configs --output-dir configs")
+            print("=" * 60)
     def cleanup(self):
         """Cleanup all running servers."""
         print("\n🧹 Cleaning up...")

mcp_proxy_adapter/examples/setup_test_environment.py

@@ -5,25 +5,52 @@ email: vasilyvz@gmail.com
 Script for setting up test environment for MCP Proxy Adapter.
 Prepares the test environment with all necessary files and directories.
 Uses mcp_security_framework for certificate generation.
+
+This script accepts an output directory and copies required example files
+and helper scripts into that directory, creating a ready-to-use workspace.
+By default, the current working directory is used, so end-users can run
+it in their project root after installing this framework in a virtual
+environment.
 """
-import os
 import shutil
 import sys
+import argparse
 from pathlib import Path
 # Import mcp_security_framework
 try:
     from mcp_security_framework.core.cert_manager import CertificateManager
-    from mcp_security_framework.schemas.config import CertificateConfig, CAConfig, ServerCertConfig, ClientCertConfig
-    from mcp_security_framework.schemas.models import CertificateType
+    from mcp_security_framework.schemas.config import (
+        CertificateConfig,
+        CAConfig,
+        ServerCertConfig,
+        ClientCertConfig,
+    )
     SECURITY_FRAMEWORK_AVAILABLE = True
 except ImportError:
     SECURITY_FRAMEWORK_AVAILABLE = False
     print("Warning: mcp_security_framework not available")
-def setup_test_environment():
+
+
+def _get_package_paths() -> tuple[Path, Path]:
     """
-    Setup test environment with all necessary files and directories.
+    Resolve source paths for examples and utils relative to this file
+    to avoid importing the package during setup.
+    """
+    pkg_root = Path(__file__).resolve().parents[1]
+    return pkg_root / "examples", pkg_root / "utils"
+
+
+def setup_test_environment(output_dir: Path) -> None:
+    """
+    Setup test environment under output_dir with required files
+    and directories.
+
+    All created directories and copied files are rooted at output_dir
+    so users can run scripts relative to that directory.
     """
     print("🔧 Setting up test environment...")
+    output_dir = output_dir.resolve()
+    output_dir.mkdir(parents=True, exist_ok=True)
     # Create test environment directory structure
     directories = [
         "examples/basic_framework",
@@ -36,57 +63,70 @@ def setup_test_environment():
         "logs"
     ]
     for directory in directories:
-        os.makedirs(directory, exist_ok=True)
-        print(f"✅ Created directory: {directory}")
+        target_dir = output_dir / directory
+        target_dir.mkdir(parents=True, exist_ok=True)
+        print(f"✅ Created directory: {target_dir}")
+    # Resolve package paths
+    examples_src_root, utils_src_root = _get_package_paths()
     # Copy example files
-    source_examples = "../mcp_proxy_adapter/examples"
-    if os.path.exists(source_examples):
-        # Copy basic framework
-        basic_framework_src = os.path.join(source_examples, "basic_framework")
-        if os.path.exists(basic_framework_src):
-            shutil.copytree(basic_framework_src, "examples/basic_framework", dirs_exist_ok=True)
-            print("✅ Copied basic_framework examples")
-        # Copy full application
-        full_application_src = os.path.join(source_examples, "full_application")
-        if os.path.exists(full_application_src):
-            shutil.copytree(full_application_src, "examples/full_application", dirs_exist_ok=True)
-            print("✅ Copied full_application examples")
+    basic_framework_src = examples_src_root / "basic_framework"
+    if basic_framework_src.exists():
+        shutil.copytree(
+            basic_framework_src,
+            output_dir / "examples/basic_framework",
+            dirs_exist_ok=True,
+        )
+        print("✅ Copied basic_framework examples")
+    full_application_src = examples_src_root / "full_application"
+    if full_application_src.exists():
+        shutil.copytree(
+            full_application_src,
+            output_dir / "examples/full_application",
+            dirs_exist_ok=True,
+        )
+        print("✅ Copied full_application examples")
     # Copy utility scripts
-    source_utils = "../mcp_proxy_adapter/utils"
-    if os.path.exists(source_utils):
-        config_generator_src = os.path.join(source_utils, "config_generator.py")
-        if os.path.exists(config_generator_src):
-            shutil.copy2(config_generator_src, "scripts/")
-            print("✅ Copied config_generator.py")
-    # Copy certificate generation script
-    source_examples = "../mcp_proxy_adapter/examples"
-    if os.path.exists(source_examples):
-        cert_script_src = os.path.join(source_examples, "create_certificates_simple.py")
-        if os.path.exists(cert_script_src):
-            shutil.copy2(cert_script_src, "scripts/")
-            print("✅ Copied create_certificates_simple.py")
-        # Copy new certificate generation script
-        cert_tokens_src = os.path.join(source_examples, "generate_certificates_and_tokens.py")
-        if os.path.exists(cert_tokens_src):
-            shutil.copy2(cert_tokens_src, "scripts/")
-            print("✅ Copied generate_certificates_and_tokens.py")
-    print("🎉 Test environment setup completed successfully!")
-def generate_certificates_with_framework():
+    config_generator_src = utils_src_root / "config_generator.py"
+    if config_generator_src.exists():
+        shutil.copy2(config_generator_src, output_dir / "scripts/")
+        print("✅ Copied config_generator.py")
+    # Copy certificate generation scripts
+    create_certs_src = examples_src_root / "create_certificates_simple.py"
+    if create_certs_src.exists():
+        shutil.copy2(create_certs_src, output_dir / "scripts/")
+        print("✅ Copied create_certificates_simple.py")
+    cert_tokens_src = examples_src_root / "generate_certificates_and_tokens.py"
+    if cert_tokens_src.exists():
+        shutil.copy2(cert_tokens_src, output_dir / "scripts/")
+        print("✅ Copied generate_certificates_and_tokens.py")
+    print(
+        "🎉 Test environment setup completed successfully at: {}".format(
+            output_dir
+        )
+    )
+
+
+def generate_certificates_with_framework(output_dir: Path) -> bool:
     """
     Generate certificates using mcp_security_framework.
     """
     if not SECURITY_FRAMEWORK_AVAILABLE:
-        print("❌ mcp_security_framework not available for certificate generation")
+        print(
+            "❌ mcp_security_framework not available for certificate "
+            "generation"
+        )
         return False
     try:
-        print("🔐 Generating certificates using mcp_security_framework...")
+        print(
+            "🔐 Generating certificates using mcp_security_framework..."
+        )
         # Configure certificate manager
         cert_config = CertificateConfig(
-            cert_storage_path="./certs",
-            key_storage_path="./keys",
+            cert_storage_path=str((output_dir / "certs").resolve()),
+            key_storage_path=str((output_dir / "keys").resolve()),
             default_validity_days=365,
             key_size=2048,
-            hash_algorithm="sha256"
+            hash_algorithm="sha256",
         )
         cert_manager = CertificateManager(cert_config)
         # Generate CA certificate
@@ -97,13 +137,15 @@ def generate_certificates_with_framework():
             country="US",
             state="Test State",
             locality="Test City",
-            validity_years=10,  # Используем validity_years вместо validity_days
+            validity_years=10,  # Use validity_years instead of validity_days
             key_size=2048,
-            hash_algorithm="sha256"
+            hash_algorithm="sha256",
         )
         cert_pair = cert_manager.create_root_ca(ca_config)
         if not cert_pair or not cert_pair.certificate_path:
-            print(f"❌ Failed to create CA certificate: Invalid certificate pair")
+            print(
+                "❌ Failed to create CA certificate: Invalid certificate pair"
+            )
             return False
         print("✅ CA certificate created successfully")
         # Find CA key file
@@ -119,22 +161,57 @@ def generate_certificates_with_framework():
             validity_days=365,
             key_size=2048,
             hash_algorithm="sha256",
-            subject_alt_names=["localhost", "127.0.0.1"],  # Используем subject_alt_names вместо san_dns
+            subject_alt_names=[
+                "localhost",
+                "127.0.0.1",
+            ],
             ca_cert_path=cert_pair.certificate_path,
-            ca_key_path=ca_key_path
+            ca_key_path=ca_key_path,
         )
         cert_pair = cert_manager.create_server_certificate(server_config)
         if not cert_pair or not cert_pair.certificate_path:
-            print(f"❌ Failed to create server certificate: Invalid certificate pair")
+            print(
+                "❌ Failed to create server certificate: Invalid certificate "
+                "pair"
+            )
             return False
         print("✅ Server certificate created successfully")
         # Generate client certificates
         client_configs = [
-            ("admin", ["admin"], ["read", "write", "execute", "delete", "admin", "register", "unregister", "heartbeat", "discover"]),
-            ("user", ["user"], ["read", "execute", "register", "unregister", "heartbeat", "discover"]),
+            (
+                "admin",
+                ["admin"],
+                [
+                    "read",
+                    "write",
+                    "execute",
+                    "delete",
+                    "admin",
+                    "register",
+                    "unregister",
+                    "heartbeat",
+                    "discover",
+                ],
+            ),
+            (
+                "user",
+                ["user"],
+                [
+                    "read",
+                    "execute",
+                    "register",
+                    "unregister",
+                    "heartbeat",
+                    "discover",
+                ],
+            ),
             ("readonly", ["readonly"], ["read", "discover"]),
             ("guest", ["guest"], ["read", "discover"]),
-            ("proxy", ["proxy"], ["register", "unregister", "heartbeat", "discover"])
+            (
+                "proxy",
+                ["proxy"],
+                ["register", "unregister", "heartbeat", "discover"],
+            ),
         ]
         for client_name, roles, permissions in client_configs:
             client_config = ClientCertConfig(
@@ -154,26 +231,86 @@ def generate_certificates_with_framework():
             )
             cert_pair = cert_manager.create_client_certificate(client_config)
             if not cert_pair or not cert_pair.certificate_path:
-                print(f"❌ Failed to create client certificate {client_name}: Invalid certificate pair")
+                print(
+                    (
+                        "❌ Failed to create client certificate {}: "
+                        "Invalid certificate pair"
+                    ).format(client_name)
+                )
                 return False
-            print(f"✅ Client certificate {client_name} created successfully")
-        print("🎉 All certificates generated successfully using mcp_security_framework!")
+            print(
+                "✅ Client certificate {} created successfully".format(
+                    client_name
+                )
+            )
+        print(
+            "🎉 All certificates generated successfully using "
+            "mcp_security_framework!"
+        )
         return True
     except Exception as e:
-        print(f"❌ Error generating certificates with framework: {e}")
+        print("❌ Error generating certificates with framework: {}".format(e))
+        print("\n🔧 TROUBLESHOOTING:")
+        print("1. Check if mcp_security_framework is installed:")
+        print("   pip install mcp_security_framework")
+        print("\n2. Verify write permissions in output directory")
+        print("\n3. Check if certs/ and keys/ directories exist")
         return False
-def main():
+
+
+def main() -> int:
     """Main function for command line execution."""
+    parser = argparse.ArgumentParser(
+        description="Setup test environment for MCP Proxy Adapter"
+    )
+    parser.add_argument(
+        "--output-dir",
+        "-o",
+        type=str,
+        default=".",
+        help=(
+            "Target directory to create the test environment "
+            "(default: current directory)"
+        ),
+    )
+    args = parser.parse_args()
     try:
-        setup_test_environment()
+        target_root = Path(args.output_dir)
+        setup_test_environment(target_root)
         # Generate certificates if framework is available
         if SECURITY_FRAMEWORK_AVAILABLE:
-            generate_certificates_with_framework()
+            generate_certificates_with_framework(target_root)
         else:
-            print("⚠️ Skipping certificate generation (mcp_security_framework not available)")
+            print(
+                "⚠️ Skipping certificate generation (mcp_security_framework "
+                "not available)"
+            )
     except Exception as e:
-        print(f"❌ Error setting up test environment: {e}", file=sys.stderr)
+        print(
+            "❌ Error setting up test environment: {}".format(e),
+            file=sys.stderr,
+        )
+        print("\n🔧 TROUBLESHOOTING:")
+        print("1. Check if output directory is writable")
+        print("2. Verify mcp_security_framework installation")
+        print("3. Check available disk space")
         return 1
+    
+    print("\n" + "=" * 60)
+    print("✅ TEST ENVIRONMENT SETUP COMPLETED SUCCESSFULLY")
+    print("=" * 60)
+    print("\n📋 NEXT STEPS:")
+    print("1. Generate test configurations:")
+    print("   python -m mcp_proxy_adapter.examples.generate_test_configs --output-dir configs")
+    print("\n2. Generate additional certificates (if needed):")
+    print("   python -m mcp_proxy_adapter.examples.generate_certificates")
+    print("\n3. Run security tests:")
+    print("   python -m mcp_proxy_adapter.examples.run_security_tests")
+    print("\n4. Start basic framework example:")
+    print("   python -m mcp_proxy_adapter.examples.basic_framework.main --config configs/https_simple.json")
+    print("=" * 60)
     return 0
+
+
 if __name__ == "__main__":
     exit(main())

mcp_proxy_adapter/version.py

@@ -2,5 +2,5 @@
 Version information for MCP Proxy Adapter.
 """
 
-__version__ = "6.2.5"
+__version__ = "6.2.7"
 

{mcp_proxy_adapter-6.2.5.dist-info → mcp_proxy_adapter-6.2.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-proxy-adapter
-Version: 6.2.5
+Version: 6.2.7
 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
@@ -34,7 +34,7 @@ Requires-Dist: docstring-parser<1.0.0,>=0.15
 Requires-Dist: typing-extensions<5.0.0,>=4.5.0
 Requires-Dist: jsonrpc>=1.2.0
 Requires-Dist: psutil>=5.9.0
-Requires-Dist: mcp_security_framework>=1.1.1
+Requires-Dist: mcp_security_framework>=1.1.2
 Requires-Dist: packaging>=20.0
 Requires-Dist: aiohttp<4.0.0,>=3.8.0
 Requires-Dist: requests<3.0.0,>=2.28.0
@@ -650,7 +650,7 @@ MIT License - see [LICENSE](https://github.com/maverikod/mcp-proxy-adapter/blob/
 
 ## 📊 Version
 
-**6.2.5** - Production-ready release with comprehensive security, proxy registration, and PyPI optimization.
+**6.2.7** - Production-ready release with comprehensive security, proxy registration, and PyPI optimization.
 
 ---
 

{mcp_proxy_adapter-6.2.5.dist-info → mcp_proxy_adapter-6.2.7.dist-info}/RECORD

@@ -1,10 +1,10 @@
 mcp_proxy_adapter/__init__.py,sha256=B7m1YWyv_Wb87-Q-JqVpHQgwajnfIgDyZ_iIxzdTbBY,1021
-mcp_proxy_adapter/__main__.py,sha256=l-rGcgJ0-YLmyL85-4FVItBoLHeTd35XDIXaeXRdx90,768
+mcp_proxy_adapter/__main__.py,sha256=CeNc01hXwosGurxshp_WNFDZxFif828qJgI0TZGQ-pM,768
 mcp_proxy_adapter/config.py,sha256=z4rUbJdxYj6vYw05OM_kMXs1Qn2HRQXGHI9PB4hgPd4,12867
 mcp_proxy_adapter/custom_openapi.py,sha256=jYUrCy8C1mShh3sjKj-JkzSMLAvxDLTvtzSJFj5HUNg,15023
 mcp_proxy_adapter/main.py,sha256=_DJwMZdN0393UR-U7xfQh59EpbDDgv1oWPFf-v2MoII,2147
 mcp_proxy_adapter/openapi.py,sha256=36vOEbJjGnVZR6hUhl6mHCD29HYOEFKo2bL0JdGSm-4,13952
-mcp_proxy_adapter/version.py,sha256=tG-J_zC_jpjNn5fUzw8RKMlzNS4-LeIZtsHtixap-8I,75
+mcp_proxy_adapter/version.py,sha256=flte9zg9fbWIFffeX5r6wgvBlCScZw8l_4KySxkON6U,75
 mcp_proxy_adapter/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_proxy_adapter/api/app.py,sha256=pYrsDWhZAYoYbxujD0MGeOWdTnBUGueIGmZqeAbaB9A,27884
 mcp_proxy_adapter/api/handlers.py,sha256=DcZT7MVBV33q-0EJ0iFqxE0VgBkFt6d_SqoRkntwyvc,8477
@@ -80,26 +80,26 @@ mcp_proxy_adapter/core/ssl_utils.py,sha256=_2mhpuoiRpSbUBifnQvtuziQfBRrXQUKtB58A
 mcp_proxy_adapter/core/transport_manager.py,sha256=ppcgjO-7Ulrk1ovlzlXVM89Iw4VOGA3awKgLf7FFAJ0,9518
 mcp_proxy_adapter/core/unified_config_adapter.py,sha256=cpN_VrliIFGDH3JsfRkTlFdQvLcmuMYYedq0QEzlb0Y,22857
 mcp_proxy_adapter/core/utils.py,sha256=ly8Ttg2v1OBukThJLxudRvmttU1hxJFLJUfat4b2dOI,3268
-mcp_proxy_adapter/examples/__init__.py,sha256=wZIo2CYE6elIsJy6gju87CyJ7bz1BWxmtDoEwivdsTA,449
+mcp_proxy_adapter/examples/__init__.py,sha256=5YV71gn4exEXLcxCTWmCuxKchJjcof9idtLZdb02orU,449
 mcp_proxy_adapter/examples/create_certificates_simple.py,sha256=2KS-s3amvAqasvdh-cxY7ARuFAHVjtbtr_EJF2SKVQ0,23221
 mcp_proxy_adapter/examples/debug_request_state.py,sha256=x_H3NIlkmIS6lZimvEM6kCXxGdpgFw99Sdui8qa_qeU,4347
 mcp_proxy_adapter/examples/debug_role_chain.py,sha256=33l2Tk5mrcnwPFwqm2NTHcrWaJrXUU2wxW2I6Y4uIg4,8344
 mcp_proxy_adapter/examples/demo_client.py,sha256=inic-FP5qG8oQXUaCrtEhmhac_PDZ1pcxp-M1cxSzwA,10240
 mcp_proxy_adapter/examples/generate_all_certificates.py,sha256=rgcwqIkQ1eDfEIRFRXGIOz-jOSS1w0GPBRhYvMl6Vjc,16948
-mcp_proxy_adapter/examples/generate_certificates.py,sha256=KxsltDvO_qpN0MsRv6mCSog-gcEtI18ECyNzpNbKBVw,3672
+mcp_proxy_adapter/examples/generate_certificates.py,sha256=A34OHUEiFvINOHrm3_JiDSbp-WG-eQXIvKCsE8JAeXQ,6616
 mcp_proxy_adapter/examples/generate_certificates_and_tokens.py,sha256=J0qHm_BMY8RYqfuwf7V7xKsHcsRJx8E7x-8JxmW5sPw,15988
-mcp_proxy_adapter/examples/generate_test_configs.py,sha256=RoasOwO1B6gFaP4b6PjFTKsLSX_saBDhrgNbarpTufI,7648
+mcp_proxy_adapter/examples/generate_test_configs.py,sha256=AJqsB7sP-tYuOD49MiWBo-CkpdRd92XYQ8m31rPFiFg,8495
 mcp_proxy_adapter/examples/proxy_registration_example.py,sha256=g59_QG2D1CCqhIXEvgy2XmgXI3toLmLyH7hL3uHZwC8,12647
 mcp_proxy_adapter/examples/run_example.py,sha256=o8rcy9Xo0UuZG4MpKdex3pFWYdtAi6uW8dEBQE6Yzbw,2539
-mcp_proxy_adapter/examples/run_security_tests.py,sha256=xUzsOwKEblZrPFFc-DDfQnWfID9nqGsCvb5VnHtVsT0,10703
+mcp_proxy_adapter/examples/run_security_tests.py,sha256=ERbq9KHhE3MEm2EbbE4eHh649SDRdj0tQahfi0vKJlk,12343
 mcp_proxy_adapter/examples/run_security_tests_fixed.py,sha256=fNQsbALf9548xJ0OGPKYx5Crzg1GbcL8CSh1x_oKu_A,10540
 mcp_proxy_adapter/examples/security_test_client.py,sha256=eBy6pZ5Dhdo-qi_7Fk-IWGHq7zAJA-om8RBuOep4XSs,28022
-mcp_proxy_adapter/examples/setup_test_environment.py,sha256=erLnM5X4ys4wRl3u0wrnPJsy2luUPMfqxoyk6OZGNCU,7953
+mcp_proxy_adapter/examples/setup_test_environment.py,sha256=Y6oNaR95Rmn2csupYoGV-_mMF6AtqJ31vwLhY0TQtMk,11319
 mcp_proxy_adapter/examples/test_config.py,sha256=1X9X8lNlWOcM1ZbIzteeMvLdgxnJEK_ev1BYTZiA9ws,6451
 mcp_proxy_adapter/examples/test_config_generator.py,sha256=SBKL0bv-kUwUUbwrFVbxuA_6pDvK2573Jxm9wPiyI8s,3927
 mcp_proxy_adapter/examples/test_examples.py,sha256=KH095FFEQDMKYZglclr5qy3cW__t3H8VX1l8dvCkQos,12132
 mcp_proxy_adapter/examples/universal_client.py,sha256=IIKGRa0__KoWVla3VnVl-RjkkG_nPpM8vglPm70pV9c,26948
-mcp_proxy_adapter/examples/basic_framework/__init__.py,sha256=XtgxpS3kKQFLDh4onP9XayNTDPzkaAbP0ExkTw9BLkk,184
+mcp_proxy_adapter/examples/basic_framework/__init__.py,sha256=4aYD--R6hy9n9CUxj7Osb9HcdVUMJ6_cfpu4ujkbCwI,345
 mcp_proxy_adapter/examples/basic_framework/main.py,sha256=cDmqeUN1lDBBwuwLjmnP3qIyofCZ3Jr5Ct7Im-qCsUU,1728
 mcp_proxy_adapter/examples/basic_framework/commands/__init__.py,sha256=_VQNLUEdsxUG-4yt9BZI_vtOxHAdGG0OUSsP6Wj-Vz4,76
 mcp_proxy_adapter/examples/basic_framework/hooks/__init__.py,sha256=IE_EIXMnkdXuakZn7wLD9kBFyfDF5lYi56ejgiBeb-A,70
@@ -113,8 +113,8 @@ mcp_proxy_adapter/examples/full_application/commands/dynamic_calculator_command.
 mcp_proxy_adapter/examples/full_application/hooks/__init__.py,sha256=ORG4cL8cSXEMmZ0CEPz75OVuwg54pdDm2GIBpP4dtcs,200
 mcp_proxy_adapter/examples/full_application/hooks/application_hooks.py,sha256=TYXuHI-KW_mH5r8mSKgNMJCr3moeEKrqC4Eex0U298k,3457
 mcp_proxy_adapter/examples/full_application/hooks/builtin_command_hooks.py,sha256=IaskSrckZS6bE3aGxSBL8aTj-iJTSI2ysfsFjhjncyM,2975
-mcp_proxy_adapter-6.2.5.dist-info/licenses/LICENSE,sha256=6KdtUcTwmTRbJrAmYjVn7e6S-V42ubeDJ-AiVEzZ510,1075
-mcp_proxy_adapter-6.2.5.dist-info/METADATA,sha256=FCn3Ohr6kOTW0qOohuLJ0mVSs3Ym0cbBGQQ-NresNPI,22198
-mcp_proxy_adapter-6.2.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-mcp_proxy_adapter-6.2.5.dist-info/top_level.txt,sha256=JZT7vPLBYrtroX-ij68JBhJYbjDdghcV-DFySRy-Nnw,18
-mcp_proxy_adapter-6.2.5.dist-info/RECORD,,
+mcp_proxy_adapter-6.2.7.dist-info/licenses/LICENSE,sha256=6KdtUcTwmTRbJrAmYjVn7e6S-V42ubeDJ-AiVEzZ510,1075
+mcp_proxy_adapter-6.2.7.dist-info/METADATA,sha256=sQ_fhxY9ISs0zMZMHb7ghvbw_i4iTENFef1QvrWsUKI,22198
+mcp_proxy_adapter-6.2.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mcp_proxy_adapter-6.2.7.dist-info/top_level.txt,sha256=JZT7vPLBYrtroX-ij68JBhJYbjDdghcV-DFySRy-Nnw,18
+mcp_proxy_adapter-6.2.7.dist-info/RECORD,,