mcp-proxy-adapter 3.1.5__py3-none-any.whl → 4.0.0__py3-none-any.whl

mcp_proxy_adapter/examples/custom_commands/test_hooks.py

@@ -0,0 +1,176 @@
+"""
+Test Hooks Example
+
+This script demonstrates the hooks system by making requests to the server
+and showing how hooks process the commands.
+"""
+
+import requests
+import json
+import time
+
+
+def test_echo_hooks():
+    """Test echo command with hooks."""
+    print("\n🔔 Testing Echo Command with Hooks")
+    print("=" * 50)
+    
+    # Test basic echo
+    response = requests.post(
+        "http://localhost:8000/cmd",
+        json={
+            "command": "echo",
+            "params": {"message": "Hello from hooks!"}
+        }
+    )
+    
+    if response.status_code == 200:
+        result = response.json()
+        print("✅ Echo command executed successfully")
+        print(f"📤 Result: {json.dumps(result, indent=2)}")
+    else:
+        print(f"❌ Error: {response.status_code} - {response.text}")
+
+
+def test_help_hooks():
+    """Test help command with hooks."""
+    print("\n📖 Testing Help Command with Hooks")
+    print("=" * 50)
+    
+    # Test help for all commands
+    response = requests.post(
+        "http://localhost:8000/cmd",
+        json={"command": "help"}
+    )
+    
+    if response.status_code == 200:
+        result = response.json()
+        print("✅ Help command executed successfully")
+        print(f"📚 Total commands: {result.get('total', 0)}")
+        print(f"🔧 Custom features: {result.get('custom_features', {})}")
+    else:
+        print(f"❌ Error: {response.status_code} - {response.text}")
+    
+    # Test help for specific command
+    response = requests.post(
+        "http://localhost:8000/cmd",
+        json={
+            "command": "help",
+            "params": {"cmdname": "echo"}
+        }
+    )
+    
+    if response.status_code == 200:
+        result = response.json()
+        print("✅ Help for echo command executed successfully")
+        print(f"📖 Command info: {result.get('info', {}).get('description', 'N/A')}")
+    else:
+        print(f"❌ Error: {response.status_code} - {response.text}")
+
+
+def test_health_hooks():
+    """Test health command with hooks."""
+    print("\n🏥 Testing Health Command with Hooks")
+    print("=" * 50)
+    
+    response = requests.post(
+        "http://localhost:8000/cmd",
+        json={"command": "health"}
+    )
+    
+    if response.status_code == 200:
+        result = response.json()
+        print("✅ Health command executed successfully")
+        
+        data = result.get("data", {})
+        print(f"🏥 Status: {data.get('status', 'unknown')}")
+        print(f"⏱️  Uptime: {data.get('uptime', 0):.2f}s")
+        
+        custom_metrics = data.get("custom_metrics", {})
+        print(f"🔧 Hook enhanced: {custom_metrics.get('hook_enhanced', False)}")
+        print(f"🆔 Health check ID: {custom_metrics.get('health_check_id', 'N/A')}")
+    else:
+        print(f"❌ Error: {response.status_code} - {response.text}")
+
+
+def test_security_hooks():
+    """Test security hooks with sensitive data."""
+    print("\n🔒 Testing Security Hooks")
+    print("=" * 50)
+    
+    # Test with sensitive parameter
+    response = requests.post(
+        "http://localhost:8000/cmd",
+        json={
+            "command": "echo",
+            "params": {
+                "message": "Test message",
+                "password": "secret123",
+                "api_token": "sensitive_data"
+            }
+        }
+    )
+    
+    if response.status_code == 200:
+        result = response.json()
+        print("✅ Echo command with sensitive data executed")
+        print("🔒 Security hooks should have logged warnings")
+    else:
+        print(f"❌ Error: {response.status_code} - {response.text}")
+
+
+def test_performance_hooks():
+    """Test performance hooks with slow operation simulation."""
+    print("\n⏱️  Testing Performance Hooks")
+    print("=" * 50)
+    
+    # Test with a command that might be slow
+    response = requests.post(
+        "http://localhost:8000/cmd",
+        json={
+            "command": "health",
+            "params": {}
+        }
+    )
+    
+    if response.status_code == 200:
+        result = response.json()
+        print("✅ Health command executed")
+        print("⏱️  Performance hooks should have logged execution time")
+    else:
+        print(f"❌ Error: {response.status_code} - {response.text}")
+
+
+def main():
+    """Run all hook tests."""
+    print("🧪 Testing Custom Commands with Hooks")
+    print("=" * 60)
+    print("Make sure the server is running on http://localhost:8000")
+    print("Check the server logs to see hook activity")
+    print("=" * 60)
+    
+    # Wait a moment for server to be ready
+    time.sleep(1)
+    
+    try:
+        test_echo_hooks()
+        test_help_hooks()
+        test_health_hooks()
+        test_security_hooks()
+        test_performance_hooks()
+        
+        print("\n✅ All tests completed!")
+        print("📋 Check the server logs to see hook activity:")
+        print("   - Command-specific hooks")
+        print("   - Global hooks")
+        print("   - Performance monitoring")
+        print("   - Security monitoring")
+        
+    except requests.exceptions.ConnectionError:
+        print("❌ Could not connect to server. Make sure it's running on http://localhost:8000")
+    except Exception as e:
+        print(f"❌ Error during testing: {e}")
+
+
+if __name__ == "__main__":
+    main() 

