mcp-proxy-adapter 3.1.4__py3-none-any.whl → 3.1.6__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/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.6 и перезапустите
+
+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

@@ -1,9 +1,9 @@
 #!/usr/bin/env python3
 """
-Скрипт для проверки работы улучшенной обработки null в версии 3.1.4.
+Скрипт для проверки работы улучшенной обработки null в версии 3.1.6.
 
 Этот скрипт:
-1. Проверяет, что версия пакета 3.1.4
+1. Проверяет, что версия пакета 3.1.6
 2. Тестирует улучшенный метод validate_params
 3. Проверяет, что команда help правильно обрабатывает null значения
 """
@@ -26,7 +26,7 @@ def check_version():
     """
     Проверяет версию установленного пакета mcp_proxy_adapter.
     """
-    expected_version = "3.1.4"
+    expected_version = "3.1.6"
     
     print(f"\n=== Проверка версии ===")
     print(f"Установленная версия: {__version__}")
@@ -146,7 +146,7 @@ def main():
     """
     Основная функция для запуска тестов.
     """
-    print("=== Проверка MCP Proxy Adapter 3.1.4 ===")
+    print("=== Проверка MCP Proxy Adapter 3.1.6 ===")
     
     # Проверяем версию пакета
     version_ok = check_version()

mcp_proxy_adapter/api/app.py

@@ -200,6 +200,27 @@ def create_app() -> FastAPI:
                         "error": e.to_dict()
                     }
                 )
+            except NotFoundError as e:
+                # Специальная обработка для help-команды: возвращаем result с пустым commands и error
+                if command_name == "help":
+                    return {
+                        "result": {
+                            "success": False,
+                            "commands": {},
+                            "error": str(e),
+                            "note": "To get detailed information about a specific command, call help with parameter: POST /cmd {\"command\": \"help\", \"params\": {\"cmdname\": \"<command_name>\"}}"
+                        }
+                    }
+                # Для остальных команд — стандартная ошибка
+                return JSONResponse(
+                    status_code=200,
+                    content={
+                        "error": {
+                            "code": e.code,
+                            "message": str(e)
+                        }
+                    }
+                )
             
         except json.JSONDecodeError:
             req_logger.error("JSON decode error")

mcp_proxy_adapter/commands/command_registry.py

@@ -1,5 +1,20 @@
 """
 Module for registering and managing commands.
+
+Example: Registering a command instance (for dependency injection)
+---------------------------------------------------------------
+
+.. code-block:: python
+
+    from mcp_proxy_adapter.commands.command_registry import registry
+    from my_commands import MyCommand
+    
+    # Suppose MyCommand requires a service dependency
+    service = MyService()
+    my_command_instance = MyCommand(service=service)
+    registry.register(my_command_instance)
+
+    # Now, when the command is executed, the same instance (with dependencies) will be used
 """
 
 import importlib

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,116 @@ 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:
-                # 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"])
+        logger.debug(f"HelpCommand.execute начало: cmdname={cmdname}, kwargs={kwargs}")
+
+        try:
+            # Handle case when cmdname is provided
+            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:
+                    logger.warning(f"Команда '{cmdname}' не найдена")
+                    # Получаем список всех команд
+                    all_commands = list(registry.get_all_metadata().keys())
+                    if all_commands:
+                        example_cmd = all_commands[0]
+                        example = {
+                            "command": "help",
+                            "params": {"cmdname": example_cmd}
+                        }
+                        note = f"Use help with an existing command name to get detailed info. For example: help with cmdname '{example_cmd}'. To list all commands: call help without parameters."
+                    else:
+                        example = {"command": "help"}
+                        note = "No commands registered. To list all commands: call help without parameters."
+                    return HelpResult(commands_info={
+                        "commands": {},
+                        "error": f"Command '{cmdname}' not found",
+                        "example": example,
+                        "note": note
+                    })
+
+            # Otherwise, return information about all available commands
+            logger.debug("Обработка запроса для всех команд")
+
+            # 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": {}
             }
-        
-        return HelpResult(commands_info=result)
-    
+
+            # 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"Неожиданная ошибка в 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/tests/commands/test_help_command.py

@@ -97,12 +97,15 @@ async def test_help_command_with_invalid_cmdname(mock_registry):
     # Setup mocks
     mock_registry.get_command_metadata.side_effect = NotFoundError("Command not found")
     
-    # Execute command and check exception
+    # Execute command and check result fields
     command = HelpCommand()
-    with pytest.raises(NotFoundError) as excinfo:
-        await command.execute(cmdname="non_existent")
-    
-    assert "not found" in str(excinfo.value)
+    result = await command.execute(cmdname="non_existent")
+    result_dict = result.to_dict()
+    assert "error" in result_dict
+    assert "example" in result_dict
+    assert "note" in result_dict
+    assert result_dict["error"].startswith("Command")
+    assert result_dict["example"]["command"] == "help"
 
 
 def test_help_result_schema():

