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

mcp_proxy_adapter/examples/README.md

@@ -1,124 +0,0 @@
-# MCP Proxy Adapter Examples
-
-This directory contains examples demonstrating different usage patterns of the MCP Proxy Adapter framework.
-
-## Examples Overview
-
-### 1. Basic Server (`basic_server/`)
-Minimal server example with only built-in commands. Demonstrates:
-- Basic framework setup
-- Built-in command discovery
-- Standard JSON-RPC API
-- Backward compatibility with property setting
-
-### 2. Custom Commands Server (`custom_commands/`)
-Advanced server example with custom commands and hooks. Demonstrates:
-- Custom command registration
-- Basic hooks (before/after execution)
-- Global hooks
-- Performance and security monitoring
-- Advanced hooks with data transformation and command interception
-
-## Setting Application Title and Description
-
-The framework supports two ways to set application properties:
-
-### Method 1: During Creation (Recommended)
-```python
-from mcp_proxy_adapter import create_app
-
-app = create_app(
-    title="My Custom Server",
-    description="My custom server description",
-    version="2.0.0"
-)
-```
-
-### Method 2: After Creation (Backward Compatible)
-```python
-from mcp_proxy_adapter import create_app
-
-app = create_app()
-
-# Set properties after creation
-app.set_properties(
-    new_title="My Custom Server",
-    new_description="My custom server description",
-    new_version="2.0.0"
-)
-```
-
-## Running Examples
-
-### Basic Server
-```bash
-cd mcp_proxy_adapter/examples/basic_server
-python server.py
-```
-
-### Custom Commands Server
-```bash
-cd mcp_proxy_adapter/examples/custom_commands
-python server.py
-```
-
-## Testing Examples
-
-### Basic Server Commands
-```bash
-# Get help
-curl -X POST http://localhost:8000/cmd \
-  -H "Content-Type: application/json" \
-  -d '{"jsonrpc": "2.0", "method": "help", "id": 1}'
-
-# Get health
-curl -X POST http://localhost:8000/cmd \
-  -H "Content-Type: application/json" \
-  -d '{"jsonrpc": "2.0", "method": "health", "id": 2}'
-```
-
-### Custom Commands Server Commands
-```bash
-# Test echo command
-curl -X POST http://localhost:8000/cmd \
-  -H "Content-Type: application/json" \
-  -d '{"jsonrpc": "2.0", "method": "echo", "params": {"message": "Hello!"}, "id": 1}'
-
-# Test data transformation
-curl -X POST http://localhost:8000/cmd \
-  -H "Content-Type: application/json" \
-  -d '{"jsonrpc": "2.0", "method": "data_transform", "params": {"data": {"name": "test", "value": 123}}, "id": 2}'
-
-# Test command interception (bypass_flag=0)
-curl -X POST http://localhost:8000/cmd \
-  -H "Content-Type: application/json" \
-  -d '{"jsonrpc": "2.0", "method": "intercept", "params": {"bypass_flag": 0}, "id": 3}'
-
-# Test command execution (bypass_flag=1)
-curl -X POST http://localhost:8000/cmd \
-  -H "Content-Type: application/json" \
-  -d '{"jsonrpc": "2.0", "method": "intercept", "params": {"bypass_flag": 1}, "id": 4}'
-```
-
-## Features Demonstrated
-
-### Basic Server
-- ✅ Standard JSON-RPC API
-- ✅ Built-in command discovery
-- ✅ Basic logging
-- ✅ OpenAPI schema generation
-- ✅ Backward compatibility
-
-### Custom Commands Server
-- ✅ Custom command registration
-- ✅ Command override with priority
-- ✅ Basic hooks (before/after)
-- ✅ Global hooks
-- ✅ Performance monitoring
-- ✅ Security monitoring
-- ✅ Data transformation hooks
-- ✅ Command interception hooks
-- ✅ Conditional processing
-- ✅ Smart interception
-- ✅ Centralized logging
-- ✅ Advanced error handling 