mcp_proxy_adapter/examples/deployment/README.md

@@ -0,0 +1,49 @@
+# Deployment Examples
+
+This directory contains deployment examples for the MCP Proxy Adapter framework.
+
+## Files
+
+### Docker Deployment
+- `Dockerfile` - Docker image configuration for the framework
+- `docker-compose.yml` - Docker Compose configuration for easy deployment
+- `run_docker.sh` - Script to run the application in Docker
+
+### Local Deployment
+- `run.sh` - Script to run the application locally
+
+### Configuration Files
+- `config.json` - Default configuration file
+- `config.development.json` - Development environment configuration
+- `config.staging.json` - Staging environment configuration  
+- `config.production.json` - Production environment configuration
+
+## Usage
+
+### Local Development
+```bash
+./run.sh
+```
+
+### Docker Deployment
+```bash
+./run_docker.sh
+```
+
+### Docker Compose
+```bash
+docker-compose up -d
+```
+
+## Configuration
+
+Copy the appropriate configuration file to your project root:
+```bash
+cp config.development.json config.json
+```
+
+## Notes
+
+- These are example configurations and should be customized for your specific use case
+- The framework itself is designed to be used as a library, not as a standalone application
+- Modify the configuration files according to your deployment requirements 

mcp_proxy_adapter/examples/deployment/__init__.py

@@ -0,0 +1,7 @@
+"""
+Deployment Examples
+
+This package contains deployment examples for the MCP Proxy Adapter framework.
+"""
+
+__version__ = "1.0.0" 

mcp_proxy_adapter/examples/deployment/config.development.json

@@ -0,0 +1,8 @@
+{
+  "host": "0.0.0.0",
+  "port": 8000,
+  "log_level": "DEBUG",
+  "log_file": "logs/mcp_proxy.log",
+  "cors_origins": ["*"],
+  "api_keys": ["dev-api-key"]
+} 

{examples/basic_example → mcp_proxy_adapter/examples/deployment}/config.json

@@ -1,25 +1,29 @@
 {
-  "service": {
-    "name": "Basic Example",
-    "version": "1.0.0"
-  },
   "server": {
     "host": "0.0.0.0",
     "port": 8000,
-    "debug": true,
+    "debug": false,
     "log_level": "info"
   },
   "logging": {
     "level": "INFO",
-    "file": "logs/basic_example.log",
+    "file": "adapter.log",
     "rotation": {
       "type": "size",
       "max_bytes": 10485760,
       "backup_count": 5
     }
   },
+  "service": {
+    "name": "MCP Proxy Adapter",
+    "version": "1.0.0"
+  },
   "discovery": {
     "enabled": true,
     "package": "commands"
+  },
+  "docker": {
+    "container_name": "mcp-proxy-adapter",
+    "network": "default"
   }
-} 
+}

