mcp-proxy-adapter 3.1.2__tar.gz → 3.1.4__tar.gz

{mcp_proxy_adapter-3.1.2/mcp_proxy_adapter.egg-info → mcp_proxy_adapter-3.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-proxy-adapter
-Version: 3.1.2
+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.2 → mcp_proxy_adapter-3.1.4}/docs/EN/development/DEPENDENCY_INJECTION.md

@@ -1,6 +1,6 @@
 # Dependency Injection
 
-MCP Proxy Adapter version 3.1.2 introduces support for Dependency Injection (DI).
+MCP Proxy Adapter version 3.1.4 introduces support for Dependency Injection (DI).
 This feature allows creating more flexible and testable commands that can
 use shared services and resources.
 

{mcp_proxy_adapter-3.1.2 → mcp_proxy_adapter-3.1.4}/docs/RU/development/DEPENDENCY_INJECTION.md

@@ -1,6 +1,6 @@
 # Внедрение зависимостей (Dependency Injection)
 
-В версии 3.1.2 библиотеки MCP Proxy Adapter добавлена поддержка внедрения зависимостей (DI).
+В версии 3.1.4 библиотеки MCP Proxy Adapter добавлена поддержка внедрения зависимостей (DI).
 Эта функциональность позволяет создавать более гибкие и тестируемые команды, которые
 могут использовать общие сервисы и ресурсы.
 

mcp_proxy_adapter-3.1.4/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() 

mcp_proxy_adapter-3.1.4/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-3.1.2 → mcp_proxy_adapter-3.1.4}/mcp_proxy_adapter/commands/base.py

@@ -81,9 +81,28 @@ class Command(ABC):
         Raises:
             ValidationError: If parameters are invalid.
         """
+        # Ensure params is a dictionary, even if None was passed
+        if params is None:
+            params = {}
+            
+        # Create a copy to avoid modifying the input dictionary during iteration
+        validated_params = params.copy()
+        
+        # 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.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 является допустимым значением
+                    validated_params[key] = None
+                else:
+                    # For most parameters, remove None values to avoid issues
+                    del validated_params[key]
+                
         # This is a simple implementation that can be overridden by subclasses
         # In real implementation this method would validate parameters against the schema
-        return params
+        return validated_params
     
     @classmethod
     async def run(cls, **kwargs) -> CommandResult:
@@ -109,6 +128,10 @@ class Command(ABC):
                     command_name = command_name[:-7]
             else:
                 command_name = cls.name
+            
+            # Ensure kwargs is never None
+            if kwargs is None:
+                kwargs = {}
                 
             # Parameters validation
             validated_params = cls.validate_params(kwargs)

{mcp_proxy_adapter-3.1.2 → mcp_proxy_adapter-3.1.4}/mcp_proxy_adapter/commands/help_command.py

@@ -118,12 +118,13 @@ class HelpCommand(Command):
     name = "help"
     result_class = HelpResult
     
-    async def execute(self, cmdname: Optional[str] = None) -> HelpResult:
+    async def execute(self, cmdname: Optional[str] = None, **kwargs) -> HelpResult:
         """
         Execute help command.
         
         Args:
             cmdname: Name of the command to get information about (optional)
+            **kwargs: Any additional parameters (will be ignored)
             
         Returns:
             HelpResult: Help command result
@@ -131,8 +132,9 @@ class HelpCommand(Command):
         Raises:
             NotFoundError: If specified command not found
         """
-        # If cmdname is provided, return information about specific command
-        if cmdname:
+        # Handle case when cmdname is provided
+        # Important: explicitly check for None or empty string
+        if cmdname is not None and cmdname != "":
             try:
                 # Get command metadata from registry
                 command_metadata = registry.get_command_metadata(cmdname)

{mcp_proxy_adapter-3.1.2 → mcp_proxy_adapter-3.1.4}/mcp_proxy_adapter/version.py

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

{mcp_proxy_adapter-3.1.2 → mcp_proxy_adapter-3.1.4/mcp_proxy_adapter.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-proxy-adapter
-Version: 3.1.2
+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.2 → mcp_proxy_adapter-3.1.4}/mcp_proxy_adapter.egg-info/SOURCES.txt

@@ -102,8 +102,10 @@ docs/RU/user/deployment.md
 docs/RU/user/examples.md
 docs/RU/user/installation.md
 examples/__init__.py
+examples/fix_vstl_help.py
 examples/server.py
 examples/simple_server.py
+examples/test_package_3.1.4.py
 examples/test_server.py
 examples/tool_description_example.py
 examples/anti_patterns/README.md

{mcp_proxy_adapter-3.1.2 → mcp_proxy_adapter-3.1.4}/pyproject.toml

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

{mcp_proxy_adapter-3.1.2 → mcp_proxy_adapter-3.1.4}/setup.py

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