mcp_proxy_adapter/examples/basic_server/README.md

@@ -1,60 +0,0 @@
-# Basic Server Example
-
-A minimal example of MCP Proxy Adapter server without additional commands.
-
-## Features
-
-This example demonstrates:
-- Basic server setup
-- Built-in commands only (help, health)
-- Default configuration
-- No custom commands
-
-## Available Commands
-
-- `help` - Get information about available commands
-- `health` - Get server health status
-
-## Usage
-
-### Run the server
-
-```bash
-python server.py
-```
-
-### Test the server
-
-```bash
-# Get help
-curl -X POST http://localhost:8000/cmd \
-  -H "Content-Type: application/json" \
-  -d '{"command": "help"}'
-
-# Get health status
-curl -X POST http://localhost:8000/cmd \
-  -H "Content-Type: application/json" \
-  -d '{"command": "health"}'
-```
-
-## API Endpoints
-
-- `POST /cmd` - Execute commands
-- `GET /health` - Health check
-- `GET /commands` - List available commands
-- `GET /docs` - API documentation
-
-## Configuration
-
-The server uses default configuration. You can customize it by:
-
-1. Creating a `config.json` file
-2. Setting environment variables
-3. Passing configuration to `create_app()`
-
-## Notes
-
-- This is the simplest possible setup
-- No custom commands are registered
-- Uses framework defaults
-- Good starting point for understanding the framework 

mcp_proxy_adapter/examples/basic_server/__init__.py

@@ -1,7 +0,0 @@
-"""
-Basic Server Example
-
-A minimal example of MCP Proxy Adapter server without additional commands.
-"""
-
-__version__ = "1.0.0" 

mcp_proxy_adapter/examples/basic_server/basic_custom_settings.json

@@ -1,39 +0,0 @@
-{
-  "application": {
-    "name": "Basic MCP Proxy Server with Custom Settings",
-    "version": "1.1.0",
-    "environment": "development",
-    "description": "Basic server demonstrating custom settings usage"
-  },
-  "features": {
-    "basic_logging": true,
-    "simple_commands": true,
-    "custom_settings_demo": true,
-    "file_based_config": true
-  },
-  "server_info": {
-    "description": "Basic server with file-based custom settings",
-    "author": "MCP Proxy Adapter Team",
-    "contact": "support@example.com",
-    "documentation": "https://example.com/docs"
-  },
-  "demo_settings": {
-    "welcome_message": "Welcome to Basic MCP Proxy Server with Custom Settings!",
-    "max_connections": 150,
-    "timeout": 45,
-    "debug_mode": true,
-    "log_level": "INFO"
-  },
-  "performance": {
-    "enable_caching": true,
-    "cache_ttl": 300,
-    "max_cache_size": 1000
-  },
-  "security": {
-    "enable_rate_limiting": false,
-    "max_request_size": "5MB",
-    "allowed_origins": [
-      "*"
-    ]
-  }
-}

mcp_proxy_adapter/examples/basic_server/config.json