mcp_proxy_adapter/examples/deployment/config.production.json

@@ -0,0 +1,12 @@
+{
+  "host": "0.0.0.0",
+  "port": 8000,
+  "log_level": "WARNING",
+  "log_file": "logs/mcp_proxy.log",
+  "log_rotation_type": "time",
+  "log_rotation_when": "D",
+  "log_rotation_interval": 1,
+  "log_rotation_backup_count": 30,
+  "cors_origins": ["https://example.com"],
+  "api_keys": ["${API_KEY}"]
+} 

mcp_proxy_adapter/examples/deployment/config.staging.json

@@ -0,0 +1,11 @@
+{
+  "host": "0.0.0.0",
+  "port": 8000,
+  "log_level": "INFO",
+  "log_file": "logs/mcp_proxy.log",
+  "log_rotation_type": "size",
+  "log_max_bytes": 10485760,
+  "log_backup_count": 5,
+  "cors_origins": ["https://staging.example.com"],
+  "api_keys": ["staging-api-key"]
+} 

mcp_proxy_adapter/examples/deployment/docker-compose.yml

@@ -0,0 +1,31 @@
+version: '3.8'
+
+# Variables for docker-compose
+x-environment: &default-env
+  - CONFIG_PATH=/app/config.json
+  - LOG_LEVEL=INFO
+
+x-volume-mounts: &default-mounts
+  - ./config.json:/app/config.json:ro
+  - ./logs:/app/logs:rw
+  - ./data:/app/data:rw
+  - ./cache:/app/cache:rw
+
+services:
+  mcp-proxy-adapter:
+    container_name: ${CONTAINER_NAME:-mcp-proxy-adapter}
+    build:
+      context: ../../
+      dockerfile: mcp_proxy_adapter/examples/deployment/Dockerfile
+    ports:
+      - "127.0.0.1:${HOST_PORT:-8000}:${SERVICE_PORT:-8000}"
+    volumes: *default-mounts
+    environment: *default-env
+    restart: unless-stopped
+    user: "${USER_ID:-1000}:${GROUP_ID:-1000}"
+    networks:
+      - default
+
+networks:
+  default:
+    driver: bridge 

mcp_proxy_adapter/examples/deployment/run.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+
+# MCP Proxy Adapter - Local Development Script
+# This script runs the framework locally for development
+
+# Variables
+HOST_PORT=${HOST_PORT:-8000}
+CONFIG_PATH=${CONFIG_PATH:-"config.json"}
+LOG_LEVEL=${LOG_LEVEL:-"INFO"}
+
+# Get the project root directory (3 levels up from this script)
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
+
+echo "Starting MCP Proxy Adapter locally..."
+echo "Project root: $PROJECT_ROOT"
+echo "Config path: $CONFIG_PATH"
+echo "Port: $HOST_PORT"
+
+# Activate virtual environment if it exists
+if [ -d "$PROJECT_ROOT/.venv" ]; then
+    echo "Activating virtual environment..."
+    source "$PROJECT_ROOT/.venv/bin/activate"
+fi
+
+# Install dependencies if needed
+if [ ! -d "$PROJECT_ROOT/.venv" ]; then
+    echo "Creating virtual environment..."
+    python3 -m venv "$PROJECT_ROOT/.venv"
+    source "$PROJECT_ROOT/.venv/bin/activate"
+    pip install -r "$PROJECT_ROOT/requirements.txt"
+fi
+
+# Copy config file if it doesn't exist
+if [ ! -f "$PROJECT_ROOT/config.json" ]; then
+    echo "Copying default config..."
+    cp "$(dirname "${BASH_SOURCE[0]}")/config.json" "$PROJECT_ROOT/config.json"
+fi
+
+# Run the application
+cd "$PROJECT_ROOT"
+python -m uvicorn mcp_proxy_adapter.api.app:create_app --host 0.0.0.0 --port $HOST_PORT --reload
+
+echo "MCP Proxy Adapter started on http://localhost:$HOST_PORT" 

