mcp-proxy-adapter 2.1.17__py3-none-any.whl → 3.0.0__py3-none-any.whl

examples/commands/echo_result.py

@@ -0,0 +1,65 @@
+"""
+Module with result class for echo command.
+"""
+
+from typing import Any, Dict, ClassVar, Type
+from pydantic import BaseModel, Field
+
+from mcp_proxy_adapter.commands.result import CommandResult
+
+
+class EchoResult(CommandResult, BaseModel):
+    """
+    Result of echo command execution.
+    
+    Attributes:
+        params (Dict[str, Any]): Parameters that were passed to the command.
+    """
+    
+    params: Dict[str, Any] = Field(..., description="Parameters that were passed to the command")
+    
+    def to_dict(self) -> Dict[str, Any]:
+        """
+        Converts result to dictionary for serialization.
+
+        Returns:
+            Dictionary with result data.
+        """
+        return {
+            "params": self.params
+        }
+    
+    @classmethod
+    def get_schema(cls) -> Dict[str, Any]:
+        """
+        Returns JSON schema for result validation.
+
+        Returns:
+            Dictionary with JSON schema.
+        """
+        return {
+            "type": "object",
+            "properties": {
+                "params": {
+                    "type": "object", 
+                    "description": "Parameters that were passed to the command",
+                    "additionalProperties": True
+                }
+            },
+            "required": ["params"]
+        }
+    
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "EchoResult":
+        """
+        Creates result instance from dictionary.
+
+        Args:
+            data: Dictionary with result data.
+
+        Returns:
+            EchoResult instance.
+        """
+        return cls(
+            params=data.get("params", {})
+        ) 

examples/commands/get_date_command.py

@@ -0,0 +1,98 @@
+"""
+Module for the get_date command implementation.
+"""
+
+from datetime import datetime
+from typing import Any, Dict
+
+from mcp_proxy_adapter.commands.base import Command
+from mcp_proxy_adapter.commands.result import CommandResult
+from mcp_proxy_adapter.commands.command_registry import registry
+from mcp_proxy_adapter.core.logging import logger
+
+
+class GetDateResult(CommandResult):
+    """Result of getting current date"""
+    
+    def __init__(self, date: str):
+        """
+        Initialize the GetDateResult.
+        
+        Args:
+            date: Date in ISO 8601 format
+        """
+        self.date = date
+        
+    def to_dict(self) -> Dict[str, Any]:
+        """
+        Convert the result to a dictionary.
+        
+        Returns:
+            Dictionary with the date
+        """
+        return {"date": self.date}
+    
+    @classmethod
+    def get_schema(cls) -> Dict[str, Any]:
+        """
+        Get the JSON schema for this result.
+        
+        Returns:
+            JSON schema
+        """
+        return {
+            "type": "object",
+            "required": ["date"],
+            "properties": {
+                "date": {
+                    "type": "string",
+                    "description": "Current date and time in ISO 8601 format",
+                    "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:?\\d{2}$"
+                }
+            }
+        }
+
+
+class GetDateCommand(Command):
+    """
+    Command that returns the current date and time in ISO 8601 format.
+    """
+    
+    name = "get_date"
+    
+    async def execute(self) -> GetDateResult:
+        """
+        Execute the get_date command.
+        
+        Returns:
+            GetDateResult: Result with date in ISO 8601 format
+        """
+        # Get current time with timezone info
+        now = datetime.now().astimezone()
+        
+        # Format to ISO 8601
+        date_str = now.strftime("%Y-%m-%dT%H:%M:%S%z")
+        
+        # Insert colon in timezone offset (e.g. +0300 -> +03:00)
+        if len(date_str) >= 6:
+            date_str = date_str[:-2] + ":" + date_str[-2:]
+            
+        logger.debug(f"Generated date: {date_str}")
+        return GetDateResult(date=date_str)
+    
+    @classmethod
+    def get_schema(cls) -> Dict[str, Any]:
+        """
+        Get the JSON schema for this command.
+        
+        Returns:
+            JSON schema
+        """
+        return {
+            "type": "object",
+            "properties": {}
+        }
+
+
+# Register the command
+registry.register(GetDateCommand) 

examples/commands/new_uuid4_command.py

