mcp-proxy-adapter 6.4.10__tar.gz → 6.4.12__tar.gz

mcp_proxy_adapter-6.4.12/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: mcp-proxy-adapter
+Version: 6.4.12
+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
+Author-email: Vasiliy Zdanovskiy <vasilyvz@gmail.com>
+Maintainer: Vasiliy Zdanovskiy
+Maintainer-email: Vasiliy Zdanovskiy <vasilyvz@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/maverikod/mcp-proxy-adapter
+Project-URL: Documentation, https://github.com/maverikod/mcp-proxy-adapter#readme
+Project-URL: Source, https://github.com/maverikod/mcp-proxy-adapter
+Project-URL: Tracker, https://github.com/maverikod/mcp-proxy-adapter/issues
+Project-URL: PyPI, https://pypi.org/project/mcp-proxy-adapter/
+Keywords: json-rpc,microservices,fastapi,security,authentication,authorization,proxy,mcp,mtls,ssl,rest,api
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Framework :: FastAPI
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi<1.0.0,>=0.95.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: hypercorn<1.0.0,>=0.15.0
+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.2
+Requires-Dist: packaging>=20.0
+Requires-Dist: aiohttp<4.0.0,>=3.8.0
+Requires-Dist: requests<3.0.0,>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.20.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Requires-Dist: httpx>=0.24.0; extra == "test"
+Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Provides-Extra: examples
+Dynamic: author
+Dynamic: home-page
+Dynamic: maintainer
+Dynamic: requires-python
+
+# MCP Proxy Adapter
+
+**Author:** Vasiliy Zdanovskiy  
+**Email:** vasilyvz@gmail.com
+
+## Overview
+
+MCP Proxy Adapter is a comprehensive framework for building JSON-RPC API servers with built-in security, SSL/TLS support, and proxy registration capabilities. It provides a unified interface for command execution, protocol management, and security enforcement.
+
+## Features
+
+- **JSON-RPC API**: Full JSON-RPC 2.0 support with built-in commands
+- **Security Framework**: Integrated authentication, authorization, and SSL/TLS
+- **Protocol Management**: HTTP, HTTPS, and mTLS protocol support
+- **Proxy Registration**: Automatic registration with proxy servers
+- **Command System**: Extensible command registry with built-in commands
+- **Configuration Management**: Comprehensive configuration with environment variable overrides
+
+## Quick Start
+
+1. **Installation**:
+   ```bash
+   pip install mcp-proxy-adapter
+   ```
+
+2. **Basic Configuration**:
+   ```bash
+   # Use the comprehensive config with all options disabled by default
+   python -m mcp_proxy_adapter --config config.json
+   ```
+
+3. **Access the API**:
+   - Health check: `GET http://localhost:8000/health`
+   - JSON-RPC: `POST http://localhost:8000/api/jsonrpc`
+   - REST API: `POST http://localhost:8000/cmd`
+   - Documentation: `http://localhost:8000/docs`
+
+## Configuration
+
+The adapter uses a comprehensive JSON configuration file (`config.json`) that includes all available options with sensible defaults. All features are disabled by default and can be enabled as needed:
+
+- **Server settings**: Host, port, debug mode
+- **Security**: Authentication methods, SSL/TLS, permissions
+- **Protocols**: HTTP/HTTPS/mTLS configuration
+- **Proxy registration**: Automatic server registration
+- **Logging**: Comprehensive logging configuration
+- **Commands**: Built-in and custom command management
+
+See `docs/EN/configuration.md` for complete configuration documentation.
+
+## Built-in Commands
+
+- `health` - Server health check
+- `echo` - Echo test command
+- `config` - Configuration management
+- `help` - Command help and documentation
+- `reload` - Configuration reload
+- `settings` - Settings management
+- `load`/`unload` - Command loading/unloading
+- `plugins` - Plugin management
+- `proxy_registration` - Proxy registration control
+- `transport_management` - Transport protocol management
+- `role_test` - Role-based access testing
+
+## Security Features
+
+- **Authentication**: API keys, JWT tokens, certificate-based auth
+- **Authorization**: Role-based permissions with wildcard support
+- **SSL/TLS**: Full SSL/TLS and mTLS support
+- **Rate Limiting**: Configurable request rate limiting
+- **Security Headers**: Automatic security header injection
+
+## Examples
+
+The `mcp_proxy_adapter/examples/` directory contains comprehensive examples for different use cases:
+
+- **Basic Framework**: Simple HTTP server setup
+- **Full Application**: Complete application with custom commands and hooks
+- **Security Testing**: Comprehensive security test suite
+- **Certificate Generation**: SSL/TLS certificate management
+
+## Development
+
+The project follows a modular architecture:
+
+- `mcp_proxy_adapter/api/` - FastAPI application and handlers
+- `mcp_proxy_adapter/commands/` - Command system and built-in commands
+- `mcp_proxy_adapter/core/` - Core functionality and utilities
+- `mcp_proxy_adapter/config.py` - Configuration management
+
+## License
+
+This project is licensed under the MIT License.
+
+## Support
+
+For issues and questions, please contact vasilyvz@gmail.com.

