mcp-proxy-adapter 3.0.1__tar.gz → 3.0.2__tar.gz

{mcp_proxy_adapter-3.0.1/mcp_proxy_adapter.egg-info → mcp_proxy_adapter-3.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp_proxy_adapter
-Version: 3.0.1
+Version: 3.0.2
 Summary: Reliable microservice with unified JSON-RPC endpoint
 Home-page: https://github.com/yourusername/mcp-proxy-adapter
 Author: MCP Team

{mcp_proxy_adapter-3.0.1 → mcp_proxy_adapter-3.0.2}/docs/EN/OPENAPI_SCHEMA.md

@@ -484,4 +484,52 @@ classDiagram
 4. **Compatibility**
    - Full support for JSON-RPC 2.0
    - Compliance with OpenAPI 3.0 specification
-   - Backward compatibility with existing clients 
+   - Backward compatibility with existing clients 
+
+## Customizing OpenAPI Schema Fields
+
+You can override the `title`, `description`, and `version` fields of the OpenAPI schema without editing the base schema file. This is done by passing the corresponding parameters to the FastAPI application and using the `custom_openapi` function.
+
+### Example
+
+```python
+from fastapi import FastAPI
+from mcp_proxy_adapter.custom_openapi import custom_openapi
+
+app = FastAPI(
+    title="Custom Project Title",
+    description="Custom project description for OpenAPI schema.",
+    version="2.1.0"
+)
+
+# Use custom OpenAPI schema
+default_openapi = app.openapi
+app.openapi = lambda: custom_openapi(app)
+
+# Now /openapi.json will reflect the custom title, description, and version
+```
+
+**Advantages:**
+- No need to manually edit the base OpenAPI schema file.
+- Flexible for use in different projects.
+- Standard FastAPI fields are used for customization.
+
+### Test Example
+
+A test is provided to ensure that custom `title`, `description`, and `version` are correctly set in the OpenAPI schema:
+
+```python
+def test_custom_openapi_schema_fields():
+    from fastapi import FastAPI
+    from mcp_proxy_adapter.custom_openapi import custom_openapi
+
+    app = FastAPI(
+        title="Custom Title",
+        description="Custom Description",
+        version="9.9.9"
+    )
+    schema = custom_openapi(app)
+    assert schema["info"]["title"] == "Custom Title"
+    assert schema["info"]["description"] == "Custom Description"
+    assert schema["info"]["version"] == "9.9.9"
+``` 

{mcp_proxy_adapter-3.0.1 → mcp_proxy_adapter-3.0.2}/docs/RU/OPENAPI_SCHEMA.md

@@ -484,4 +484,52 @@ classDiagram
 4. **Совместимость**
    - Полная поддержка JSON-RPC 2.0
    - Соответствие спецификации OpenAPI 3.0
-   - Обратная совместимость с существующими клиентами 
+   - Обратная совместимость с существующими клиентами 
+
+## Кастомизация полей OpenAPI-схемы
+
+Вы можете переопределять поля `title`, `description` и `version` в OpenAPI-схеме без ручного редактирования базового файла схемы. Для этого достаточно передать соответствующие параметры в FastAPI-приложение и использовать функцию `custom_openapi`.
+
+### Пример
+
+```python
+from fastapi import FastAPI
+from mcp_proxy_adapter.custom_openapi import custom_openapi
+
+app = FastAPI(
+    title="Заголовок проекта",
+    description="Описание проекта для OpenAPI-схемы.",
+    version="2.1.0"
+)
+
+# Используем кастомную OpenAPI-схему
+default_openapi = app.openapi
+app.openapi = lambda: custom_openapi(app)
+
+# Теперь /openapi.json будет содержать кастомные title, description и version
+```
+
+**Преимущества:**
+- Нет необходимости вручную редактировать базовый файл OpenAPI-схемы.
+- Гибко для использования в разных проектах.
+- Используются стандартные поля FastAPI для кастомизации.
+
+### Пример теста
+
+Добавлен тест, который проверяет, что кастомные `title`, `description` и `version` корректно устанавливаются в OpenAPI-схеме:
+
+```python
+def test_custom_openapi_schema_fields():
+    from fastapi import FastAPI
+    from mcp_proxy_adapter.custom_openapi import custom_openapi
+
+    app = FastAPI(
+        title="Custom Title",
+        description="Custom Description",
+        version="9.9.9"
+    )
+    schema = custom_openapi(app)
+    assert schema["info"]["title"] == "Custom Title"
+    assert schema["info"]["description"] == "Custom Description"
+    assert schema["info"]["version"] == "9.9.9"
+``` 

{mcp_proxy_adapter-3.0.1 → mcp_proxy_adapter-3.0.2}/examples/complete_example/server.py

@@ -8,14 +8,12 @@ environment-specific configuration, and multiple commands.
 import os
 import sys
 import argparse
-from typing import Dict, Any
 from pathlib import Path
-
-import mcp_proxy_adapter as mcp
-from mcp_proxy_adapter import MicroService
+import uvicorn
+from mcp_proxy_adapter.api.app import create_app
 from mcp_proxy_adapter.commands.command_registry import registry
-from mcp_proxy_adapter.core.logging import logger
 from mcp_proxy_adapter.config import config
+from mcp_proxy_adapter.core.logging import logger, setup_logging
 
 # Add commands directory to path for local imports
 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
@@ -28,32 +26,22 @@ def parse_args():
     Returns:
         Parsed arguments
     """
-    parser = argparse.ArgumentParser(description="MCP Microservice Example")
+    parser = argparse.ArgumentParser(description="MCP Complete Example")
     parser.add_argument(
-        "--config", 
+        "--config",
         default="configs/config.dev.yaml",
         help="Path to configuration file"
     )
     return parser.parse_args()
 
 
-def ensure_directories(config_path: str):
+def ensure_directories():
     """
     Create necessary directories based on configuration.
-    
-    Args:
-        config_path: Path to configuration file
     """
-    # Extract base directory
     base_dir = os.path.dirname(os.path.abspath(__file__))
-    
-    # Create logs directory
     os.makedirs(os.path.join(base_dir, "logs"), exist_ok=True)
-    
-    # Create cache directory
     os.makedirs(os.path.join(base_dir, "cache"), exist_ok=True)
-    
-    # Create data directory
     os.makedirs(os.path.join(base_dir, "data"), exist_ok=True)
 
 
@@ -65,74 +53,60 @@ def setup_application(config_file=None):
         config_file: Path to configuration file (optional)
         
     Returns:
-        Configured microservice object
+        Configured FastAPI application
     """
-    # Parse command line arguments if config_file not provided
     if config_file is None:
         args = parse_args()
         config_file = args.config
-    
-    # Get absolute path to config file
     current_dir = Path(__file__).parent.absolute()
     config_path = current_dir / config_file
-    
-    # Fall back to config.json if specified file doesn't exist
     if not config_path.exists():
         config_path = current_dir / "config.json"
-    
-    # Create necessary directories
-    ensure_directories(str(config_path))
-    
-    # Load configuration if exists
+    ensure_directories()
     if config_path.exists():
         config.load_from_file(str(config_path))
         logger.info(f"Loaded configuration from {config_path}")
     else:
         logger.warning(f"Configuration file {config_path} not found, using defaults")
-    
-    # Create microservice
-    service = MicroService(
-        title="Complete MCP Microservice Example",
-        description="Full-featured microservice with Docker support",
-        version="1.0.0",
-        config_path=str(config_path) if config_path.exists() else None
-    )
-    
-    # Safely register commands from package
+    app = create_app()
+    app.title = "Complete MCP Microservice Example"
+    app.description = "Full-featured microservice with Docker support"
+    app.version = "1.0.0"
+    # Discover and register commands from the commands directory
+    package_path = "commands"
     try:
-        # Clear any existing registrations to prevent conflicts
-        package_path = "commands"
-        
-        # Get currently registered commands
-        commands = registry.get_all_commands()
-        for cmd_name in list(commands.keys()):
+        registered_commands = registry.get_all_commands()
+        for cmd_name in list(registered_commands.keys()):
             try:
                 registry.unregister(cmd_name)
             except Exception as e:
                 logger.debug(f"Error unregistering command {cmd_name}: {e}")
-        
-        # Discover and register commands
-        service.discover_commands(package_path)
-        logger.info(f"Discovered and registered commands from package: {package_path}")
+        registry.discover_commands(package_path)
+        logger.info(f"Discovered commands from package: {package_path}")
     except Exception as e:
         logger.error(f"Error discovering commands: {e}")
-    
-    return service
+    return app
 
 
 def main():
     """Run microservice with command discovery."""
-    # Setup application
-    service = setup_application()
-    
-    # Check if port is overridden by environment variable (for testing)
+    log_level = config.get("logging.level", "INFO")
+    setup_logging(log_level)
+    app = setup_application()
+    host = config.get("server.host", "0.0.0.0")
+    port = config.get("server.port", 8000)
     if "TEST_SERVER_PORT" in os.environ:
         port = int(os.environ["TEST_SERVER_PORT"])
-        service.port = port
         logger.info(f"Using test port from environment: {port}")
-    
-    # Run server with parameters from configuration
-    service.run()
+    logger.info(f"Starting server on {host}:{port}")
+    debug = config.get("server.debug", False)
+    uvicorn.run(
+        app,
+        host=host,
+        port=port,
+        reload=debug,
+        log_level=log_level.lower()
+    )
 
 
 if __name__ == "__main__":

{mcp_proxy_adapter-3.0.1 → mcp_proxy_adapter-3.0.2}/mcp_proxy_adapter/custom_openapi.py

@@ -18,8 +18,16 @@ class CustomOpenAPIGenerator:
     """
     Custom OpenAPI schema generator for compatibility with MCP-Proxy.
     
+    EN:
     This generator creates an OpenAPI schema that matches the format expected by MCP-Proxy,
     enabling dynamic command loading and proper tool representation in AI models.
+    Allows overriding title, description, and version for schema customization.
+
+    RU:
+    Кастомный генератор схемы OpenAPI для совместимости с MCP-Proxy.
+    Позволяет создавать схему OpenAPI в формате, ожидаемом MCP-Proxy,
+    с возможностью динамической подгрузки команд и корректного отображения инструментов для AI-моделей.
+    Поддерживает переопределение title, description и version для кастомизации схемы.
     """
     
     def __init__(self):
@@ -88,38 +96,67 @@ class CustomOpenAPIGenerator:
         
         return cmd_schema
         
-    def generate(self) -> Dict[str, Any]:
+    def generate(self, title: Optional[str] = None, description: Optional[str] = None, version: Optional[str] = None) -> Dict[str, Any]:
         """
+        EN:
         Generate the complete OpenAPI schema compatible with MCP-Proxy.
+        Optionally override title, description, and version.
+
+        RU:
+        Генерирует полную схему OpenAPI, совместимую с MCP-Proxy.
+        Позволяет опционально переопределить title, description и version.
+        
+        Args:
+            title: Custom title for the schema / Кастомный заголовок схемы
+            description: Custom description for the schema / Кастомное описание схемы
+            version: Custom version for the schema / Кастомная версия схемы
         
         Returns:
-            Dict containing the complete OpenAPI schema.
+            Dict containing the complete OpenAPI schema / Словарь с полной схемой OpenAPI
         """
         # Deep copy the base schema to avoid modifying it
         schema = deepcopy(self.base_schema)
-        
+
+        # Optionally override info fields
+        if title:
+            schema["info"]["title"] = title
+        if description:
+            schema["info"]["description"] = description
+        if version:
+            schema["info"]["version"] = version
+
         # Add commands to schema
         self._add_commands_to_schema(schema)
-        
+
         logger.info(f"Generated OpenAPI schema with {len(registry.get_all_commands())} commands")
-        
+
         return schema
 
 
 def custom_openapi(app: FastAPI) -> Dict[str, Any]:
     """
+    EN:
     Create a custom OpenAPI schema for the FastAPI application.
+    Passes app's title, description, and version to the generator.
+
+    RU:
+    Создаёт кастомную OpenAPI-схему для FastAPI-приложения.
+    Передаёт параметры title, description и version из приложения в генератор схемы.
     
     Args:
-        app: The FastAPI application.
+        app: The FastAPI application / FastAPI-приложение
         
     Returns:
-        Dict containing the custom OpenAPI schema.
+        Dict containing the custom OpenAPI schema / Словарь с кастомной OpenAPI-схемой
     """
     generator = CustomOpenAPIGenerator()
-    openapi_schema = generator.generate()
-    
+    openapi_schema = generator.generate(
+        title=getattr(app, 'title', None),
+        description=getattr(app, 'description', None),
+        version=getattr(app, 'version', None)
+    )
+
     # Cache the schema
     app.openapi_schema = openapi_schema
-    
+
     return openapi_schema 

{mcp_proxy_adapter-3.0.1 → mcp_proxy_adapter-3.0.2}/mcp_proxy_adapter/tests/functional/test_api.py

@@ -232,4 +232,22 @@ def test_batch_requests(test_client: TestClient, json_rpc_request: Dict[str, Any
     assert data[0]["id"] == "1"
     
     assert data[1]["result"]["params"] == {"request_id": "2"}
-    assert data[1]["id"] == "2" 
+    assert data[1]["id"] == "2"
+
+
+def test_custom_openapi_schema_fields():
+    """
+    Test that custom title, description, and version are set in the OpenAPI schema.
+    """
+    from fastapi import FastAPI
+    from mcp_proxy_adapter.custom_openapi import custom_openapi
+
+    app = FastAPI(
+        title="Custom Title",
+        description="Custom Description",
+        version="9.9.9"
+    )
+    schema = custom_openapi(app)
+    assert schema["info"]["title"] == "Custom Title"
+    assert schema["info"]["description"] == "Custom Description"
+    assert schema["info"]["version"] == "9.9.9" 

{mcp_proxy_adapter-3.0.1 → mcp_proxy_adapter-3.0.2}/mcp_proxy_adapter/version.py

@@ -1,3 +1,3 @@
 """Version information for MCP Microservice."""
 
-__version__ = "3.0.1" 
+__version__ = "3.0.2" 

{mcp_proxy_adapter-3.0.1 → mcp_proxy_adapter-3.0.2/mcp_proxy_adapter.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp_proxy_adapter
-Version: 3.0.1
+Version: 3.0.2
 Summary: Reliable microservice with unified JSON-RPC endpoint
 Home-page: https://github.com/yourusername/mcp-proxy-adapter
 Author: MCP Team

{mcp_proxy_adapter-3.0.1 → mcp_proxy_adapter-3.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mcp_proxy_adapter"
-version = "3.0.1"
+version = "3.0.2"
 description = "Reliable microservice with unified JSON-RPC endpoint"
 readme = "README.md"
 requires-python = ">=3.8"

{mcp_proxy_adapter-3.0.1 → mcp_proxy_adapter-3.0.2}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="mcp-proxy-adapter",
-    version="3.0.1",
+    version="3.0.2",
     description="Adapter for MCP Proxy JSON-RPC communications",
     long_description=open("README.md").read(),
     long_description_content_type="text/markdown",