mcp_proxy_adapter/tests/integration/test_cmd_integration.py

@@ -92,12 +92,11 @@ def test_cmd_help_unknown_command(client):
     assert "result" in response.json()
     result = response.json()["result"]
     
-    assert "success" in result and result["success"] is False
     assert "error" in result
-    error = result["error"]
-    
-    assert error["code"] == -32601
-    assert "not found" in error["message"]
+    assert "example" in result
+    assert "note" in result
+    assert result["error"].startswith("Command")
+    assert result["example"]["command"] == "help"
 
 
 def test_cmd_unknown_command(client):

mcp_proxy_adapter/tests/test_command_registry.py

@@ -242,4 +242,40 @@ def test_clear_registry():
     
     # Clear registry
     registry.clear()
-    assert len(registry._commands) == 0 
+    assert len(registry._commands) == 0
+
+
+def test_register_command_instance():
+    """Test registering a command instance (with dependencies)."""
+    registry = CommandRegistry()
+
+    class Service:
+        def __init__(self, value):
+            self.value = value
+
+    class CommandWithDependency(Command):
+        name = "command_with_dep"
+        result_class = MockResult
+        def __init__(self, service: Service):
+            self.service = service
+        async def execute(self, **kwargs):
+            # Return the value from the injected service
+            result = MockResult()
+            result.service_value = self.service.value
+            return result
+
+    service = Service(value=42)
+    command_instance = CommandWithDependency(service=service)
+    registry.register(command_instance)
+
+    # Проверяем, что экземпляр зарегистрирован
+    assert registry.has_instance("command_with_dep")
+    # Проверяем, что get_command_instance возвращает именно этот экземпляр
+    assert registry.get_command_instance("command_with_dep") is command_instance
+    # Проверяем, что execute использует внедрённый сервис
+    import asyncio
+    result = asyncio.run(
+        registry.get_command_instance("command_with_dep").execute()
+    )
+    assert hasattr(result, "service_value")
+    assert result.service_value == 42 

mcp_proxy_adapter/version.py

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-proxy-adapter
-Version: 3.1.4
+Version: 3.1.6
 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.4.dist-info → mcp_proxy_adapter-3.1.6.dist-info}/RECORD

@@ -1,8 +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=MU-PxZ9gAQx-gT0tyxoWIswDbdV4cYd-r-T9gq4aziw,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_package_3.1.4.py,sha256=GZZANEIrZkw0gfsFK-PKi4lGZ6Fen25RFHSHrOOhR4w,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
@@ -52,9 +55,9 @@ 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=WXry8RiuhtfzpY1KvYxY0nYxtli-yU85Nax9ZjK3axY,71
+mcp_proxy_adapter/version.py,sha256=VRQ07cLW2F_OHDoYAsBuYZHDoj1M-ztVO8Joii9m1Iw,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/app.py,sha256=TdsZjAwdMr_tYGjmmH3D2voVmQOU_Lw9raKbbYhXkk0,15424
 mcp_proxy_adapter/api/handlers.py,sha256=lc_4eakQgQVlnGjnVkOY-mIMkfyLk4iRfwdrWTyvuvM,7194
 mcp_proxy_adapter/api/schemas.py,sha256=xOmiSwHaapY6myEFnLu7o-LWVPM7vwmLYZXFo2c6NfE,12381
 mcp_proxy_adapter/api/tool_integration.py,sha256=mQNFiCkd4plY_A3fkG6auaM8D_1XiC9Jxp4Zrm1ngYE,10161
@@ -68,11 +71,11 @@ mcp_proxy_adapter/api/middleware/performance.py,sha256=dHBxTF43LEGXMKHMH3A8ybKmw
 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=lKKoN_9tJYIeOFKgQRGwWZHy_EvWP8bVB1EhIouTbi0,13740
-mcp_proxy_adapter/commands/command_registry.py,sha256=x55k4guzOlm7fVRolJ_iSFPRx2Snq4yBaMQdzVmsK0A,10460
+mcp_proxy_adapter/commands/command_registry.py,sha256=3KNmG1Blg1UrThZNU3vGj_2I4ZTFBjUgYZmk7QBOb4w,10998
 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=dfqNt1h2H6vQJ9rLySWa_-0-QzesnN-Mgx0cz-uFlIo,13051
 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