mcp_proxy_adapter-6.4.12/README.md

@@ -0,0 +1,97 @@
+# MCP Proxy Adapter
+
+**Author:** Vasiliy Zdanovskiy  
+**Email:** vasilyvz@gmail.com
+
+## Overview
+
+MCP Proxy Adapter is a comprehensive framework for building JSON-RPC API servers with built-in security, SSL/TLS support, and proxy registration capabilities. It provides a unified interface for command execution, protocol management, and security enforcement.
+
+## Features
+
+- **JSON-RPC API**: Full JSON-RPC 2.0 support with built-in commands
+- **Security Framework**: Integrated authentication, authorization, and SSL/TLS
+- **Protocol Management**: HTTP, HTTPS, and mTLS protocol support
+- **Proxy Registration**: Automatic registration with proxy servers
+- **Command System**: Extensible command registry with built-in commands
+- **Configuration Management**: Comprehensive configuration with environment variable overrides
+
+## Quick Start
+
+1. **Installation**:
+   ```bash
+   pip install mcp-proxy-adapter
+   ```
+
+2. **Basic Configuration**:
+   ```bash
+   # Use the comprehensive config with all options disabled by default
+   python -m mcp_proxy_adapter --config config.json
+   ```
+
+3. **Access the API**:
+   - Health check: `GET http://localhost:8000/health`
+   - JSON-RPC: `POST http://localhost:8000/api/jsonrpc`
+   - REST API: `POST http://localhost:8000/cmd`
+   - Documentation: `http://localhost:8000/docs`
+
+## Configuration
+
+The adapter uses a comprehensive JSON configuration file (`config.json`) that includes all available options with sensible defaults. All features are disabled by default and can be enabled as needed:
+
+- **Server settings**: Host, port, debug mode
+- **Security**: Authentication methods, SSL/TLS, permissions
+- **Protocols**: HTTP/HTTPS/mTLS configuration
+- **Proxy registration**: Automatic server registration
+- **Logging**: Comprehensive logging configuration
+- **Commands**: Built-in and custom command management
+
+See `docs/EN/configuration.md` for complete configuration documentation.
+
+## Built-in Commands
+
+- `health` - Server health check
+- `echo` - Echo test command
+- `config` - Configuration management
+- `help` - Command help and documentation
+- `reload` - Configuration reload
+- `settings` - Settings management
+- `load`/`unload` - Command loading/unloading
+- `plugins` - Plugin management
+- `proxy_registration` - Proxy registration control
+- `transport_management` - Transport protocol management
+- `role_test` - Role-based access testing
+
+## Security Features
+
+- **Authentication**: API keys, JWT tokens, certificate-based auth
+- **Authorization**: Role-based permissions with wildcard support
+- **SSL/TLS**: Full SSL/TLS and mTLS support
+- **Rate Limiting**: Configurable request rate limiting
+- **Security Headers**: Automatic security header injection
+
+## Examples
+
+The `mcp_proxy_adapter/examples/` directory contains comprehensive examples for different use cases:
+
+- **Basic Framework**: Simple HTTP server setup
+- **Full Application**: Complete application with custom commands and hooks
+- **Security Testing**: Comprehensive security test suite
+- **Certificate Generation**: SSL/TLS certificate management
+
+## Development
+
+The project follows a modular architecture:
+
+- `mcp_proxy_adapter/api/` - FastAPI application and handlers
+- `mcp_proxy_adapter/commands/` - Command system and built-in commands
+- `mcp_proxy_adapter/core/` - Core functionality and utilities
+- `mcp_proxy_adapter/config.py` - Configuration management
+
+## License
+
+This project is licensed under the MIT License.
+
+## Support
+
+For issues and questions, please contact vasilyvz@gmail.com.