@@ -1,70 +0,0 @@
-{
-  "server": {
-    "host": "0.0.0.0",
-    "port": 9443,
-    "debug": true,
-    "log_level": "INFO"
-  },
-  "logging": {
-    "level": "INFO",
-    "log_dir": "./logs",
-    "console_output": true
-  },
-  "commands": {
-    "auto_discovery": true,
-    "discovery_path": "mcp_proxy_adapter.commands"
-  },
-  "ssl": {
-    "enabled": true,
-    "mode": "mtls_only",
-    "cert_file": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/server_test-server.crt",
-    "key_file": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/server_test-server.key",
-    "ca_cert": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/ca_test-ca.crt",
-    "verify_client": true,
-    "client_cert_required": true
-  },
-  "protocols": {
-    "enabled": false,
-    "allowed_protocols": ["https", "mtls"],
-    "http": {
-      "enabled": false,
-      "port": 8000
-    },
-    "https": {
-      "enabled": true,
-      "port": 9443
-    },
-    "mtls": {
-      "enabled": true,
-      "port": 9443
-    }
-  },
-  "roles": {
-    "enabled": true,
-    "config_file": "schemas/roles_schema.json",
-    "default_policy": {
-      "deny_by_default": true,
-      "require_role_match": true,
-      "case_sensitive": false,
-      "allow_wildcard": true
-    },
-    "auto_load": true,
-    "validation_enabled": true
-  },
-  "proxy_registration": {
-    "enabled": true,
-    "proxy_url": "http://localhost:3004",
-    "server_id": "mcp_proxy_adapter_mtls",
-    "server_name": "MTLS MCP Proxy Adapter Server",
-    "description": "JSON-RPC API for interacting with MCP Proxy (MTLS mode)",
-    "registration_timeout": 30,
-    "retry_attempts": 3,
-    "retry_delay": 5,
-    "auto_register_on_startup": true,
-    "auto_unregister_on_shutdown": true
-  },
-  "custom": {
-    "description": "MTLS-only server example with mutual authentication",
-    "server_name": "MTLS MCP Proxy Adapter Server"
-  }
-} 

mcp_proxy_adapter/examples/basic_server/config_all_protocols.json

@@ -1,54 +0,0 @@
-{
-  "server": {
-    "host": "0.0.0.0",
-    "port": 8000,
-    "debug": true,
-    "log_level": "INFO"
-  },
-  "logging": {
-    "level": "INFO",
-    "log_dir": "./logs",
-    "console_output": true
-  },
-  "commands": {
-    "auto_discovery": true,
-    "discovery_path": "mcp_proxy_adapter.commands"
-  },
-  "ssl": {
-    "enabled": true,
-    "mode": "mtls",
-    "cert_file": "../../../test_env/server/server.crt",
-    "key_file": "../../../test_env/server/server.key",
-    "ca_cert": "../../../test_env/ca/ca.crt",
-    "verify_client": true,
-    "client_cert_required": true
-  },
-  "protocols": {
-    "enabled": true,
-    "allowed_protocols": ["http", "https", "mtls"],
-    "http": {
-      "enabled": true,
-      "port": 8000
-    },
-    "https": {
-      "enabled": true,
-      "port": 8443
-    },
-    "mtls": {
-      "enabled": true,
-      "port": 9443
-    }
-  },
-  "proxy_registration": {
-    "enabled": true,
-    "proxy_url": "http://localhost:3004",
-    "server_id": "mcp_proxy_adapter_all_protocols",
-    "server_name": "Multi-Protocol MCP Proxy Adapter Server",
-    "description": "JSON-RPC API for interacting with MCP Proxy (HTTP/HTTPS/MTLS modes)",
-    "registration_timeout": 30,
-    "retry_attempts": 3,
-    "retry_delay": 5,
-    "auto_register_on_startup": true,
-    "auto_unregister_on_shutdown": true
-  }
-} 

mcp_proxy_adapter/examples/basic_server/config_http.json

