mcp-proxy-adapter 2.1.16__tar.gz → 2.1.17__tar.gz

{mcp_proxy_adapter-2.1.16/mcp_proxy_adapter.egg-info → mcp_proxy_adapter-2.1.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-proxy-adapter
-Version: 2.1.16
+Version: 2.1.17
 Summary: Adapter for exposing Command Registry commands as tools for AI models via MCP Proxy.
 Home-page: https://github.com/vasilyvz/mcp-proxy-adapter
 Author: Vasiliy VZ
@@ -338,4 +338,39 @@ This project uses GitHub Actions for continuous integration and automated publis
 - All tests are run on every push and pull request.
 - On push of a new tag (vX.Y.Z), the package is built and published to PyPI automatically.
 
-See `.github/workflows/publish.yml` for details. 
+See `.github/workflows/publish.yml` for details.
+
+## Встроенная команда help: правила и типовые ошибки
+
+### Как работает
+- Команда `help` всегда встроена в MCPProxyAdapter и не требует реализации или регистрации со стороны пользователя.
+- Для получения справки по конкретной команде используйте параметр `cmdname`:
+  ```json
+  {"jsonrpc": "2.0", "method": "help", "params": {"cmdname": "имя_команды"}, "id": 1}
+  ```
+- Для получения списка всех команд:
+  ```json
+  {"jsonrpc": "2.0", "method": "help", "id": 1}
+  ```
+
+### Типовые ошибки и их решения
+- **Ошибка: передан параметр `command` вместо `cmdname`**
+  - Ответ: 
+    ```json
+    {"error": "Parameter 'command' is not supported. Use 'cmdname' instead.", "hint": "Send params: {\"cmdname\": \"your_command\"}", ...}
+    ```
+  - **Решение:** всегда используйте `cmdname`.
+- **Ошибка сериализации coroutine**
+  - Причина: handler вызывается без await, либо возвращает coroutine.
+  - Ответ:
+    ```json
+    {"error": "Help handler must be awaited. Call as await dispatcher.execute('help', ...) in async context.", ...}
+    ```
+  - **Решение:** всегда await-ить dispatcher.execute в async endpoint.
+
+### Важно для интеграторов и пользователей
+- Не реализуйте свой обработчик help — используйте встроенный.
+- Не используйте параметр `command` — только `cmdname`.
+- Все ошибки help-команды теперь сопровождаются понятной подсказкой и примером корректного запроса.
+
+--- 

{mcp_proxy_adapter-2.1.16 → mcp_proxy_adapter-2.1.17}/README.md

@@ -306,4 +306,39 @@ This project uses GitHub Actions for continuous integration and automated publis
 - All tests are run on every push and pull request.
 - On push of a new tag (vX.Y.Z), the package is built and published to PyPI automatically.
 
-See `.github/workflows/publish.yml` for details. 
+See `.github/workflows/publish.yml` for details.
+
+## Встроенная команда help: правила и типовые ошибки
+
+### Как работает
+- Команда `help` всегда встроена в MCPProxyAdapter и не требует реализации или регистрации со стороны пользователя.
+- Для получения справки по конкретной команде используйте параметр `cmdname`:
+  ```json
+  {"jsonrpc": "2.0", "method": "help", "params": {"cmdname": "имя_команды"}, "id": 1}
+  ```
+- Для получения списка всех команд:
+  ```json
+  {"jsonrpc": "2.0", "method": "help", "id": 1}
+  ```
+
+### Типовые ошибки и их решения
+- **Ошибка: передан параметр `command` вместо `cmdname`**
+  - Ответ: 
+    ```json
+    {"error": "Parameter 'command' is not supported. Use 'cmdname' instead.", "hint": "Send params: {\"cmdname\": \"your_command\"}", ...}
+    ```
+  - **Решение:** всегда используйте `cmdname`.
+- **Ошибка сериализации coroutine**
+  - Причина: handler вызывается без await, либо возвращает coroutine.
+  - Ответ:
+    ```json
+    {"error": "Help handler must be awaited. Call as await dispatcher.execute('help', ...) in async context.", ...}
+    ```
+  - **Решение:** всегда await-ить dispatcher.execute в async endpoint.
+
+### Важно для интеграторов и пользователей
+- Не реализуйте свой обработчик help — используйте встроенный.
+- Не используйте параметр `command` — только `cmdname`.
+- Все ошибки help-команды теперь сопровождаются понятной подсказкой и примером корректного запроса.
+
+--- 

{mcp_proxy_adapter-2.1.16 → mcp_proxy_adapter-2.1.17}/mcp_proxy_adapter/adapter.py

@@ -236,7 +236,7 @@ class MCPProxyAdapter:
                 # Execute the command
                 logger.debug(f"Executing command {request.method} with parameters {request.params}")
                 try:
-                    result = self.registry.dispatcher.execute(
+                    result = await self.registry.dispatcher.execute(
                         request.method, 
                         **request.params
                     )
@@ -537,7 +537,7 @@ class MCPProxyAdapter:
                 
                 # Execute the command
                 try:
-                    result = self.registry.dispatcher.execute(command, **params)
+                    result = await self.registry.dispatcher.execute(command, **params)
                     
                     # Return result in MCP Proxy format
                     return {"result": result}

{mcp_proxy_adapter-2.1.16 → mcp_proxy_adapter-2.1.17}/mcp_proxy_adapter/dispatchers/json_rpc_dispatcher.py

@@ -141,7 +141,22 @@ class JsonRpcDispatcher(BaseDispatcher):
                 async def _return_sync():
                     return result
                 return await _return_sync()
-        except Exception as e:
+        except TypeError as e:
+            # Попробовать вызвать handler(params=kwargs), если ошибка связана с лишними именованными аргументами
+            if (len(params) == 1 and 'params' in params):
+                try:
+                    if inspect.iscoroutinefunction(handler):
+                        result = handler(params=kwargs)
+                    else:
+                        result = loop.run_in_executor(None, lambda: handler(params=kwargs))
+                    if inspect.isawaitable(result):
+                        return await result
+                    else:
+                        async def _return_sync():
+                            return result
+                        return await _return_sync()
+                except Exception:
+                    pass
             raise e
 
     async def execute(self, command: str, **kwargs) -> Any:
@@ -204,7 +219,20 @@ class JsonRpcDispatcher(BaseDispatcher):
         """
         if not params:
             params = {}
-            
+        # Если передан неправильный параметр 'command', возвращаем понятную ошибку
+        if "command" in params and params["command"]:
+            return {
+                "error": "Parameter 'command' is not supported. Use 'cmdname' instead.",
+                "hint": "Send params: {\"cmdname\": \"your_command\"}",
+                "example": {"jsonrpc": "2.0", "method": "help", "params": {"cmdname": "your_command"}, "id": 1}
+            }
+        # Если handler вызывается синхронно и возвращает coroutine, возвращаем явную ошибку
+        if inspect.iscoroutinefunction(self._help_command):
+            return {
+                "error": "Help handler must be awaited. Call as await dispatcher.execute('help', ...) in async context.",
+                "hint": "Use async endpoint or await the result in your code.",
+                "example": "result = await dispatcher.execute('help', cmdname='your_command')"
+            }
         # If specific command is specified, return information only about it
         if "cmdname" in params and params["cmdname"]:
             command = params["cmdname"]
@@ -213,7 +241,6 @@ class JsonRpcDispatcher(BaseDispatcher):
                     "error": f"Command '{command}' not found",
                     "available_commands": list(self._metadata.keys())
                 }
-            
             return {
                 "command": command,
                 "info": self._metadata[command]

{mcp_proxy_adapter-2.1.16 → mcp_proxy_adapter-2.1.17/mcp_proxy_adapter.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-proxy-adapter
-Version: 2.1.16
+Version: 2.1.17
 Summary: Adapter for exposing Command Registry commands as tools for AI models via MCP Proxy.
 Home-page: https://github.com/vasilyvz/mcp-proxy-adapter
 Author: Vasiliy VZ
@@ -338,4 +338,39 @@ This project uses GitHub Actions for continuous integration and automated publis
 - All tests are run on every push and pull request.
 - On push of a new tag (vX.Y.Z), the package is built and published to PyPI automatically.
 
-See `.github/workflows/publish.yml` for details. 
+See `.github/workflows/publish.yml` for details.
+
+## Встроенная команда help: правила и типовые ошибки
+
+### Как работает
+- Команда `help` всегда встроена в MCPProxyAdapter и не требует реализации или регистрации со стороны пользователя.
+- Для получения справки по конкретной команде используйте параметр `cmdname`:
+  ```json
+  {"jsonrpc": "2.0", "method": "help", "params": {"cmdname": "имя_команды"}, "id": 1}
+  ```
+- Для получения списка всех команд:
+  ```json
+  {"jsonrpc": "2.0", "method": "help", "id": 1}
+  ```
+
+### Типовые ошибки и их решения
+- **Ошибка: передан параметр `command` вместо `cmdname`**
+  - Ответ: 
+    ```json
+    {"error": "Parameter 'command' is not supported. Use 'cmdname' instead.", "hint": "Send params: {\"cmdname\": \"your_command\"}", ...}
+    ```
+  - **Решение:** всегда используйте `cmdname`.
+- **Ошибка сериализации coroutine**
+  - Причина: handler вызывается без await, либо возвращает coroutine.
+  - Ответ:
+    ```json
+    {"error": "Help handler must be awaited. Call as await dispatcher.execute('help', ...) in async context.", ...}
+    ```
+  - **Решение:** всегда await-ить dispatcher.execute в async endpoint.
+
+### Важно для интеграторов и пользователей
+- Не реализуйте свой обработчик help — используйте встроенный.
+- Не используйте параметр `command` — только `cmdname`.
+- Все ошибки help-команды теперь сопровождаются понятной подсказкой и примером корректного запроса.
+
+--- 

{mcp_proxy_adapter-2.1.16 → mcp_proxy_adapter-2.1.17}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mcp-proxy-adapter"
-version = "2.1.16"
+version = "2.1.17"
 description = "Adapter for exposing Command Registry commands as tools for AI models via MCP Proxy."
 readme = "README.md"
 requires-python = ">=3.9"

{mcp_proxy_adapter-2.1.16 → mcp_proxy_adapter-2.1.17}/setup.py

@@ -14,7 +14,7 @@ with open(os.path.join(here, 'requirements.txt'), encoding='utf-8') as f:
 
 setup(
     name="mcp-proxy-adapter",
-    version="2.1.14",
+    version="2.1.17",
     description="Adapter for exposing Command Registry commands as tools for AI models via MCP Proxy.",
     long_description=long_description,
     long_description_content_type="text/markdown",