{mcp_proxy_adapter-6.4.10 → mcp_proxy_adapter-6.4.12}/mcp_proxy_adapter/examples/basic_framework/main.py

@@ -43,8 +43,9 @@ def main():
         title="Basic Framework Example",
         description="Basic MCP Proxy Adapter with minimal configuration",
         version="1.0.0",
-        host=config_overrides.get("host", "0.0.0.0"),
-        log_level="debug" if config_overrides.get("debug", False) else "info",
+        host=config_overrides.get("host"),
+        port=config_overrides.get("port"),
+        debug=config_overrides.get("debug", False),
     ))
 
 

mcp_proxy_adapter-6.4.12/mcp_proxy_adapter/examples/create_test_configs.py

@@ -0,0 +1,301 @@
+#!/usr/bin/env python3
+"""
+Test Configuration Generator
+Creates test configurations by copying the comprehensive config and enabling/disabling specific options.
+Author: Vasiliy Zdanovskiy
+email: vasilyvz@gmail.com
+"""
+import json
+import shutil
+from pathlib import Path
+from typing import Dict, Any, Optional
+
+
+class TestConfigGenerator:
+    """Generator for test configurations based on comprehensive config."""
+
+    def __init__(self, comprehensive_config_path: str, output_dir: str = "configs"):
+        """
+        Initialize the generator.
+        
+        Args:
+            comprehensive_config_path: Path to the comprehensive configuration file
+            output_dir: Directory to output test configurations
+        """
+        self.comprehensive_config_path = Path(comprehensive_config_path)
+        self.output_dir = Path(output_dir)
+        self.output_dir.mkdir(exist_ok=True)
+        
+        # Load the comprehensive config
+        with open(self.comprehensive_config_path, 'r', encoding='utf-8') as f:
+            self.base_config = json.load(f)
+
+    def create_config(self, name: str, modifications: Dict[str, Any]) -> Path:
+        """
+        Create a test configuration with specific modifications.
+        
+        Args:
+            name: Name of the configuration (without .json extension)
+            modifications: Dictionary of modifications to apply
+            
+        Returns:
+            Path to the created configuration file
+        """
+        # Deep copy the base config
+        config = json.loads(json.dumps(self.base_config))
+        
+        # Apply modifications
+        for key, value in modifications.items():
+            self._set_nested_value(config, key, value)
+        
+        # Save the configuration
+        output_path = self.output_dir / f"{name}.json"
+        with open(output_path, 'w', encoding='utf-8') as f:
+            json.dump(config, f, indent=2, ensure_ascii=False)
+        
+        print(f"✅ Created test config: {output_path}")
+        return output_path
+
+    def _set_nested_value(self, config: Dict, key: str, value: Any):
+        """Set a nested value in the configuration using dot notation."""
+        keys = key.split('.')
+        current = config
+        
+        for k in keys[:-1]:
+            if k not in current:
+                current[k] = {}
+            current = current[k]
+        
+        current[keys[-1]] = value
+
+    def create_all_test_configs(self):
+        """Create all standard test configurations."""
+        print("🔧 Creating test configurations from comprehensive config...")
+        
+        # 1. HTTP Simple
+        self.create_config("http_simple", {
+            "server.port": 8001,
+            "ssl.enabled": False,
+            "security.enabled": False,
+            "proxy_registration.enabled": False,
+            "protocols.allowed_protocols": ["http"]
+        })
+        
+        # 2. HTTP with Auth
+        self.create_config("http_auth", {
+            "server.port": 8002,
+            "ssl.enabled": False,
+            "security.enabled": True,
+            "security.auth.enabled": True,
+            "security.auth.methods": ["api_key"],
+            "security.auth.api_keys": {
+                "admin": "admin-secret-key",
+                "user": "user-secret-key"
+            },
+            "proxy_registration.enabled": False,
+            "protocols.allowed_protocols": ["http"]
+        })
+        
+        # 3. HTTPS Simple
+        self.create_config("https_simple", {
+            "server.port": 8003,
+            "ssl.enabled": True,
+            "ssl.cert_file": "certs/localhost_server.crt",
+            "ssl.key_file": "keys/localhost_server.key",
+            "security.enabled": False,
+            "proxy_registration.enabled": False,
+            "protocols.allowed_protocols": ["https"]
+        })
+        
+        # 4. HTTPS with Auth
+        self.create_config("https_auth", {
+            "server.port": 8004,
+            "ssl.enabled": True,
+            "ssl.cert_file": "certs/localhost_server.crt",
+            "ssl.key_file": "keys/localhost_server.key",
+            "security.enabled": True,
+            "security.auth.enabled": True,
+            "security.auth.methods": ["api_key"],
+            "security.auth.api_keys": {
+                "admin": "admin-secret-key",
+                "user": "user-secret-key"
+            },
+            "proxy_registration.enabled": False,
+            "protocols.allowed_protocols": ["https"]
+        })
+        
+        # 5. mTLS Simple
+        self.create_config("mtls_simple", {
+            "server.port": 8005,
+            "ssl.enabled": True,
+            "ssl.cert_file": "certs/localhost_server.crt",
+            "ssl.key_file": "keys/localhost_server.key",
+            "ssl.ca_cert": "certs/mcp_proxy_adapter_ca_ca.crt",
+            "ssl.verify_client": True,
+            "security.enabled": True,
+            "security.auth.enabled": True,
+            "security.auth.methods": ["certificate"],
+            "proxy_registration.enabled": False,
+            "protocols.allowed_protocols": ["https", "mtls"]
+        })
+        
+        # 6. mTLS with Roles
+        self.create_config("mtls_with_roles", {
+            "server.port": 8006,
+            "ssl.enabled": True,
+            "ssl.cert_file": "certs/localhost_server.crt",
+            "ssl.key_file": "keys/localhost_server.key",
+            "ssl.ca_cert": "certs/mcp_proxy_adapter_ca_ca.crt",
+            "ssl.verify_client": True,
+            "security.enabled": True,
+            "security.auth.enabled": True,
+            "security.auth.methods": ["certificate"],
+            "security.permissions.enabled": True,
+            "security.permissions.roles_file": "configs/roles.json",
+            "proxy_registration.enabled": False,
+            "protocols.allowed_protocols": ["https", "mtls"]
+        })
+        
+        # 6a. mTLS without Roles (for security tests)
+        self.create_config("mtls_no_roles", {
+            "server.port": 8009,
+            "ssl.enabled": True,
+            "ssl.cert_file": "certs/localhost_server.crt",
+            "ssl.key_file": "keys/localhost_server.key",
+            "ssl.ca_cert": "certs/mcp_proxy_adapter_ca_ca.crt",
+            "ssl.verify_client": True,
+            "security.enabled": True,
+            "security.auth.enabled": True,
+            "security.auth.methods": ["certificate"],
+            "security.permissions.enabled": False,
+            "proxy_registration.enabled": False,
+            "protocols.allowed_protocols": ["https", "mtls"]
+        })
+        
+        # 7. mTLS with Proxy Registration
+        self.create_config("mtls_with_proxy", {
+            "server.port": 8007,
+            "ssl.enabled": True,
+            "ssl.cert_file": "certs/localhost_server.crt",
+            "ssl.key_file": "keys/localhost_server.key",
+            "ssl.ca_cert": "certs/mcp_proxy_adapter_ca_ca.crt",
+            "ssl.verify_client": True,
+            "security.enabled": True,
+            "security.auth.enabled": True,
+            "security.auth.methods": ["certificate"],
+            "proxy_registration.enabled": True,
+            "proxy_registration.proxy_url": "http://127.0.0.1:3006",
+            "proxy_registration.server_id": "mcp_test_server",
+            "proxy_registration.server_name": "MCP Test Server",
+            "protocols.allowed_protocols": ["https", "mtls"]
+        })
+        
+        # 8. HTTP with Token Auth (for security tests)
+        self.create_config("http_token", {
+            "server.port": 8010,
+            "ssl.enabled": False,
+            "security.enabled": True,
+            "security.auth.enabled": True,
+            "security.auth.methods": ["api_key"],
+            "security.auth.api_keys": {
+                "admin": "admin-secret-key",
+                "user": "user-secret-key"
+            },
+            "proxy_registration.enabled": False,
+            "protocols.allowed_protocols": ["http"]
+        })
+        
+        # 9. HTTPS with Token Auth (for security tests)
+        self.create_config("https_token", {
+            "server.port": 8011,
+            "ssl.enabled": True,
+            "ssl.cert_file": "certs/localhost_server.crt",
+            "ssl.key_file": "keys/localhost_server.key",
+            "security.enabled": True,
+            "security.auth.enabled": True,
+            "security.auth.methods": ["api_key"],
+            "security.auth.api_keys": {
+                "admin": "admin-secret-key",
+                "user": "user-secret-key"
+            },
+            "proxy_registration.enabled": False,
+            "protocols.allowed_protocols": ["https"]
+        })
+        
+        # 10. Full Featured (everything enabled)
+        self.create_config("full_featured", {
+            "server.port": 8008,
+            "ssl.enabled": True,
+            "ssl.cert_file": "certs/localhost_server.crt",
+            "ssl.key_file": "keys/localhost_server.key",
+            "ssl.ca_cert": "certs/mcp_proxy_adapter_ca_ca.crt",
+            "ssl.verify_client": True,
+            "security.enabled": True,
+            "security.auth.enabled": True,
+            "security.auth.methods": ["certificate", "api_key"],
+            "security.auth.api_keys": {
+                "admin": "admin-secret-key",
+                "user": "user-secret-key"
+            },
+            "security.permissions.enabled": True,
+            "security.permissions.roles_file": "configs/roles.json",
+            "security.rate_limit.enabled": True,
+            "proxy_registration.enabled": True,
+            "proxy_registration.proxy_url": "http://127.0.0.1:3006",
+            "proxy_registration.server_id": "mcp_full_server",
+            "proxy_registration.server_name": "MCP Full Featured Server",
+            "protocols.allowed_protocols": ["http", "https", "mtls", "jsonrpc"]
+        })
+        
+        print(f"✅ Created {10} test configurations in {self.output_dir}")
+
+
+def main():
+    """Main entry point."""
+    import argparse
+    
+    parser = argparse.ArgumentParser(description="Generate test configurations")
+    parser.add_argument(
+        "--comprehensive-config", 
+        default="comprehensive_config.json",
+        help="Path to comprehensive configuration file"
+    )
+    parser.add_argument(
+        "--output-dir",
+        default="configs",
+        help="Output directory for test configurations"
+    )
+    parser.add_argument(
+        "--config-name",
+        help="Create a specific configuration (http_simple, https_auth, mtls_with_roles, etc.)"
+    )
+    parser.add_argument(
+        "--modifications",
+        help="JSON string of modifications to apply (for custom configs)"
+    )
+    
+    args = parser.parse_args()
+    
+    generator = TestConfigGenerator(args.comprehensive_config, args.output_dir)
+    
+    if args.config_name:
+        # Create a specific configuration
+        if args.modifications:
+            modifications = json.loads(args.modifications)
+        else:
+            # Use predefined modifications
+            predefined = {
+                "http_simple": {"server.port": 8001, "ssl.enabled": False, "security.enabled": False},
+                "https_simple": {"server.port": 8003, "ssl.enabled": True},
+                "mtls_simple": {"server.port": 8005, "ssl.enabled": True, "ssl.verify_client": True},
+            }
+            modifications = predefined.get(args.config_name, {})
+        
+        generator.create_config(args.config_name, modifications)
+    else:
+        # Create all test configurations
+        generator.create_all_test_configs()
+
+
+if __name__ == "__main__":
+    main()