@@ -1,70 +0,0 @@
-{
-  "server": {
-    "host": "0.0.0.0",
-    "port": 8443,
-    "debug": true,
-    "log_level": "INFO"
-  },
-  "logging": {
-    "level": "INFO",
-    "log_dir": "./logs",
-    "console_output": true
-  },
-  "commands": {
-    "auto_discovery": true,
-    "discovery_path": "mcp_proxy_adapter.commands"
-  },
-  "ssl": {
-    "enabled": true,
-    "mode": "https_only",
-    "cert_file": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/server_test-server.crt",
-    "key_file": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/server_test-server.key",
-    "ca_cert": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/ca_test-ca.crt",
-    "verify_client": false,
-    "client_cert_required": false
-  },
-  "protocols": {
-    "enabled": true,
-    "allowed_protocols": ["https"],
-    "http": {
-      "enabled": false,
-      "port": 8000
-    },
-    "https": {
-      "enabled": true,
-      "port": 8443
-    },
-    "mtls": {
-      "enabled": false,
-      "port": 9443
-    }
-  },
-  "roles": {
-    "enabled": false,
-    "config_file": "schemas/roles_schema.json",
-    "default_policy": {
-      "deny_by_default": false,
-      "require_role_match": false,
-      "case_sensitive": false,
-      "allow_wildcard": true
-    },
-    "auto_load": false,
-    "validation_enabled": false
-  },
-  "proxy_registration": {
-    "enabled": true,
-    "proxy_url": "http://localhost:3004",
-    "server_id": "mcp_proxy_adapter_https",
-    "server_name": "HTTPS MCP Proxy Adapter Server",
-    "description": "JSON-RPC API for interacting with MCP Proxy (HTTPS mode)",
-    "registration_timeout": 30,
-    "retry_attempts": 3,
-    "retry_delay": 5,
-    "auto_register_on_startup": true,
-    "auto_unregister_on_shutdown": true
-  },
-  "custom": {
-    "description": "HTTPS-only server example",
-    "server_name": "HTTPS MCP Proxy Adapter Server"
-  }
-} 

mcp_proxy_adapter/examples/basic_server/config_http_only.json

@@ -1,52 +0,0 @@
-{
-  "server": {
-    "host": "0.0.0.0",
-    "port": 8000,
-    "debug": true,
-    "log_level": "INFO"
-  },
-  "logging": {
-    "level": "INFO",
-    "log_dir": "./logs",
-    "console_output": true
-  },
-  "commands": {
-    "auto_discovery": true,
-    "discovery_path": "mcp_proxy_adapter.commands"
-  },
-  "ssl": {
-    "enabled": false
-  },
-  "protocols": {
-    "enabled": true,
-    "allowed_protocols": ["http"],
-    "http": {
-      "enabled": true,
-      "port": 8000
-    },
-    "https": {
-      "enabled": false,
-      "port": 8443
-    },
-    "mtls": {
-      "enabled": false,
-      "port": 9443
-    }
-  },
-  "proxy_registration": {
-    "enabled": true,
-    "proxy_url": "http://localhost:3004",
-    "server_id": "mcp_proxy_adapter_http",
-    "server_name": "HTTP MCP Proxy Adapter Server",
-    "description": "JSON-RPC API for interacting with MCP Proxy (HTTP mode)",
-    "registration_timeout": 30,
-    "retry_attempts": 3,
-    "retry_delay": 5,
-    "auto_register_on_startup": true,
-    "auto_unregister_on_shutdown": true
-  },
-  "custom": {
-    "description": "HTTP-only server example",
-    "server_name": "HTTP MCP Proxy Adapter Server"
-  }
-} 

mcp_proxy_adapter/examples/basic_server/config_https.json

@@ -1,58 +0,0 @@
-{
-  "server": {
-    "host": "0.0.0.0",
-    "port": 8443,
-    "debug": true,
-    "log_level": "INFO"
-  },
-  "logging": {
-    "level": "INFO",
-    "log_dir": "./logs",
-    "console_output": true
-  },
-  "commands": {
-    "auto_discovery": true,
-    "discovery_path": "mcp_proxy_adapter.commands"
-  },
-  "ssl": {
-    "enabled": true,
-    "mode": "https_only",
-    "cert_file": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/server_test-server.crt",
-    "key_file": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/server_test-server.key",
-    "ca_cert": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/ca_test-ca.crt",
-    "verify_client": false,
-    "client_cert_required": false
-  },
-  "protocols": {
-    "enabled": true,
-    "allowed_protocols": ["https"],
-    "http": {
-      "enabled": false,
-      "port": 8000
-    },
-    "https": {
-      "enabled": true,
-      "port": 8443
-    },
-    "mtls": {
-      "enabled": false,
-      "port": 9443
-    }
-  },
-  "roles": {
-    "enabled": false,
-    "config_file": "schemas/roles_schema.json",
-    "default_policy": {
-      "deny_by_default": false,
-      "require_role_match": false,
-      "case_sensitive": false,
-      "allow_wildcard": true
-    },
-    "auto_load": false,
-    "validation_enabled": false
-  },
-  "custom": {
-    "description": "HTTPS-only server example",
-    "server_name": "HTTPS MCP Proxy Adapter Server"
-  }
-} 

