mcp-proxy-adapter 3.1.6__py3-none-any.whl → 4.1.0__py3-none-any.whl

examples/minimal_example/tests/test_integration.py

@@ -1,181 +0,0 @@
-"""
-Integration tests for the minimal example of MCP Proxy Adapter.
-
-These tests start a real server instance and test the API endpoints.
-"""
-
-import os
-import time
-import pytest
-import requests
-from typing import Dict, Any, Callable
-
-from conftest import ServerProcess
-
-
-class TestHelloCommandIntegration:
-    """Integration tests for the HelloCommand API."""
-
-    def test_jsonrpc_hello_default(self, server: ServerProcess, jsonrpc_client: Callable):
-        """Test the hello command via JSON-RPC with default parameters."""
-        # Make JSON-RPC request
-        response = jsonrpc_client("hello", {})
-        
-        # Check response
-        assert "jsonrpc" in response
-        assert response["jsonrpc"] == "2.0"
-        assert "id" in response
-        assert "result" in response
-        assert "message" in response["result"]
-        assert response["result"]["message"] == "Hello, World!"
-    
-    def test_jsonrpc_hello_custom_name(self, server: ServerProcess, jsonrpc_client: Callable):
-        """Test the hello command via JSON-RPC with custom name parameter."""
-        # Make JSON-RPC request
-        response = jsonrpc_client("hello", {"name": "Integration Test"})
-        
-        # Check response
-        assert "result" in response
-        assert "message" in response["result"]
-        assert response["result"]["message"] == "Hello, Integration Test!"
-    
-    def test_cmd_endpoint_hello(self, server: ServerProcess, api_url: str):
-        """Test the hello command via the /cmd endpoint."""
-        # Prepare request
-        payload = {
-            "command": "hello",
-            "params": {"name": "CMD Endpoint"}
-        }
-        
-        # Make request
-        response = requests.post(
-            f"{api_url}/cmd",
-            json=payload,
-            headers={"Content-Type": "application/json"}
-        )
-        
-        # Check response
-        assert response.status_code == 200
-        data = response.json()
-        assert "result" in data
-        assert "message" in data["result"]
-        assert data["result"]["message"] == "Hello, CMD Endpoint!"
-    
-    def test_api_command_endpoint_hello(self, server: ServerProcess, api_url: str):
-        """Test the hello command via the /api/command/{command_name} endpoint."""
-        # Prepare params
-        params = {"name": "API Command Endpoint"}
-        
-        # Make request
-        response = requests.post(
-            f"{api_url}/api/command/hello",
-            json=params,
-            headers={"Content-Type": "application/json"}
-        )
-        
-        # Check response
-        assert response.status_code == 200
-        data = response.json()
-        assert "message" in data
-        assert data["message"] == "Hello, API Command Endpoint!"
-    
-    def test_jsonrpc_batch_request(self, server: ServerProcess, api_url: str):
-        """Test batch JSON-RPC requests with hello command."""
-        # Prepare batch request
-        batch = [
-            {
-                "jsonrpc": "2.0",
-                "method": "hello",
-                "params": {"name": "Batch 1"},
-                "id": 1
-            },
-            {
-                "jsonrpc": "2.0",
-                "method": "hello",
-                "params": {"name": "Batch 2"},
-                "id": 2
-            }
-        ]
-        
-        # Make request
-        response = requests.post(
-            f"{api_url}/api/jsonrpc",
-            json=batch,
-            headers={"Content-Type": "application/json"}
-        )
-        
-        # Check response
-        assert response.status_code == 200
-        data = response.json()
-        assert isinstance(data, list)
-        assert len(data) == 2
-        
-        # Check first result
-        assert data[0]["id"] == 1
-        assert data[0]["result"]["message"] == "Hello, Batch 1!"
-        
-        # Check second result
-        assert data[1]["id"] == 2
-        assert data[1]["result"]["message"] == "Hello, Batch 2!"
-
-
-class TestServerIntegration:
-    """Integration tests for the server itself."""
-    
-    def test_health_endpoint(self, server: ServerProcess, api_url: str):
-        """Test the /health endpoint."""
-        response = requests.get(f"{api_url}/health")
-        
-        # Check response
-        assert response.status_code == 200
-        data = response.json()
-        assert "status" in data
-        assert data["status"] == "ok"
-    
-    def test_openapi_schema(self, server: ServerProcess, api_url: str):
-        """Test the OpenAPI schema endpoint."""
-        response = requests.get(f"{api_url}/openapi.json")
-        
-        # Check response
-        assert response.status_code == 200
-        schema = response.json()
-        
-        # Check schema structure
-        assert "openapi" in schema
-        assert "info" in schema
-        assert "paths" in schema
-        
-        # Проверяем наличие основных эндпоинтов
-        assert "/api/jsonrpc" in schema["paths"] or "/cmd" in schema["paths"]
-        assert "/api/commands" in schema["paths"]
-        
-    def test_docs_endpoint(self, server: ServerProcess, api_url: str):
-        """Test the Swagger UI endpoint."""
-        response = requests.get(f"{api_url}/docs")
-        
-        # Check response
-        assert response.status_code == 200
-        assert "text/html" in response.headers["Content-Type"]
-        
-        # Check if swagger UI is in the response
-        assert "swagger-ui" in response.text.lower()
-    
-    def test_commands_list_endpoint(self, server: ServerProcess, api_url: str):
-        """Test the commands list endpoint."""
-        response = requests.get(f"{api_url}/api/commands")
-        
-        # Check response
-        assert response.status_code == 200
-        data = response.json()
-        
-        # Check data structure
-        assert "commands" in data
-        assert isinstance(data["commands"], dict)  # Теперь commands это словарь, а не список
-        
-        # Check if hello command is in the list
-        assert "hello" in data["commands"]
-        
-        # Check hello command details
-        hello_cmd = data["commands"]["hello"]
-        assert "name" in hello_cmd
-        assert hello_cmd["name"] == "hello" 

