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

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

@@ -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 → mcp_proxy_adapter-3.1.6}/docs/EN/development/DEPENDENCY_INJECTION.md

@@ -1,6 +1,6 @@
 # Dependency Injection
 
-MCP Proxy Adapter version 3.1.4 introduces support for Dependency Injection (DI).
+MCP Proxy Adapter version 3.1.6 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.4 → mcp_proxy_adapter-3.1.6}/docs/RU/development/DEPENDENCY_INJECTION.md

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

mcp_proxy_adapter-3.1.6/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}") 

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

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

{mcp_proxy_adapter-3.1.4 → mcp_proxy_adapter-3.1.6}/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-3.1.4 → mcp_proxy_adapter-3.1.6}/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-3.1.4 → mcp_proxy_adapter-3.1.6}/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