mcp_proxy_adapter/examples/basic_server/config_mtls.json

@@ -1,58 +0,0 @@
-{
-  "server": {
-    "host": "0.0.0.0",
-    "port": 9443,
-    "debug": true,
-    "log_level": "INFO"
-  },
-  "logging": {
-    "level": "INFO",
-    "log_dir": "./logs",
-    "console_output": true
-  },
-  "commands": {
-    "auto_discovery": true,
-    "discovery_path": "mcp_proxy_adapter.commands"
-  },
-  "ssl": {
-    "enabled": true,
-    "mode": "mtls_only",
-    "cert_file": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/server_test-server.crt",
-    "key_file": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/server_test-server.key",
-    "ca_cert": "/home/vasilyvz/projects/mcp_proxy_adapter/test_env/ca_test-ca.crt",
-    "verify_client": true,
-    "client_cert_required": true
-  },
-  "protocols": {
-    "enabled": true,
-    "allowed_protocols": ["mtls"],
-    "http": {
-      "enabled": false,
-      "port": 8000
-    },
-    "https": {
-      "enabled": false,
-      "port": 8443
-    },
-    "mtls": {
-      "enabled": true,
-      "port": 9443
-    }
-  },
-  "roles": {
-    "enabled": true,
-    "config_file": "schemas/roles_schema.json",
-    "default_policy": {
-      "deny_by_default": true,
-      "require_role_match": true,
-      "case_sensitive": false,
-      "allow_wildcard": true
-    },
-    "auto_load": true,
-    "validation_enabled": true
-  },
-  "custom": {
-    "description": "MTLS-only server example with mutual authentication",
-    "server_name": "MTLS MCP Proxy Adapter Server"
-  }
-} 

mcp_proxy_adapter/examples/basic_server/config_ssl.json

@@ -1,46 +0,0 @@
-{
-  "server": {
-    "host": "0.0.0.0",
-    "port": 8443,
-    "debug": false,
-    "log_level": "INFO"
-  },
-  "logging": {
-    "level": "INFO",
-    "log_dir": "./logs",
-    "log_file": "basic_server_ssl.log",
-    "console_output": true,
-    "file_output": true
-  },
-  "commands": {
-    "auto_discovery": true,
-    "commands_directory": "./commands",
-    "catalog_directory": "./catalog",
-    "plugin_servers": [],
-    "auto_install_dependencies": true
-  },
-  "ssl": {
-    "enabled": true,
-    "mode": "https_only",
-    "cert_file": "./certs/server.crt",
-    "key_file": "./certs/server.key",
-    "ca_cert": "./certs/ca.crt",
-    "verify_client": false,
-    "client_cert_required": false,
-    "cipher_suites": [
-      "TLS_AES_256_GCM_SHA384",
-      "TLS_CHACHA20_POLY1305_SHA256",
-      "TLS_AES_128_GCM_SHA256"
-    ],
-    "min_tls_version": "1.2",
-    "max_tls_version": "1.3"
-  },
-  "debug": {
-    "enabled": false,
-    "level": "WARNING"
-  },
-  "custom": {
-    "server_name": "Basic MCP Proxy Adapter Server (SSL)",
-    "description": "Basic server example with SSL/TLS encryption enabled"
-  }
-}