mcp-proxy-adapter 2.1.13__py3-none-any.whl → 2.1.15__py3-none-any.whl

mcp_proxy_adapter/testing_utils.py

@@ -4,6 +4,9 @@ Test utilities for MCP Proxy Adapter: mock dispatcher, registry, and OpenAPI gen
 Can be used in examples and tests.
 """
 
+import asyncio
+import inspect
+
 def success_command(value: int = 1) -> dict:
     return {"result": value * 2}
 
@@ -65,13 +68,18 @@ class MockDispatcher:
     def execute_from_params(self, **params):
         if "query" in params and params["query"] in self.commands:
             command = params.pop("query")
-            return self.execute(command, **params)
+            result = self.execute(command, **params)
+            return result
         return {"available_commands": self.get_valid_commands(), "received_params": params}
 
-    def execute(self, command, **params):
+    async def execute(self, command, **params):
         if command not in self.commands:
             raise KeyError(f"Unknown command: {command}")
-        return self.commands[command](**params)
+        handler = self.commands[command]
+        if inspect.iscoroutinefunction(handler):
+            return await handler(**params)
+        loop = asyncio.get_running_loop()
+        return await loop.run_in_executor(None, lambda: handler(**params))
 
     def get_valid_commands(self):
         return list(self.commands.keys())

mcp_proxy_adapter/validators/docstring_validator.py

@@ -0,0 +1,75 @@
+"""
+Validator for checking the correspondence between docstrings and function signatures.
+"""
+import inspect
+from typing import Dict, Any, Optional, Callable, List, Tuple, get_type_hints
+import docstring_parser
+
+class DocstringValidator:
+    """
+    Validator for checking the correspondence between docstrings and handler functions.
+    
+    This class verifies that function docstrings match their signatures,
+    contain all necessary sections, and describe all parameters.
+    """
+    
+    def validate(self, handler: Callable, command_name: str, metadata: Dict[str, Any]) -> Tuple[bool, List[str]]:
+        """
+        Validates the function's docstring against its formal parameters.
+        
+        Args:
+            handler: Command handler function
+            command_name: Command name
+            metadata: Command metadata
+            
+        Returns:
+            Tuple[bool, List[str]]: Validity flag and list of errors
+        """
+        errors = []
+        
+        # Get formal parameters of the function
+        sig = inspect.signature(handler)
+        formal_params = list(sig.parameters.keys())
+        
+        # Skip self parameter for methods
+        if formal_params and formal_params[0] == 'self':
+            formal_params = formal_params[1:]
+            
+        # Parse docstring
+        docstring = handler.__doc__ or ""
+        parsed_doc = docstring_parser.parse(docstring)
+        
+        # Check for function description
+        if not parsed_doc.short_description and not parsed_doc.long_description:
+            errors.append(f"Missing function description")
+        
+        # Get parameters from docstring
+        doc_params = {param.arg_name: param for param in parsed_doc.params}
+        
+        # Check that all formal parameters are described in the docstring
+        for param in formal_params:
+            # Skip special parameters
+            if param in ('params', 'kwargs'):
+                continue
+                
+            if param not in doc_params:
+                errors.append(f"Parameter '{param}' is not described in the function docstring")
+        
+        # Check for returns in docstring
+        if not parsed_doc.returns and not any(t.type_name == 'Returns' for t in parsed_doc.meta):
+            errors.append(f"Missing return value description in the function docstring")
+        
+        # Check for type annotations
+        try:
+            type_hints = get_type_hints(handler)
+            for param in formal_params:
+                # Skip special parameters
+                if param in ('params', 'kwargs'):
+                    continue
+                    
+                if param not in type_hints:
+                    errors.append(f"Missing type annotation for parameter '{param}' in function {command_name}")
+        except Exception as e:
+            errors.append(f"Error getting type hints: {str(e)}")
+        
+        return len(errors) == 0, errors 

mcp_proxy_adapter/validators/metadata_validator.py

@@ -0,0 +1,76 @@
+"""
+Validator for checking command metadata against function signatures.
+"""
+import inspect
+from typing import Dict, Any, Optional, Callable, List, Tuple
+
+class MetadataValidator:
+    """
+    Validator for checking handler function metadata.
+    
+    This class verifies that command metadata matches function signatures,
+    and all parameters are correctly described.
+    """
+    
+    def validate(self, handler: Callable, command_name: str, metadata: Dict[str, Any]) -> Tuple[bool, List[str]]:
+        """
+        Checks if metadata matches function's formal parameters.
+        
+        Args:
+            handler: Command handler function
+            command_name: Command name
+            metadata: Command metadata
+            
+        Returns:
+            Tuple[bool, List[str]]: Validity flag and list of errors
+        """
+        errors = []
+        
+        # Check presence of main fields in metadata
+        if not metadata.get('description'):
+            errors.append(f"Missing description for command '{command_name}'")
+            
+        # Get function's formal parameters
+        sig = inspect.signature(handler)
+        formal_params = list(sig.parameters.keys())
+        
+        # Skip self parameter for methods
+        if formal_params and formal_params[0] == 'self':
+            formal_params = formal_params[1:]
+            
+        # Check presence of parameters in metadata
+        if 'parameters' not in metadata or not isinstance(metadata['parameters'], dict):
+            errors.append(f"Parameters are missing or incorrectly defined in metadata for command '{command_name}'")
+            return False, errors
+            
+        meta_params = metadata['parameters']
+        
+        # Check that all formal parameters are in metadata
+        for param in formal_params:
+            # Skip special parameters
+            if param in ('params', 'kwargs'):
+                continue
+                
+            if param not in meta_params:
+                errors.append(f"Parameter '{param}' is not described in metadata for command '{command_name}'")
+                continue
+                
+            param_info = meta_params[param]
+            
+            # Check presence of required fields for parameter
+            if not isinstance(param_info, dict):
+                errors.append(f"Incorrect format for parameter '{param}' description in metadata for command '{command_name}'")
+                continue
+                
+            if 'type' not in param_info:
+                errors.append(f"Type is not specified for parameter '{param}' in metadata for command '{command_name}'")
+                
+            if 'description' not in param_info:
+                errors.append(f"Description is not specified for parameter '{param}' in metadata for command '{command_name}'")
+        
+        # Check that there are no extra parameters in metadata
+        for param in meta_params:
+            if param not in formal_params and param not in ('params', 'kwargs'):
+                errors.append(f"Extra parameter '{param}' in metadata for command '{command_name}'")
+        
+        return len(errors) == 0, errors 

{mcp_proxy_adapter-2.1.13.dist-info → mcp_proxy_adapter-2.1.15.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-proxy-adapter
-Version: 2.1.13
+Version: 2.1.15
 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

mcp_proxy_adapter-2.1.15.dist-info/RECORD

@@ -0,0 +1,28 @@
+mcp_proxy_adapter/adapter.py,sha256=x5pT-t4uT12O3GzLurrKBSQ_hwVpjhCRx5oZ5AdZnpY,28856
+mcp_proxy_adapter/models.py,sha256=8zVWU6ly18pWozOnKQ2gsGpmTgL37-fFE_Fr1SDW-Nk,2530
+mcp_proxy_adapter/registry.py,sha256=IXzMthYRHvEq37Y99ID49kv1ovqb-RFccKznBKxBRuc,15926
+mcp_proxy_adapter/schema.py,sha256=HZM0TTQTSi8ha1TEeVevdCyGZOUPoT1soB7Nex0hV50,10947
+mcp_proxy_adapter/testing_utils.py,sha256=5drf9PFUcmUiShNZXN5x6FSbDzB-2jCAb1RvleUanW0,4510
+mcp_proxy_adapter/analyzers/__init__.py,sha256=Nqnn8clbgv-5l0PgxcTOldg8mkMKrFn4TvPL-rYUUGg,1
+mcp_proxy_adapter/analyzers/docstring_analyzer.py,sha256=T3FLJEo_uChShfiEKRl8GpVoHvh5HiudZkxnj4KixfA,7541
+mcp_proxy_adapter/analyzers/type_analyzer.py,sha256=6Wac7osKwF03waFSwQ8ZM0Wqn_zAP2D-I4WMEpR0hQM,5230
+mcp_proxy_adapter/dispatchers/__init__.py,sha256=Nqnn8clbgv-5l0PgxcTOldg8mkMKrFn4TvPL-rYUUGg,1
+mcp_proxy_adapter/dispatchers/base_dispatcher.py,sha256=G9_dMwboNmpvg9OapWKEXI52QsEiIigfjLMs_7tMbNg,2356
+mcp_proxy_adapter/dispatchers/json_rpc_dispatcher.py,sha256=sdRwvI5f-2dtI7U_sv6-pqUvxBMirgUDl_P7la3EV0A,8054
+mcp_proxy_adapter/examples/analyze_config.py,sha256=vog7TNHDw5ZoYhQLbAvZvEoufmQwH54KJzQBJrSq5w4,4283
+mcp_proxy_adapter/examples/basic_integration.py,sha256=mtRval4VSUgTb_C2p8U_DPPSEKA08dZYKZk-bOrE4H4,4470
+mcp_proxy_adapter/examples/docstring_and_schema_example.py,sha256=8a6k7_wG1afnjzqCD6W_LBM-N8k3t0w1H_au3-14ds8,2201
+mcp_proxy_adapter/examples/extension_example.py,sha256=2UnrcHw0yRZuFzyvW6zsJ8_NTmGWU79fnCEG6w8VRDY,2525
+mcp_proxy_adapter/examples/help_best_practices.py,sha256=Bit9Ywl9vGvM_kuV8DJ6pIDK4mY4mF2Gia9rLc56RpI,2646
+mcp_proxy_adapter/examples/help_usage.py,sha256=JIUsZofdLFyI7FcwPF-rLxipF1-HaZINzVK1KBh0vxA,2577
+mcp_proxy_adapter/examples/mcp_proxy_client.py,sha256=z4IzFlGigVTQSb8TpcrQ_a0migsmC58LnNwc8wZmTfw,3811
+mcp_proxy_adapter/examples/openapi_server.py,sha256=5gRM-EHvMsnNtS_M6l_pNPN5EkSf4X1Lcq4E1Xs5tp0,13387
+mcp_proxy_adapter/examples/project_structure_example.py,sha256=aWQwQqNn3JOCAB6ngYx_JOUh8uy73B6Q51r6HsPUUmM,1593
+mcp_proxy_adapter/examples/testing_example.py,sha256=s_ln2U7sMdCey87gmrh9-SjZMF2EW602uGhI1rDsCaM,2461
+mcp_proxy_adapter/validators/docstring_validator.py,sha256=Onpq2iNJ1qF4ejkJJIlBkLROuSNIVALHVmXIgkCpaFI,2934
+mcp_proxy_adapter/validators/metadata_validator.py,sha256=uCrn38-VYYn89l6f5CC_GoTAHAweaOW2Z6Esro1rtGw,3155
+mcp_proxy_adapter-2.1.15.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
+mcp_proxy_adapter-2.1.15.dist-info/METADATA,sha256=nUnnfN0k4rxhUdLgJKk6hJd_6S9I5hswuG3baEHL42Q,8886
+mcp_proxy_adapter-2.1.15.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
+mcp_proxy_adapter-2.1.15.dist-info/top_level.txt,sha256=JZT7vPLBYrtroX-ij68JBhJYbjDdghcV-DFySRy-Nnw,18
+mcp_proxy_adapter-2.1.15.dist-info/RECORD,,

mcp_proxy_adapter-2.1.13.dist-info/RECORD

@@ -1,19 +0,0 @@
-mcp_proxy_adapter/testing_utils.py,sha256=RWjQFNSUtVkeP0qNzp6_jrT6_tub3w_052DrRmvxVk0,4243
-mcp_proxy_adapter/analyzers/__init__.py,sha256=Nqnn8clbgv-5l0PgxcTOldg8mkMKrFn4TvPL-rYUUGg,1
-mcp_proxy_adapter/dispatchers/__init__.py,sha256=Nqnn8clbgv-5l0PgxcTOldg8mkMKrFn4TvPL-rYUUGg,1
-mcp_proxy_adapter/dispatchers/json_rpc_dispatcher.py,sha256=Ibp-4d4kKf_AW_yv_27Zb_PgFIfa3tZLmuppMg8YqsY,8034
-mcp_proxy_adapter/examples/analyze_config.py,sha256=vog7TNHDw5ZoYhQLbAvZvEoufmQwH54KJzQBJrSq5w4,4283
-mcp_proxy_adapter/examples/basic_integration.py,sha256=mtRval4VSUgTb_C2p8U_DPPSEKA08dZYKZk-bOrE4H4,4470
-mcp_proxy_adapter/examples/docstring_and_schema_example.py,sha256=c96L4KF_7yWzffmvd4hyeQuXSdYyYkv7Uvuy0QxgMcQ,1929
-mcp_proxy_adapter/examples/extension_example.py,sha256=vnatnFdNTapMpPcQ79Ugitk92ZiUfpLTs7Dvsodf1og,2277
-mcp_proxy_adapter/examples/help_best_practices.py,sha256=Bit9Ywl9vGvM_kuV8DJ6pIDK4mY4mF2Gia9rLc56RpI,2646
-mcp_proxy_adapter/examples/help_usage.py,sha256=JIUsZofdLFyI7FcwPF-rLxipF1-HaZINzVK1KBh0vxA,2577
-mcp_proxy_adapter/examples/mcp_proxy_client.py,sha256=z4IzFlGigVTQSb8TpcrQ_a0migsmC58LnNwc8wZmTfw,3811
-mcp_proxy_adapter/examples/openapi_server.py,sha256=5gRM-EHvMsnNtS_M6l_pNPN5EkSf4X1Lcq4E1Xs5tp0,13387
-mcp_proxy_adapter/examples/project_structure_example.py,sha256=sswTo6FZb1F5juHa0FYG3cgvrh3wfgGfJu2bBy5tCm4,1460
-mcp_proxy_adapter/examples/testing_example.py,sha256=AB13c4C1bjs1145O-yriwyreeVXtMOlQLzs2BCGmprk,1719
-mcp_proxy_adapter-2.1.13.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
-mcp_proxy_adapter-2.1.13.dist-info/METADATA,sha256=1flBa3KLq1QMMf9T-NcpgpP3LxJY4_BwMAUW21K915Q,8886
-mcp_proxy_adapter-2.1.13.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-mcp_proxy_adapter-2.1.13.dist-info/top_level.txt,sha256=JZT7vPLBYrtroX-ij68JBhJYbjDdghcV-DFySRy-Nnw,18
-mcp_proxy_adapter-2.1.13.dist-info/RECORD,,