@@ -0,0 +1,91 @@
+"""
+Module for the new_uuid4 command implementation.
+"""
+
+import uuid
+from typing import Any, Dict
+
+from mcp_proxy_adapter.commands.base import Command
+from mcp_proxy_adapter.commands.result import CommandResult
+from mcp_proxy_adapter.commands.command_registry import registry
+from mcp_proxy_adapter.core.logging import logger
+
+
+class NewUuid4Result(CommandResult):
+    """Result of UUID4 generation"""
+    
+    def __init__(self, uuid_str: str):
+        """
+        Initialize the NewUuid4Result.
+        
+        Args:
+            uuid_str: UUID in string format
+        """
+        self.uuid = uuid_str
+        
+    def to_dict(self) -> Dict[str, Any]:
+        """
+        Convert the result to a dictionary.
+        
+        Returns:
+            Dictionary with the UUID
+        """
+        return {"uuid": self.uuid}
+    
+    @classmethod
+    def get_schema(cls) -> Dict[str, Any]:
+        """
+        Get the JSON schema for this result.
+        
+        Returns:
+            JSON schema
+        """
+        return {
+            "type": "object",
+            "required": ["uuid"],
+            "properties": {
+                "uuid": {
+                    "type": "string",
+                    "description": "Generated UUID4 in string format",
+                    "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
+                }
+            }
+        }
+
+
+class NewUuid4Command(Command):
+    """
+    Command that generates a new UUID version 4 (random).
+    """
+    
+    name = "new_uuid4"
+    
+    async def execute(self) -> NewUuid4Result:
+        """
+        Execute the new_uuid4 command.
+        
+        Returns:
+            NewUuid4Result: Result with UUID in string format
+        """
+        # Generate a UUID4
+        uuid_str = str(uuid.uuid4())
+        
+        logger.debug(f"Generated UUID4: {uuid_str}")
+        return NewUuid4Result(uuid_str=uuid_str)
+    
+    @classmethod
+    def get_schema(cls) -> Dict[str, Any]:
+        """
+        Get the JSON schema for this command.
+        
+        Returns:
+            JSON schema
+        """
+        return {
+            "type": "object",
+            "properties": {}
+        }
+
+
+# Register the command
+registry.register(NewUuid4Command) 

examples/complete_example/Dockerfile

@@ -0,0 +1,24 @@
+FROM python:3.11-slim
+
+# Set working directory
+WORKDIR /app
+
+# Install dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Create necessary directories
+RUN mkdir -p /app/logs /app/cache /app/data
+
+# Copy application files
+COPY . .
+
+# Set environment variables
+ENV PYTHONUNBUFFERED=1
+ENV CONFIG_PATH=/app/configs/config.docker.yaml
+
+# Expose API port
+EXPOSE 8000
+
+# Run the application
+CMD ["python", "server.py", "--config", "/app/configs/config.docker.yaml"] 

examples/complete_example/README.md

@@ -0,0 +1,92 @@
+# Complete MCP Proxy Adapter Example
+
+This example demonstrates a complete MCP Proxy Adapter application with Docker support,
+environment-specific configuration, and multiple commands.
+
+## Structure
+
+```
+complete_example/
+├── cache/                     # Cache directory
+├── commands/                  # Commands directory
+│   ├── __init__.py           # Package initialization
+│   ├── db_command.py         # Database command
+│   ├── file_command.py       # File operations command
+│   └── system_command.py     # System information command
+├── configs/                   # Configuration files
+│   ├── config.dev.yaml       # Development config
+│   └── config.docker.yaml    # Docker config
+├── docker-compose.yml        # Docker Compose file
+├── Dockerfile                # Docker image definition
+├── logs/                     # Logs directory
+├── README.md                 # This documentation file
+├── requirements.txt          # Python dependencies
+└── server.py                 # Server startup file
+```
+
+## Features
+
+- Multiple commands in separate files
+- Environment-specific configuration
+- Docker support
+- Volume mounting for logs, cache, and config
+- Network configuration
+
+## Running Locally
+
+```bash
+# Navigate to the project directory
+cd examples/complete_example
+
+# Create virtual environment (optional)
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+# or
+# venv\Scripts\activate  # Windows
+
+# Install dependencies
+pip install -r requirements.txt
+pip install -e ../..  # Install mcp_proxy_adapter from parent directory
+
+# Run the server with development config
+python server.py --config configs/config.dev.yaml
+```
+
+The server will be available at [http://localhost:8000](http://localhost:8000).
+
+## Running with Docker
+
+```bash
+# Navigate to the project directory
+cd examples/complete_example
+
+# Build the Docker image
+docker build -t mcp-proxy-adapter-example .
+
+# Run with Docker Compose
+docker-compose up
+```
+
+The server will be available at [http://localhost:8000](http://localhost:8000).
+
+## Available Commands
+
+The microservice includes several commands that demonstrate different features:
+
+1. `system_info` - Returns system information
+2. `file_operations` - Performs file operations
+3. `db_query` - Executes database queries
+
+For details on each command, see the API documentation at [http://localhost:8000/docs](http://localhost:8000/docs)
+when the server is running.
+
+## Docker Configuration
+
+The Docker setup includes:
+
+- Volume mounts for logs, cache, and configuration
+- Network configuration for integration with other services
+- User mapping to avoid permission issues
+- Port forwarding
+
+For details, see the `docker-compose.yml` file. 

examples/complete_example/__init__.py

@@ -0,0 +1,8 @@
+"""
+Complete example for MCP Microservice.
+
+This package contains a complete example of using MCP Microservice framework
+with Docker support, multiple commands, configuration management, and tests.
+"""
+
+__all__ = [] 

examples/complete_example/commands/__init__.py

@@ -0,0 +1,5 @@
+"""
+Command package for complete example.
+
+This package contains all commands for the complete microservice example.
+"""