mcp_proxy_adapter/examples/deployment/run_docker.sh

@@ -0,0 +1,84 @@
+#!/bin/bash
+
+# MCP Proxy Adapter - Docker Deployment Script
+# This script runs the framework in Docker
+
+# Function to extract value from JSON config
+function get_json_value {
+    local json_file=$1
+    local json_path=$2
+    
+    python3 -c "
+import json
+with open('$json_file', 'r') as f:
+    config = json.load(f)
+path = '$json_path'.split('.')
+result = config
+for key in path:
+    result = result.get(key, {})
+print(result)
+"
+}
+
+# Get project root directory
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
+CONFIG_FILE="$PROJECT_ROOT/config.json"
+
+# Check if config.json exists, copy from examples if not
+if [ ! -f "$CONFIG_FILE" ]; then
+    echo "Config file not found, copying from examples..."
+    cp "$(dirname "${BASH_SOURCE[0]}")/config.json" "$CONFIG_FILE"
+fi
+
+# Create necessary directories
+mkdir -p "$PROJECT_ROOT/logs" "$PROJECT_ROOT/data" "$PROJECT_ROOT/cache"
+
+# Extract values from configuration
+CONTAINER_NAME=$(get_json_value "$CONFIG_FILE" "docker.container_name")
+SERVICE_PORT=$(get_json_value "$CONFIG_FILE" "server.port")
+USER_ID=$(id -u)
+GROUP_ID=$(id -g)
+
+# Use default values if not defined in config
+CONTAINER_NAME=${CONTAINER_NAME:-mcp-proxy-adapter}
+SERVICE_PORT=${SERVICE_PORT:-8000}
+HOST_PORT=${SERVICE_PORT}
+
+echo "Using configuration:"
+echo "  Container name: $CONTAINER_NAME"
+echo "  Port mapping: 127.0.0.1:$HOST_PORT -> $SERVICE_PORT"
+echo "  User/Group: $USER_ID:$GROUP_ID"
+
+# Export variables for docker-compose
+export CONTAINER_NAME=$CONTAINER_NAME
+export SERVICE_PORT=$SERVICE_PORT
+export HOST_PORT=$HOST_PORT
+export USER_ID=$USER_ID
+export GROUP_ID=$GROUP_ID
+
+# Stop container if it already exists
+docker-compose -f "$(dirname "${BASH_SOURCE[0]}")/docker-compose.yml" down
+
+# Start container
+docker-compose -f "$(dirname "${BASH_SOURCE[0]}")/docker-compose.yml" up -d
+
+# Check if we need to connect to additional network
+NETWORK=$(get_json_value "$CONFIG_FILE" "docker.network")
+if [ ! -z "$NETWORK" ] && [ "$NETWORK" != "{}" ]; then
+    echo "Connecting to network: $NETWORK"
+    # Check if network exists
+    if docker network inspect "$NETWORK" &>/dev/null; then
+        # Connect container to network if not already connected
+        if ! docker network inspect "$NETWORK" | grep -q "$CONTAINER_NAME"; then
+            docker network connect "$NETWORK" "$CONTAINER_NAME"
+            echo "Container connected to network: $NETWORK"
+        else
+            echo "Container already connected to network: $NETWORK"
+        fi
+    else
+        echo "Warning: Network $NETWORK does not exist"
+    fi
+fi
+
+echo "Container started. Use the following command to check logs:"
+echo "  docker logs $CONTAINER_NAME" 

mcp_proxy_adapter/openapi.py

@@ -7,8 +7,9 @@ import inspect
 import json
 from pathlib import Path
 
-from .registry import CommandRegistry, Command
-from .exceptions import SchemaValidationError
+from .commands.command_registry import CommandRegistry
+from .commands.base import Command
+from .core.errors import ValidationError as SchemaValidationError
 
 
 @dataclass