mcp-proxy-adapter 3.1.3__py3-none-any.whl → 3.1.4__py3-none-any.whl

examples/fix_vstl_help.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python3
+"""
+Скрипт для исправления проблемы с обработкой JavaScript null в сервисе VSTL.
+
+Этот скрипт демонстрирует проблему с обработкой null значений в VSTL 
+и способ её решения с помощью обновленной реализации метода validate_params.
+"""
+
+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 call_vstl_help(params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+    """
+    Вызывает команду help в сервисе VSTL.
+    
+    Args:
+        params: Параметры для команды help
+        
+    Returns:
+        Dict[str, Any]: Ответ от сервиса
+    """
+    payload = {
+        "jsonrpc": "2.0",
+        "method": "help",
+        "params": params or {},
+        "id": 1
+    }
+    
+    response = requests.post(VSTL_URL, json=payload, headers=HEADERS)
+    return response.json()
+
+def test_validate_params_fix():
+    """
+    Демонстрирует проблему с обработкой null и решение с помощью
+    улучшенной реализации метода validate_params.
+    """
+    # Оригинальная реализация метода validate_params
+    def original_validate_params(params: Dict[str, Any]) -> Dict[str, Any]:
+        if params is None:
+            params = {}
+            
+        validated_params = params.copy()
+        
+        for key, value in list(validated_params.items()):
+            if value is None or (isinstance(value, str) and value == ""):
+                if key in ["cmdname"]:
+                    pass
+                else:
+                    del validated_params[key]
+                
+        return validated_params
+
+    # Улучшенная реализация метода validate_params
+    def improved_validate_params(params: Dict[str, Any]) -> Dict[str, Any]:
+        if params is None:
+            params = {}
+            
+        validated_params = params.copy()
+        
+        for key, value in list(validated_params.items()):
+            if value is None or (isinstance(value, str) and value.lower() in ["null", "none", ""]):
+                if key in ["cmdname"]:
+                    validated_params[key] = None
+                else:
+                    del validated_params[key]
+                
+        return validated_params
+
+    # Тестирование оригинальной реализации
+    original_params = {"unknown_param": "null"}
+    
+    print("\n=== Оригинальные параметры ===")
+    print(f"Параметры: {original_params}")
+    print("Результат validate_params (оригинальный):")
+    try:
+        print(original_validate_params(original_params))
+    except Exception as e:
+        print(f"ОШИБКА: {e}")
+        
+    # Тестирование улучшенной реализации
+    print("\n=== Улучшенная обработка 'null' ===")
+    print(f"Параметры: {original_params}")
+    print("Результат validate_params (улучшенный):")
+    try:
+        print(improved_validate_params(original_params))
+    except Exception as e:
+        print(f"ОШИБКА: {e}")
+        
+    # Проверка запроса к VSTL с null в параметрах
+    print("\n=== Тестирование запроса к VSTL ===")
+    
+    # Тест с null в параметрах
+    print("\nТест 1: Запрос с null в параметрах")
+    response = call_vstl_help({"unknown_param": None})
+    print(f"Ответ: {json.dumps(response, indent=2)}")
+    
+    # Тест с строковым "null" в параметрах
+    print("\nТест 2: Запрос со строковым 'null' в параметрах")
+    response = call_vstl_help({"unknown_param": "null"})
+    print(f"Ответ: {json.dumps(response, indent=2)}")
+    
+    # Рекомендации по исправлению
+    print("\n=== Рекомендации по исправлению ===")
+    print("""
+1. Обновите метод validate_params в файле commands/base.py на улучшенную версию:
+   - Добавьте проверку на строки "null" и "none" (в любом регистре)
+   - Для параметров, которые могут быть None, преобразуйте их в Python None
+   
+2. Обновите метод execute команды help, чтобы игнорировать неизвестные параметры:
+   - Добавьте аргумент **kwargs в сигнатуру метода
+
+Эти изменения улучшат совместимость с клиентами, отправляющими JavaScript null
+и сделают API более устойчивым к различным форматам входных данных.
+    """)
+
+if __name__ == "__main__":
+    test_validate_params_fix() 

examples/test_package_3.1.4.py

@@ -0,0 +1,177 @@
+#!/usr/bin/env python3
+"""
+Скрипт для проверки работы улучшенной обработки null в версии 3.1.4.
+
+Этот скрипт:
+1. Проверяет, что версия пакета 3.1.4
+2. Тестирует улучшенный метод validate_params
+3. Проверяет, что команда help правильно обрабатывает null значения
+"""
+
+import inspect
+import sys
+from typing import Dict, Any, Optional
+
+try:
+    # Импортируем необходимые модули из пакета
+    from mcp_proxy_adapter import __version__
+    from mcp_proxy_adapter.commands.base import Command
+    from mcp_proxy_adapter.commands.help_command import HelpCommand, HelpResult
+except ImportError:
+    print("ОШИБКА: Не удалось импортировать mcp_proxy_adapter. Убедитесь, что пакет установлен.")
+    sys.exit(1)
+
+
+def check_version():
+    """
+    Проверяет версию установленного пакета mcp_proxy_adapter.
+    """
+    expected_version = "3.1.4"
+    
+    print(f"\n=== Проверка версии ===")
+    print(f"Установленная версия: {__version__}")
+    print(f"Ожидаемая версия: {expected_version}")
+    
+    if __version__ != expected_version:
+        print(f"ОШИБКА: Версия пакета ({__version__}) не соответствует ожидаемой ({expected_version}).")
+        return False
+    
+    print("OK: Версия соответствует ожидаемой.")
+    return True
+
+
+def test_validate_params():
+    """
+    Тестирует метод validate_params класса Command для обработки различных вариантов null.
+    """
+    print(f"\n=== Тестирование validate_params ===")
+    
+    # Получаем исходный код метода validate_params
+    validate_params_source = inspect.getsource(Command.validate_params)
+    print(f"Исходный код метода validate_params:")
+    print(validate_params_source)
+    
+    # Проверяем, содержит ли код улучшения для обработки null
+    required_improvements = [
+        "value.lower() in",
+        "null",
+        "none",
+        "validated_params[key] = None"
+    ]
+    
+    for improvement in required_improvements:
+        if improvement not in validate_params_source:
+            print(f"ОШИБКА: Не найдено улучшение: {improvement}")
+            return False
+    
+    # Тестируем различные значения null
+    test_cases = [
+        {"unknown_param": None},
+        {"unknown_param": "null"},
+        {"unknown_param": "NULL"},
+        {"unknown_param": "Null"},
+        {"unknown_param": "none"},
+        {"unknown_param": "NONE"},
+        {"cmdname": None},
+        {"cmdname": "null"},
+        {"cmdname": "none"},
+        {"cmdname": ""}
+    ]
+    
+    print("\nРезультаты тестирования:")
+    for case in test_cases:
+        result = Command.validate_params(case)
+        print(f"Входные данные: {case}")
+        print(f"Результат: {result}")
+        
+        # Проверяем специальный случай с параметром cmdname
+        if "cmdname" in case and (case["cmdname"] is None or case["cmdname"].lower() in ["null", "none", ""]):
+            if "cmdname" not in result or result["cmdname"] is not None:
+                print(f"ОШИБКА: Неверная обработка cmdname. Ожидалось: {{'cmdname': None}}, Получено: {result}")
+                return False
+        
+        # Проверяем, что unknown_param был удален
+        if "unknown_param" in case and "unknown_param" in result:
+            print(f"ОШИБКА: Параметр unknown_param не был удален: {result}")
+            return False
+    
+    print("OK: Все тесты validate_params пройдены успешно.")
+    return True
+
+
+def test_help_command():
+    """
+    Тестирует работу команды help с различными вариантами null.
+    """
+    print(f"\n=== Тестирование команды help ===")
+    
+    # Получаем исходный код метода execute команды help
+    help_execute_source = inspect.getsource(HelpCommand.execute)
+    print(f"Исходный код метода execute в HelpCommand:")
+    print(help_execute_source)
+    
+    # Проверяем, содержит ли код поддержку **kwargs
+    if "**kwargs" not in help_execute_source:
+        print("ОШИБКА: Метод execute в HelpCommand не поддерживает **kwargs.")
+        return False
+    
+    # Создаем экземпляр команды
+    help_cmd = HelpCommand()
+    
+    # Тестируем с разными вариантами null в параметрах
+    test_cases = [
+        {"cmdname": None, "unknown_param": None},
+        {"cmdname": "null", "unknown_param": "null"},
+        {"cmdname": "none", "unknown_param": "none"},
+        {"cmdname": "", "unknown_param": ""},
+        {"unknown_param": "whatever"}
+    ]
+    
+    print("\nРезультаты тестирования:")
+    for i, case in enumerate(test_cases):
+        print(f"\nТест {i+1}: {case}")
+        try:
+            # Используем execute напрямую, так как run преобразует параметры
+            result = help_cmd.execute(**case)
+            print(f"Тест пройден успешно, команда вернула результат типа: {type(result)}")
+        except Exception as e:
+            print(f"ОШИБКА: Тест не пройден: {e}")
+            return False
+    
+    print("OK: Все тесты команды help пройдены успешно.")
+    return True
+
+
+def main():
+    """
+    Основная функция для запуска тестов.
+    """
+    print("=== Проверка MCP Proxy Adapter 3.1.4 ===")
+    
+    # Проверяем версию пакета
+    version_ok = check_version()
+    
+    # Если версия не соответствует ожидаемой, прекращаем выполнение
+    if not version_ok:
+        print("ОШИБКА: Версия пакета не соответствует требуемой.")
+        return False
+    
+    # Тестируем validate_params
+    validate_params_ok = test_validate_params()
+    
+    # Тестируем команду help
+    help_command_ok = test_help_command()
+    
+    # Выводим общий результат
+    print("\n=== Итоговый результат ===")
+    if version_ok and validate_params_ok and help_command_ok:
+        print("УСПЕХ: Все тесты пройдены успешно!")
+        return True
+    else:
+        print("ОШИБКА: Не все тесты пройдены.")
+        return False
+
+
+if __name__ == "__main__":
+    success = main()
+    sys.exit(0 if success else 1) 

mcp_proxy_adapter/commands/base.py

@@ -91,10 +91,11 @@ class Command(ABC):
         # Handle None values and empty strings in parameters
         for key, value in list(validated_params.items()):
             # Process None values or empty strings - this helps with JavaScript null/undefined conversions
-            if value is None or (isinstance(value, str) and value == ""):
-                # For commands that specifically handle None values (like help), keep the parameter
+            if value is None or (isinstance(value, str) and value.lower() in ["null", "none", ""]):
+                # For commands that specifically handle None values, keep the parameter
+                # (like help), keep the parameter but ensure it's a proper Python None
                 if key in ["cmdname"]:  # список параметров, для которых None является допустимым значением
-                    pass
+                    validated_params[key] = None
                 else:
                     # For most parameters, remove None values to avoid issues
                     del validated_params[key]

mcp_proxy_adapter/version.py

@@ -1,3 +1,3 @@
 """Version information for MCP Microservice."""
 
-__version__ = "3.1.3" 
+__version__ = "3.1.4" 

{mcp_proxy_adapter-3.1.3.dist-info → mcp_proxy_adapter-3.1.4.dist-info}/METADATA

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

{mcp_proxy_adapter-3.1.3.dist-info → mcp_proxy_adapter-3.1.4.dist-info}/RECORD

@@ -1,6 +1,8 @@
 examples/__init__.py,sha256=sLYNpeoiE-X5q7fmJb7NFMmhiIn0543mgJj16q1qmk0,593
+examples/fix_vstl_help.py,sha256=GvFepKbCD-a2O2LEflMGeXnsgNMUNfNezPFU6QB_7tI,5208
 examples/server.py,sha256=gnRTE_k7C0A255dLyaJWyA4YU0H6Elc7osr_JQvsQhQ,2286
 examples/simple_server.py,sha256=Bkczmz5Qs473xJ0_AJjBpqWT-oWctwED98A067z05zQ,3768
+examples/test_package_3.1.4.py,sha256=OnEC4N4QOfqrh7DPsQrUV9L9TEG240CwkdM9NY2HBXU,7180
 examples/test_server.py,sha256=cKWJ4tlHqZsRKyeuXbZ1dQ7TU9riJWcDan__wK7YH_Y,3729
 examples/tool_description_example.py,sha256=blamrx_1oHCG4NnvIiYnQxphAEDqb7-TALPALJFj51s,3280
 examples/anti_patterns/README.md,sha256=1-Hby6Wf3kAC0XOV_jOvuHL-kmTypWOUfE_rEU3Knu8,2045
@@ -50,7 +52,7 @@ mcp_proxy_adapter/config.py,sha256=MjgZAld6TiD0F5oCyEaJhYhfEXVZxc5G5ke2SLKCV9A,5
 mcp_proxy_adapter/custom_openapi.py,sha256=tAE289B76nUdd2tjbiyow2Jftj0Yd-A8I2ndTD6R-5c,11706
 mcp_proxy_adapter/openapi.py,sha256=jyl5EPXcFhzFKEEMXxHeqF1U-SsYvtdlaKGU2QrekpU,13889
 mcp_proxy_adapter/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mcp_proxy_adapter/version.py,sha256=0qNMWytNAXlNNfpN1BZMoMhsK8wp4zfWXOOFOViwLZU,71
+mcp_proxy_adapter/version.py,sha256=WXry8RiuhtfzpY1KvYxY0nYxtli-yU85Nax9ZjK3axY,71
 mcp_proxy_adapter/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_proxy_adapter/api/app.py,sha256=q3yYsNEBFXYr2TOJFxfh6bbF53NkmmgfzSFOtVq7xdc,14353
 mcp_proxy_adapter/api/handlers.py,sha256=lc_4eakQgQVlnGjnVkOY-mIMkfyLk4iRfwdrWTyvuvM,7194
@@ -65,7 +67,7 @@ mcp_proxy_adapter/api/middleware/logging.py,sha256=wGtw4BqKMLgn5zqYd84DnVPtO3evf
 mcp_proxy_adapter/api/middleware/performance.py,sha256=dHBxTF43LEGXMKHMH3A8ybKmwAWURd_zswqq_oC4xbw,2454
 mcp_proxy_adapter/api/middleware/rate_limit.py,sha256=DIv_-ZUVmL-jEo_A5BlfnasZf25zT84AiIJDUUnXkpM,5041
 mcp_proxy_adapter/commands/__init__.py,sha256=bHZZcVYkXVL9g-YZOnWkHOxSP2WzT-I4_OleYycQhbw,610
-mcp_proxy_adapter/commands/base.py,sha256=vgFhH5u3GwNs0c5FvJUf2csahzTyH5fKnYLWiqKix9o,13615
+mcp_proxy_adapter/commands/base.py,sha256=lKKoN_9tJYIeOFKgQRGwWZHy_EvWP8bVB1EhIouTbi0,13740
 mcp_proxy_adapter/commands/command_registry.py,sha256=x55k4guzOlm7fVRolJ_iSFPRx2Snq4yBaMQdzVmsK0A,10460
 mcp_proxy_adapter/commands/config_command.py,sha256=-Z6BGaEQTf859l56zZpHYBeZFeIVdpMYybDrd7LOPIg,3553
 mcp_proxy_adapter/commands/dependency_container.py,sha256=Uz9OPRAUZN7tsVrMVgXgPQcsRD2N-e2Ixg9XarPOlnY,3410
@@ -106,8 +108,8 @@ mcp_proxy_adapter/tests/stubs/echo_command.py,sha256=Y7SA4IB5Lo_ncn78SDm9iRZvJSK
 mcp_proxy_adapter/tests/unit/__init__.py,sha256=RS-5UoSCcLKtr2jrAaZw_NG9MquA6BZmxq-P6cTw9ok,53
 mcp_proxy_adapter/tests/unit/test_base_command.py,sha256=ldDXQYk2eijbTgZioSBAhHzSAa_SuBKYqCutCEzUYTE,3924
 mcp_proxy_adapter/tests/unit/test_config.py,sha256=SZ62LXFOv_fsV0fmSIBdHWvapEyexKrioFRQo0I4pkg,5900
-mcp_proxy_adapter-3.1.3.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
-mcp_proxy_adapter-3.1.3.dist-info/METADATA,sha256=kRq0QbeD-BFX5Wz4BgflzuwOojpACvvBl3t85YZl8UU,7537
-mcp_proxy_adapter-3.1.3.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
-mcp_proxy_adapter-3.1.3.dist-info/top_level.txt,sha256=kxq3OC7vBtsFdy9dDVse4cOl-SV_QlvcTeSkuw_jw3I,27
-mcp_proxy_adapter-3.1.3.dist-info/RECORD,,
+mcp_proxy_adapter-3.1.4.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
+mcp_proxy_adapter-3.1.4.dist-info/METADATA,sha256=G_zv6VyoWPW8P9AStPqByO-7ujKlx8JMgv8Yx_cxqOY,7537
+mcp_proxy_adapter-3.1.4.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
+mcp_proxy_adapter-3.1.4.dist-info/top_level.txt,sha256=kxq3OC7vBtsFdy9dDVse4cOl-SV_QlvcTeSkuw_jw3I,27
+mcp_proxy_adapter-3.1.4.dist-info/RECORD,,