@@ -86,7 +89,7 @@ mcp_proxy_adapter/tests/test_api_endpoints.py,sha256=ePtWCf0szD1JeY9WdHAhcKnuOzo
 mcp_proxy_adapter/tests/test_api_handlers.py,sha256=LeHO0o6eCxan6mt_8ZkUwSbeY7qYfoYMJ-bT_sSgdxc,11011
 mcp_proxy_adapter/tests/test_base_command.py,sha256=nSIi_mfjux8TL--65pMBfyg91EiLjJhI2P_ASWqyW-U,3779
 mcp_proxy_adapter/tests/test_batch_requests.py,sha256=9-gvhPq48AcEwGlhwgn3DWNhpleLA0f4luZNYMrqlXY,4103
-mcp_proxy_adapter/tests/test_command_registry.py,sha256=o5HHxlQ-D2ML0ufJK-lXQv-qYWccvalOHGVvpc8QFTU,6285
+mcp_proxy_adapter/tests/test_command_registry.py,sha256=ywi5gM7D7NHcNOkdwXOgpJqHjwGADZEaB3ueM3nR0gM,7683
 mcp_proxy_adapter/tests/test_config.py,sha256=i4YbFhB3WI1wWKCxkG6l-UpFv2LAbhh4hmGipmYG1d0,3928
 mcp_proxy_adapter/tests/test_utils.py,sha256=K8DqdWDAV-cXjjeykehHpG5phfq5ydu2HLJzaAL282Y,1653
 mcp_proxy_adapter/tests/api/__init__.py,sha256=QzjeBIhrRLqfUKYmxVSCbMOoni5MAXgyAx9HxxB6JRs,27
@@ -95,11 +98,11 @@ mcp_proxy_adapter/tests/api/test_middleware.py,sha256=3Rgc09VJ7JG6_06oIgAVq6u7qJ
 mcp_proxy_adapter/tests/commands/__init__.py,sha256=DZxhtyr__AleyXN1s8Ef887tK5nsoHKfW4QXyzLaP0E,36
 mcp_proxy_adapter/tests/commands/test_config_command.py,sha256=ud0Y57xUhFiyrUKDyA0eBZ8IOKiGDpioijtwY-detC4,6522
 mcp_proxy_adapter/tests/commands/test_echo_command.py,sha256=c2dmqfx3ZfvDedy5vuxArFv7iHsReepMmD2Lchg4l3E,3437
-mcp_proxy_adapter/tests/commands/test_help_command.py,sha256=OJCZMS0BqUUNNSecipd3dOFokUATiET3gpCoVAxPXPA,4116
+mcp_proxy_adapter/tests/commands/test_help_command.py,sha256=0kylFDGSYV-YStVCf_j7_4EF8VDaClIZbJz3V2V2-DI,4272
 mcp_proxy_adapter/tests/functional/__init__.py,sha256=muVNR6LD5o7DsDaLrbLTFsavUNcnyM608-mr-dqzgDU,59
 mcp_proxy_adapter/tests/functional/test_api.py,sha256=OaGB-WAWVyX4b0b-mCdXBNhwwYABYeBPO3IDnA3I00c,7114
 mcp_proxy_adapter/tests/integration/__init__.py,sha256=JZpeNG1PBRZ3k5zfq6NH3GyzDc1Yx1ZUgwi6eLBxs1o,60
-mcp_proxy_adapter/tests/integration/test_cmd_integration.py,sha256=OqBxh52WPijKaRrIHA54QDJQLBz_nwlCywF9k5jxa_Y,3430
+mcp_proxy_adapter/tests/integration/test_cmd_integration.py,sha256=BS3lA6ayveMckHcy1WJjyqR7l7WTcjmGiCYSnMjVfO0,3415
 mcp_proxy_adapter/tests/integration/test_integration.py,sha256=Rf8GTxdZOvZzrtgqWN2fp-36qUU5rpHdV9zhN1JxNw8,6619
 mcp_proxy_adapter/tests/performance/__init__.py,sha256=2kHf6g4LmYnFuV4EALXzo7Qk9vHGA9DXZFt7nORRFjM,60
 mcp_proxy_adapter/tests/performance/test_performance.py,sha256=Djrnu-SsXRrc_Prj1Aw8OoPzPUwHJds-Itk3aX6o01w,5730
@@ -108,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.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,,
+mcp_proxy_adapter-3.1.6.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
+mcp_proxy_adapter-3.1.6.dist-info/METADATA,sha256=RbYESwlltxLaJLm8rVosrLljcIEkI1IT9VAVpWave9g,7537
+mcp_proxy_adapter-3.1.6.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+mcp_proxy_adapter-3.1.6.dist-info/top_level.txt,sha256=kxq3OC7vBtsFdy9dDVse4cOl-SV_QlvcTeSkuw_jw3I,27
+mcp_proxy_adapter-3.1.6.dist-info/RECORD,,

{mcp_proxy_adapter-3.1.4.dist-info → mcp_proxy_adapter-3.1.6.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.4.0)
+Generator: setuptools (80.7.1)
 Root-Is-Purelib: true
 Tag: py3-none-any