examples/patch_vstl_service.py

@@ -1,105 +0,0 @@
-#!/usr/bin/env python3
-"""
-Скрипт для исправления ошибки 'name null is not defined' в сервисе VSTL.
-
-Этот скрипт обходит проблему с обработкой null в сервисе vstl 
-при помощи модификации JSON-RPC запросов, чтобы заменять null на None.
-
-Использование:
-python patch_vstl_service.py
-"""
-
-import sys
-import json
-import requests
-from typing import Dict, Any, Optional
-
-# URL и заголовки для VSTL сервиса
-VSTL_URL = "http://localhost:8000/cmd"
-HEADERS = {"Content-Type": "application/json"}
-
-def safe_call_vstl(command: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
-    """
-    Безопасно вызывает команду в сервисе VSTL, обрабатывая null значения.
-    
-    Args:
-        command: Имя команды
-        params: Параметры для команды
-        
-    Returns:
-        Dict[str, Any]: Ответ от сервиса
-    """
-    # Обработка null значений - заменяем null на None для Python
-    safe_params = {}
-    if params:
-        for key, value in params.items():
-            if value == "null" or value == "none":
-                safe_params[key] = None
-            else:
-                safe_params[key] = value
-    
-    # Безопасно сериализуем параметры, чтобы null значения были корректно обработаны
-    payload = {
-        "jsonrpc": "2.0",
-        "method": command,
-        "params": safe_params or {},
-        "id": 1
-    }
-    
-    # Отправляем запрос
-    response = requests.post(VSTL_URL, json=payload, headers=HEADERS)
-    return response.json()
-
-def test_vstl_commands():
-    """
-    Тестирует различные команды в сервисе VSTL с безопасной обработкой null.
-    """
-    print("=== Тестирование команд VSTL с патчем для обработки null ===\n")
-    
-    # Проверяем команду health
-    print("1. Команда health:")
-    response = safe_call_vstl("health", {})
-    print(f"Ответ: {json.dumps(response, indent=2)}\n")
-    
-    # Проверяем команду help без параметров
-    print("2. Команда help без параметров:")
-    response = safe_call_vstl("help", {})
-    print(f"Ответ: {json.dumps(response, indent=2)}")
-    
-    # Если команда help сработала, выведем список всех доступных команд
-    if response.get("result") and not response.get("error"):
-        commands_info = response["result"].get("commands", {})
-        print(f"\nДоступные команды ({len(commands_info)}):")
-        for cmd_name, cmd_info in commands_info.items():
-            print(f"  - {cmd_name}: {cmd_info.get('summary', 'Нет описания')}")
-    
-    # Проверяем команду help с параметром cmdname
-    print("\n3. Команда help с параметром cmdname:")
-    response = safe_call_vstl("help", {"cmdname": "health"})
-    print(f"Ответ: {json.dumps(response, indent=2)}\n")
-    
-    # Проверяем команду config
-    print("4. Команда config:")
-    response = safe_call_vstl("config", {"operation": "get"})
-    print(f"Ответ: {json.dumps(response, indent=2)}\n")
-    
-    # Выводим рекомендации по полному исправлению
-    print("\n=== Рекомендации по полному исправлению проблемы с null в VSTL ===")
-    print("""
-1. Проверьте исходный код сервиса VSTL на наличие использования переменной 'null'
-   без её объявления (обратите внимание на файл help_command.py)
-
-2. Замените все использования JavaScript-стиля null на Python None:
-   - Поиск: if value == null
-   - Замена: if value is None
-
-3. Обновите сервис до последней версии mcp_proxy_adapter 3.1.6 и перезапустите
-
-4. Если это невозможно, используйте этот скрипт как промежуточное решение,
-   чтобы безопасно вызывать команды VSTL с корректной обработкой null.
-   
-5. Внесите исправления в метод validate_params, как показано в fix_vstl_help.py
-    """)
-
-if __name__ == "__main__":
-    test_vstl_commands() 

examples/patch_vstl_service_mcp.py

@@ -1,108 +0,0 @@
-#!/usr/bin/env python3
-"""
-Скрипт для исправления ошибки 'name null is not defined' в сервисе VSTL через MCP Proxy API.
-
-Этот скрипт демонстрирует как обойти проблему с null в сервисе vstl,
-используя стандартные средства MCP Proxy API.
-"""
-
-import os
-import sys
-import json
-import subprocess
-from typing import Dict, Any, Optional
-
-def call_vstl_command(command: str, params: Optional[Dict[str, Any]] = None):
-    """
-    Вызывает команду vstl через MCP Proxy API.
-    
-    Args:
-        command: Название команды
-        params: Параметры команды
-        
-    Returns:
-        Результат выполнения команды
-    """
-    # Формируем параметры для команды mcp_MCP-Proxy_vstl
-    if params is None:
-        params = {}
-    
-    # Сериализуем параметры в JSON
-    params_json = json.dumps(params)
-    
-    # Формируем команду для вызова MCP Proxy API
-    cmd = [
-        "curl", "-s",
-        "-X", "POST",
-        "-H", "Content-Type: application/json",
-        "-d", f'{{"jsonrpc":"2.0","method":"{command}","params":{params_json},"id":1}}',
-        "http://localhost:8000/api/vstl"
-    ]
-    
-    # Выполняем команду
-    try:
-        result = subprocess.run(cmd, capture_output=True, text=True, check=True)
-        # Парсим результат как JSON
-        return json.loads(result.stdout)
-    except subprocess.CalledProcessError as e:
-        print(f"Ошибка выполнения команды: {e}")
-        print(f"STDOUT: {e.stdout}")
-        print(f"STDERR: {e.stderr}")
-        return {"error": str(e)}
-    except json.JSONDecodeError as e:
-        print(f"Ошибка декодирования JSON: {e}")
-        print(f"Ответ: {result.stdout}")
-        return {"error": "Неверный формат JSON в ответе"}
-
-def test_vstl_commands():
-    """
-    Тестирует различные команды vstl с обходом проблемы null.
-    """
-    print("=== Тестирование команд VSTL через MCP Proxy API ===\n")
-    
-    # Проверяем команду health
-    print("1. Команда health:")
-    response = call_vstl_command("health", {})
-    print(f"Ответ: {json.dumps(response, indent=2)}\n")
-    
-    # Проверяем команду help без параметров
-    print("2. Команда help без параметров:")
-    response = call_vstl_command("help", {})
-    print(f"Ответ: {json.dumps(response, indent=2)}")
-    
-    # Если есть ошибка в команде help без параметров, попробуем еще несколько вариантов
-    if "error" in response:
-        print("\n2.1. Попытка обойти ошибку - вызов help с корректными параметрами:")
-        response = call_vstl_command("help", {"cmdname": None})
-        print(f"Ответ: {json.dumps(response, indent=2)}")
-    
-    # Проверяем команду help с параметром cmdname
-    print("\n3. Команда help с параметром cmdname:")
-    response = call_vstl_command("help", {"cmdname": "health"})
-    print(f"Ответ: {json.dumps(response, indent=2)}\n")
-    
-    # Проверяем команду config
-    print("4. Команда config:")
-    response = call_vstl_command("config", {"operation": "get"})
-    print(f"Ответ: {json.dumps(response, indent=2)}\n")
-    
-    # Выводим рекомендации по исправлению
-    print("\n=== Рекомендации по исправлению проблемы с null в VSTL ===")
-    print("""
-1. Проблема с обработкой null в JavaScript-совместимых API - это распространенная ошибка.
-   В JavaScript null - это ключевое слово, а в Python - это None.
-
-2. Для полного решения проблемы необходимо исправить реализацию сервиса VSTL:
-   - Найти в коде места, где используется 'null' как переменная
-   - Заменить на корректное использование None
-   - Добавить к аргументам метода execute в help_command.py параметр **kwargs
-   - Обновить метод validate_params для обработки строковых представлений null
-
-3. До исправления сервера можно использовать следующие обходные пути:
-   - Использовать MCP Proxy API с корректными значениями параметров (None вместо null)
-   - Использовать промежуточный слой, который будет преобразовывать запросы
-   - Избегать отправки параметров null/None в командах, где это возможно
-    """)
-
-if __name__ == "__main__":
-    test_vstl_commands() 

examples/server.py

@@ -1,69 +0,0 @@
-"""
-Main application module.
-"""
-
-import os
-import sys
-import uvicorn
-import logging
-
-from mcp_proxy_adapter import create_app
-
-app = create_app()
-from mcp_proxy_adapter.config import config
-from mcp_proxy_adapter.core.logging import logger, setup_logging
-
-
-def main():
-    """
-    Main function to run the application.
-    """
-    # Убедимся что логирование настроено
-    logger.info("Initializing logging configuration")
-    
-    try:
-        # Получаем настройки логирования
-        log_level = config.get("logging.level", "INFO")
-        log_file = config.get("logging.file")
-        rotation_type = config.get("logging.rotation.type", "size")
-        
-        # Выводим информацию о настройках логирования
-        logger.info(f"Log level: {log_level}")
-        if log_file:
-            logger.info(f"Log file: {log_file}")
-            logger.info(f"Log rotation type: {rotation_type}")
-            
-            if rotation_type.lower() == "time":
-                when = config.get("logging.rotation.when", "D")
-                interval = config.get("logging.rotation.interval", 1)
-                logger.info(f"Log rotation: every {interval} {when}")
-            else:
-                max_bytes = config.get("logging.rotation.max_bytes", 10 * 1024 * 1024)
-                logger.info(f"Log rotation: when size reaches {max_bytes / (1024*1024):.1f} MB")
-                
-            backup_count = config.get("logging.rotation.backup_count", 5)
-            logger.info(f"Log backups: {backup_count}")
-        else:
-            logger.info("File logging is disabled")
-            
-        # Get server settings
-        host = config.get("server.host", "0.0.0.0")
-        port = config.get("server.port", 8000)
-        
-        logger.info(f"Starting server on {host}:{port}")
-        
-        # Run server
-        uvicorn.run(
-            "mcp_proxy_adapter.api.app:app",
-            host=host,
-            port=port,
-            reload=True if os.environ.get("DEBUG") else False,
-            log_level=log_level.lower()
-        )
-    except Exception as e:
-        logger.exception(f"Error during application startup: {e}")
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

examples/simple_server.py

@@ -1,128 +0,0 @@
-#!/usr/bin/env python3
-"""
-Простой пример запуска сервера JSON-RPC с использованием MCP Proxy Adapter.
-
-Этот скрипт демонстрирует минимальную конфигурацию для запуска сервера JSON-RPC.
-Он создаёт экземпляр приложения FastAPI с MCP Proxy Adapter и регистрирует пользовательские команды.
-"""
-
-import os
-import argparse
-import sys
-from pathlib import Path
-import uvicorn
-
-# Добавляем родительскую директорию в PYTHONPATH для импорта mcp_proxy_adapter
-sys.path.insert(0, str(Path(__file__).parent.parent))
-
-from mcp_proxy_adapter import Command, SuccessResult, create_app
-from mcp_proxy_adapter.commands.command_registry import registry
-from typing import Dict, Any, Optional
-
-
-class HelloResult(SuccessResult):
-    """Result of hello command."""
-    
-    def __init__(self, message: str):
-        """
-        Initialize result.
-        
-        Args:
-            message: Hello message
-        """
-        self.message = message
-        
-    def to_dict(self) -> Dict[str, Any]:
-        """
-        Convert result to dictionary.
-        
-        Returns:
-            Dictionary representation
-        """
-        return {"message": self.message}
-    
-    @classmethod
-    def get_schema(cls) -> Dict[str, Any]:
-        """
-        Get JSON schema for result.
-        
-        Returns:
-            JSON schema
-        """
-        return {
-            "type": "object",
-            "properties": {
-                "message": {"type": "string"}
-            },
-            "required": ["message"]
-        }
-
-
-class HelloCommand(Command):
-    """Command that returns hello message."""
-    
-    name = "hello"
-    result_class = HelloResult
-    
-    async def execute(self, name: str = "World") -> HelloResult:
-        """
-        Execute command.
-        
-        Args:
-            name: Name to greet
-            
-        Returns:
-            Hello result
-        """
-        return HelloResult(f"Hello, {name}!")
-    
-    @classmethod
-    def get_schema(cls) -> Dict[str, Any]:
-        """
-        Get JSON schema for command parameters.
-        
-        Returns:
-            JSON schema
-        """
-        return {
-            "type": "object",
-            "properties": {
-                "name": {"type": "string"}
-            },
-            "additionalProperties": False
-        }
-
-
-def main():
-    """
-    Основная функция для запуска сервера.
-    """
-    parser = argparse.ArgumentParser(description="JSON-RPC Microservice Server")
-    parser.add_argument("--host", default="0.0.0.0", help="Host to bind server")
-    parser.add_argument("--port", type=int, default=8000, help="Port to bind server")
-    parser.add_argument("--reload", action="store_true", help="Enable auto-reload")
-    
-    args = parser.parse_args()
-    
-    # Регистрируем только свою пользовательскую команду
-    # встроенные команды и примеры регистрируются автоматически
-    registry.register(HelloCommand)
-    
-    # Создаем приложение FastAPI
-    app = create_app()
-    
-    # Запускаем сервер
-    uvicorn.run(
-        app,
-        host=args.host,
-        port=args.port,
-        reload=args.reload
-    )
-
-
-if __name__ == "__main__":
-    # Run the simple server example
-    # To test, open http://localhost:8000/docs in your browser
-    # or use curl:
-    # curl -X POST http://localhost:8000/api/cmd -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"hello","params":{"name":"PyPI"},"id":1}'
-    main()