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

examples/check_vstl_schema.py

@@ -0,0 +1,106 @@
+#!/usr/bin/env python3
+"""
+Скрипт для проверки схемы команды help в сервисе VSTL
+"""
+
+import json
+import requests
+from typing import Dict, Any, Optional
+
+# URL и заголовки для VSTL сервиса
+VSTL_URL = "http://localhost:8007/cmd"
+HEADERS = {"Content-Type": "application/json"}
+
+def send_json_rpc(method: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+    """
+    Отправляет JSON-RPC запрос и возвращает ответ
+    
+    Args:
+        method: Имя метода
+        params: Параметры запроса
+        
+    Returns:
+        Dict[str, Any]: Ответ сервера
+    """
+    # Формируем JSON-RPC запрос
+    payload = {
+        "jsonrpc": "2.0",
+        "method": method,
+        "id": 1
+    }
+    
+    # Добавляем параметры, если они есть
+    if params is not None:
+        payload["params"] = params
+    
+    print(f"Отправляем запрос: {json.dumps(payload, indent=2)}")
+    
+    # Отправляем запрос
+    response = requests.post(VSTL_URL, json=payload, headers=HEADERS)
+    
+    # Возвращаем ответ
+    return response.json()
+
+def test_help_command():
+    """
+    Проверяет команду help в различных вариантах
+    """
+    print("\n=== Проверка команды help без параметров ===")
+    response = send_json_rpc("help")
+    print(f"Ответ: {json.dumps(response, indent=2)}")
+    
+    print("\n=== Проверка команды help с пустыми параметрами ===")
+    response = send_json_rpc("help", {})
+    print(f"Ответ: {json.dumps(response, indent=2)}")
+    
+    print("\n=== Проверка команды help с параметром cmdname=null ===")
+    response = send_json_rpc("help", {"cmdname": None})
+    print(f"Ответ: {json.dumps(response, indent=2)}")
+    
+    print("\n=== Проверка команды help с параметром cmdname=\"config\" ===")
+    response = send_json_rpc("help", {"cmdname": "config"})
+    print(f"Ответ: {json.dumps(response, indent=2)}")
+    
+    # Проверяем workaround с передачей строки "null"
+    print("\n=== Проверка команды help с параметром cmdname=\"null\" ===")
+    response = send_json_rpc("help", {"cmdname": "null"})
+    print(f"Ответ: {json.dumps(response, indent=2)}")
+
+def check_schema():
+    """
+    Проверяет схему команд и ищет обязательные параметры
+    """
+    print("\n=== Проверка схемы команд ===")
+    
+    # Запрашиваем список всех доступных команд
+    health_response = send_json_rpc("health")
+    print(f"Здоровье сервиса: {json.dumps(health_response, indent=2)}")
+    
+    # Проверяем команду config для получения схемы
+    config_response = send_json_rpc("config", {"operation": "get"})
+    print(f"Конфигурация: {json.dumps(config_response, indent=2)}")
+    
+    # Пробуем с явным указанием строки вместо null
+    print("\n=== Проверка команды help с cmdname=\"\" (пустая строка) ===")
+    response = send_json_rpc("help", {"cmdname": ""})
+    print(f"Ответ: {json.dumps(response, indent=2)}")
+    
+    # Создаем свой вариант с переопределением параметров
+    print("\n=== Проверка специального запроса с kwargs=null ===")
+    # Прямая отправка JSON с null значением для kwargs
+    special_payload = {
+        "jsonrpc": "2.0",
+        "method": "help",
+        "params": {"kwargs": None},
+        "id": 1
+    }
+    response = requests.post(VSTL_URL, json=special_payload, headers=HEADERS)
+    print(f"Ответ: {json.dumps(response.json(), indent=2)}")
+
+if __name__ == "__main__":
+    print("=== Диагностика проблемы с командой help в сервисе VSTL ===")
+    try:
+        test_help_command()
+        check_schema()
+    except Exception as e:
+        print(f"Ошибка при выполнении: {e}") 

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/patch_vstl_service.py

@@ -0,0 +1,105 @@
+#!/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.4 и перезапустите
+
+4. Если это невозможно, используйте этот скрипт как промежуточное решение,
+   чтобы безопасно вызывать команды VSTL с корректной обработкой null.
+   
+5. Внесите исправления в метод validate_params, как показано в fix_vstl_help.py
+    """)
+
+if __name__ == "__main__":
+    test_vstl_commands() 

examples/patch_vstl_service_mcp.py

@@ -0,0 +1,108 @@
+#!/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/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/commands/help_command.py

@@ -3,61 +3,112 @@ Module with help command implementation.
 """
 
 from typing import Dict, Any, Optional
+import logging
+import traceback
 
 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.errors import NotFoundError
 
+# Добавляем логирование
+logger = logging.getLogger("mcp_proxy_adapter.commands.help_command")
+
 
 class HelpResult(CommandResult):
     """
     Result of the help command execution.
     """
-    
+
     def __init__(self, commands_info: Optional[Dict[str, Any]] = None, command_info: Optional[Dict[str, Any]] = None):
         """
         Initialize help command result.
-        
+
         Args:
             commands_info: Information about all commands (for request without parameters)
             command_info: Information about a specific command (for request with cmdname parameter)
         """
+        logger.debug(f"HelpResult.__init__: commands_info={commands_info is not None}, command_info={command_info is not None}")
         self.commands_info = commands_info
         self.command_info = command_info
-    
+
     def to_dict(self) -> Dict[str, Any]:
         """
         Convert result to dictionary.
-        
+
         Returns:
             Dict[str, Any]: Result as dictionary
         """
-        if self.command_info:
-            return {
-                "cmdname": self.command_info["name"],
-                "info": {
-                    "description": self.command_info["description"],
-                    "summary": self.command_info["summary"],
-                    "params": self.command_info["params"],
-                    "examples": self.command_info["examples"]
+        try:
+            logger.debug(f"HelpResult.to_dict: command_info={self.command_info is not None}, commands_info={self.commands_info is not None}")
+
+            # Защита от None для self.command_info
+            if self.command_info is not None:
+                logger.debug(f"HelpResult.to_dict: returning command_info for {self.command_info.get('name', 'unknown')}")
+                # Делаем безопасное получение всех полей с дефолтными значениями
+                return {
+                    "cmdname": self.command_info.get("name", "unknown"),
+                    "info": {
+                        "description": self.command_info.get("description", ""),
+                        "summary": self.command_info.get("summary", ""),
+                        "params": self.command_info.get("params", {}),
+                        "examples": self.command_info.get("examples", [])
+                    }
+                }
+
+            # Защита от None для self.commands_info
+            if self.commands_info is None:
+                logger.warning("HelpResult.to_dict: commands_info is None, создаем пустой результат")
+                # Возвращаем пустой список команд вместо ошибки
+                return {
+                    "tool_info": {
+                        "name": "MCP-Proxy API Service",
+                        "description": "JSON-RPC API for microservice command execution",
+                        "version": "1.0.0"
+                    },
+                    "help_usage": {
+                        "description": "Get information about commands",
+                        "examples": [
+                            {"command": "help", "description": "List of all available commands"},
+                            {"command": "help", "params": {"cmdname": "command_name"}, "description": "Get detailed information about a specific command"}
+                        ]
+                    },
+                    "commands": {},
+                    "total": 0,
+                    "note": "To get detailed information about a specific command, call help with parameter: POST /cmd {\"command\": \"help\", \"params\": {\"cmdname\": \"<command_name>\"}}"
                 }
+
+            # For list of all commands, return as is (already formatted)
+            logger.debug(f"HelpResult.to_dict: processing commands_info with {len(self.commands_info.get('commands', {}))} commands")
+            result = self.commands_info.copy()
+
+            # Add total count and note about usage
+            commands = result.get("commands", {})
+            result["total"] = len(commands)
+            result["note"] = "To get detailed information about a specific command, call help with parameter: POST /cmd {\"command\": \"help\", \"params\": {\"cmdname\": \"<command_name>\"}}"
+
+            logger.debug(f"HelpResult.to_dict: returning result with {result['total']} commands")
+            return result
+        except Exception as e:
+            logger.error(f"Ошибка в HelpResult.to_dict: {e}")
+            logger.debug(f"Трассировка: {traceback.format_exc()}")
+            # В случае неожиданной ошибки возвращаем базовый ответ вместо ошибки
+            return {
+                "tool_info": {
+                    "name": "MCP-Proxy API Service",
+                    "description": "JSON-RPC API for microservice command execution",
+                    "version": "1.0.0"
+                },
+                "commands": {},
+                "total": 0,
+                "error": str(e)
             }
-        
-        # For list of all commands, return as is (already formatted)
-        result = self.commands_info.copy()
-        
-        # Add total count and note about usage
-        result["total"] = len(result["commands"])
-        result["note"] = "To get detailed information about a specific command, call help with parameter: POST /cmd {\"command\": \"help\", \"params\": {\"cmdname\": \"<command_name>\"}}. Only 'cmdname' parameter is supported."
-        
-        return result
-    
+
     @classmethod
     def get_schema(cls) -> Dict[str, Any]:
         """
         Get JSON schema for result validation.
-        
+
         Returns:
             Dict[str, Any]: JSON schema
         """
@@ -114,72 +165,127 @@ class HelpCommand(Command):
     """
     Command for getting help information about available commands.
     """
-    
+
     name = "help"
     result_class = 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
-            
+
         Raises:
             NotFoundError: If specified command not found
         """
-        # Handle case when cmdname is provided
-        # Important: explicitly check for None or empty string
-        if cmdname is not None and cmdname != "":
+        try:
+            logger.debug(f"HelpCommand.execute начало: cmdname={cmdname}, kwargs={kwargs}")
+
+            # Handle case when cmdname is provided
+            # Important: explicitly check for None or empty string
+            if cmdname is not None and cmdname != "":
+                logger.debug(f"Обработка запроса для конкретной команды: {cmdname}")
+                try:
+                    # Get command metadata from registry
+                    command_metadata = registry.get_command_metadata(cmdname)
+                    logger.debug(f"Получены метаданные для команды {cmdname}")
+                    return HelpResult(command_info=command_metadata)
+                except NotFoundError:
+                    # If command not found, raise error
+                    logger.warning(f"Команда '{cmdname}' не найдена")
+                    raise NotFoundError(f"Command '{cmdname}' not found")
+                except Exception as e:
+                    logger.error(f"Ошибка при получении метаданных команды {cmdname}: {e}")
+                    logger.debug(f"Трассировка: {traceback.format_exc()}")
+                    # Создаем пустой результат вместо ошибки
+                    return HelpResult(command_info={
+                        "name": cmdname,
+                        "summary": "Command information unavailable",
+                        "description": f"Error retrieving metadata: {str(e)}",
+                        "params": {},
+                        "examples": []
+                    })
+
+            # Otherwise, return information about all available commands
+            # and tool metadata
+            logger.debug("Обработка запроса для всех команд")
+
             try:
-                # Get command metadata from registry
-                command_metadata = registry.get_command_metadata(cmdname)
-                return HelpResult(command_info=command_metadata)
-            except NotFoundError:
-                # If command not found, raise error
-                raise NotFoundError(f"Command '{cmdname}' not found")
-        
-        # Otherwise, return information about all available commands
-        # and tool metadata
-        
-        # Get metadata for all commands
-        all_metadata = registry.get_all_metadata()
-        
-        # Prepare response format with tool metadata
-        result = {
-            "tool_info": {
-                "name": "MCP-Proxy API Service",
-                "description": "JSON-RPC API for microservice command execution",
-                "version": "1.0.0"
-            },
-            "help_usage": {
-                "description": "Get information about commands",
-                "examples": [
-                    {"command": "help", "description": "List of all available commands"},
-                    {"command": "help", "params": {"cmdname": "command_name"}, "description": "Get detailed information about a specific command"}
-                ]
-            },
-            "commands": {}
-        }
-        
-        # Add brief information about commands
-        for name, metadata in all_metadata.items():
-            result["commands"][name] = {
-                "summary": metadata["summary"],
-                "params_count": len(metadata["params"])
-            }
-        
-        return HelpResult(commands_info=result)
-    
+                # Get metadata for all commands
+                all_metadata = registry.get_all_metadata()
+                logger.debug(f"Получены метаданные для {len(all_metadata)} команд")
+
+                # Prepare response format with tool metadata
+                result = {
+                    "tool_info": {
+                        "name": "MCP-Proxy API Service",
+                        "description": "JSON-RPC API for microservice command execution",
+                        "version": "1.0.0"
+                    },
+                    "help_usage": {
+                        "description": "Get information about commands",
+                        "examples": [
+                            {"command": "help", "description": "List of all available commands"},
+                            {"command": "help", "params": {"cmdname": "command_name"}, "description": "Get detailed information about a specific command"}
+                        ]
+                    },
+                    "commands": {}
+                }
+
+                # Add brief information about commands
+                for name, metadata in all_metadata.items():
+                    try:
+                        logger.debug(f"Обработка метаданных команды {name}")
+                        # Безопасное получение параметров с проверкой на наличие ключей
+                        result["commands"][name] = {
+                            "summary": metadata.get("summary", ""),
+                            "params_count": len(metadata.get("params", {}))
+                        }
+                    except Exception as e:
+                        logger.error(f"Ошибка при обработке метаданных команды {name}: {e}")
+                        logger.debug(f"Метаданные команды {name}: {metadata}")
+                        # Пропускаем проблемную команду
+                        continue
+
+                logger.debug(f"HelpCommand.execute завершение: возвращаем результат с {len(result['commands'])} командами")
+                return HelpResult(commands_info=result)
+            except Exception as e:
+                logger.error(f"Ошибка при получении списка команд: {e}")
+                logger.debug(f"Трассировка: {traceback.format_exc()}")
+                # Создаем пустой результат вместо ошибки
+                return HelpResult(commands_info={
+                    "tool_info": {
+                        "name": "MCP-Proxy API Service",
+                        "description": "JSON-RPC API for microservice command execution",
+                        "version": "1.0.0"
+                    },
+                    "commands": {},
+                    "error": str(e)
+                })
+        except Exception as e:
+            logger.error(f"Неожиданная ошибка в HelpCommand.execute: {e}")
+            logger.debug(f"Трассировка: {traceback.format_exc()}")
+            # В случае неожиданной ошибки возвращаем пустой результат вместо ошибки
+            return HelpResult(commands_info={
+                "tool_info": {
+                    "name": "MCP-Proxy API Service",
+                    "description": "JSON-RPC API for microservice command execution",
+                    "version": "1.0.0"
+                },
+                "commands": {},
+                "error": str(e)
+            })
+
     @classmethod
     def get_schema(cls) -> Dict[str, Any]:
         """
         Get JSON schema for command parameters validation.
-        
+
         Returns:
             Dict[str, Any]: JSON schema
         """

mcp_proxy_adapter/version.py

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-proxy-adapter
-Version: 3.1.3
+Version: 3.1.5
 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.5.dist-info}/RECORD

@@ -1,6 +1,11 @@
 examples/__init__.py,sha256=sLYNpeoiE-X5q7fmJb7NFMmhiIn0543mgJj16q1qmk0,593
+examples/check_vstl_schema.py,sha256=s-VVoY8ysuvVr64JAX6uvxuwjEB7FjbJf0ek7XYc1Nc,4320
+examples/fix_vstl_help.py,sha256=GvFepKbCD-a2O2LEflMGeXnsgNMUNfNezPFU6QB_7tI,5208
+examples/patch_vstl_service.py,sha256=Su98KpRtcflsS8l-z22ECkWzquOv8VRtfUTxTHqS-oQ,4715
+examples/patch_vstl_service_mcp.py,sha256=jiMKzx8hANFVtM0Yv-DJbThwM4r81z9dslF_v9tkAf4,5254
 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 +55,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=4XNuKvyAcEOBhQOCskqTf1rAV8LbxArH1vRWL0Vso04,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,12 +70,12 @@ 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
 mcp_proxy_adapter/commands/health_command.py,sha256=_tzxHwB_8vo53VBC6HnBv5fSfZL1pEuwlbrCcy_K78c,4087
-mcp_proxy_adapter/commands/help_command.py,sha256=TzJEtGX9zcGkCX3H-qZgms_eEfP7Xkt1x3YNRhmXfWM,6976
+mcp_proxy_adapter/commands/help_command.py,sha256=f1DUJNCiVFyTHAi1ztcAo1TKYopmkJPNRYZsJTpTGvI,13769
 mcp_proxy_adapter/commands/result.py,sha256=2WjftiAuhlyzOKmPJlQHo_b08ZCzWoK7cquUHFLVE-E,5534
 mcp_proxy_adapter/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_proxy_adapter/core/errors.py,sha256=s34OxiIR4NCJu_pYSigKXqrIvRjUUK2OWw0X4dpDjIA,5151
@@ -106,8 +111,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.5.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
+mcp_proxy_adapter-3.1.5.dist-info/METADATA,sha256=9qjNRrAc0HgwtNMl3q-I0ZzyBiOsapDMIJZN3SJTcOo,7537
+mcp_proxy_adapter-3.1.5.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
+mcp_proxy_adapter-3.1.5.dist-info/top_level.txt,sha256=kxq3OC7vBtsFdy9dDVse4cOl-SV_QlvcTeSkuw_jw3I,27
+mcp_proxy_adapter-3.1.5.dist-info/RECORD,,