mcp-proxy-adapter 2.1.9__py3-none-any.whl → 2.1.11__py3-none-any.whl

mcp_proxy_adapter/adapter.py

@@ -493,13 +493,6 @@ class MCPProxyAdapter:
                             "details": "Request requires 'command', 'method' or 'params' field"
                         }
                     }
-                # Подмена help -> __help
-                if command == "help":
-                    command = "__help"
-                    # Переименовываем параметр внутри params
-                    if "command" in params:
-                        params["cmdname"] = params.pop("command")
-                logger.info(f"[DEBUG] MCP CMD: command={command}, params={params}")
                 
                 # Check if command exists
                 if command not in self.registry.dispatcher.get_valid_commands():
@@ -508,14 +501,12 @@ class MCPProxyAdapter:
                         "error": {
                             "code": 404,
                             "message": f"Unknown command: {command}",
-                            "details": f"Unknown command: {command}. Available commands: {', '.join(self.registry.dispatcher.get_valid_commands())}"
+                            "details": f"Command '{command}' not found in registry. Available commands: {', '.join(self.registry.dispatcher.get_valid_commands())}"
                         }
                     }
                 
-                logger.info(f"[DEBUG] MCP CMD: command={command}, params={params}")
                 # Check for required parameters
                 command_info = self.registry.dispatcher.get_command_info(command)
-                logger.info(f"[DEBUG] MCP CMD: command_info={command_info}")
                 if command_info and "params" in command_info:
                     missing_params = []
                     for param_name, param_info in command_info["params"].items():
@@ -531,7 +522,7 @@ class MCPProxyAdapter:
                                 "details": f"Command '{command}' requires following parameters: {', '.join(missing_params)}"
                             }
                         }
-                logger.info(f"[DEBUG] MCP CMD: command={command}, params={params}")
+                
                 # Check parameter types
                 type_errors = self._validate_param_types(command, params)
                 if type_errors:
@@ -543,10 +534,9 @@ class MCPProxyAdapter:
                             "details": "Check parameter types and try again"
                         }
                     }
-                logger.info(f"[DEBUG] MCP CMD: command={command}, params={params}")
+                
                 # Execute the command
                 try:
-                    logger.info(f"[DEBUG] MCP CMD: executing command={command}, params={params}")
                     result = self.registry.dispatcher.execute(command, **params)
                     
                     # Return result in MCP Proxy format

mcp_proxy_adapter/dispatchers/json_rpc_dispatcher.py

@@ -157,26 +157,31 @@ class JsonRpcDispatcher(BaseDispatcher):
     def _help_command(self, params: Dict[str, Any] = None) -> Dict[str, Any]:
         """
         Built-in help command for getting command information.
+        
         Args:
-            params: Command parameters (dict)
+            params: Command parameters
                 cmdname: Command name for detailed information
+                
         Returns:
             Dict[str, Any]: Command help information
         """
-        if params is None:
+        if not params:
             params = {}
-        # If specific command is specified, return information only about it
-        cmdname = params.get("cmdname")
-        if cmdname:
+            
+        # Only support 'cmdname' parameter
+        if "cmdname" in params and params["cmdname"]:
+            cmdname = params["cmdname"]
             if cmdname not in self._metadata:
                 return {
                     "error": f"Command '{cmdname}' not found",
                     "available_commands": list(self._metadata.keys())
                 }
+            
             return {
                 "cmdname": cmdname,
                 "info": self._metadata[cmdname]
             }
+        
         # Otherwise return brief information about all commands
         commands_info = {}
         for cmd, info in self._metadata.items():
@@ -185,8 +190,9 @@ class JsonRpcDispatcher(BaseDispatcher):
                 "description": info["description"],
                 "params_count": len(info["params"])
             }
+        
         return {
             "commands": commands_info,
             "total": len(commands_info),
-            "note": "Use the 'cmdname' parameter to get detailed information about a specific command"
+            "note": "To get info about a specific command, call help with parameter: POST /cmd {\"command\": \"help\", \"params\": {\"cmdname\": \"<command_name>\"}}. Only the 'cmdname' parameter is supported. Calling 'help <command>' (with space) is NOT supported."
         } 

mcp_proxy_adapter/examples/help_best_practices.py

@@ -12,10 +12,10 @@ Run:
 """
 import os
 import sys
-sys.path.insert(0, os.path.abspath(os.path.dirname(os.path.dirname(__file__))))
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '../..')))
 from typing import Any, Dict
 from mcp_proxy_adapter.adapter import MCPProxyAdapter
-from tests.test_mcp_proxy_adapter import MockRegistry
+from mcp_proxy_adapter.testing_utils import MockRegistry
 
 # --- Setup registry and adapter ---
 registry = MockRegistry()

mcp_proxy_adapter/examples/help_usage.py

@@ -12,41 +12,41 @@ Run:
 """
 import os
 import sys
-sys.path.insert(0, os.path.abspath(os.path.dirname(os.path.dirname(__file__))))
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '../..')))
 from typing import Any, Dict
 
 # Assume MCPProxyAdapter and MockRegistry are available from src and tests
 from mcp_proxy_adapter.adapter import MCPProxyAdapter
-from tests.test_mcp_proxy_adapter import MockRegistry
+from mcp_proxy_adapter.testing_utils import MockRegistry
 
 # --- Setup registry and adapter ---
 registry = MockRegistry()
 adapter = MCPProxyAdapter(registry)
 
 # --- Best practice: always check if 'help' is in commands ---
-def call_help(command: str = None) -> Dict[str, Any]:
+def call_help(cmdname: str = None) -> Dict[str, Any]:
     """Call help command with or without parameter."""
     dispatcher = registry.dispatcher
     if "help" in dispatcher.get_valid_commands():
-        if command:
+        if cmdname:
             try:
-                return dispatcher.help_command(command=command)
+                return dispatcher.help_command(cmdname=cmdname)
             except Exception as e:
                 print(f"Project help failed: {e}. Fallback to adapter help.")
-                return adapter_help(command)
+                return adapter_help(cmdname)
         else:
             return dispatcher.help_command()
     else:
-        return adapter_help(command)
+        return adapter_help(cmdname)
 
-def adapter_help(command: str = None) -> Dict[str, Any]:
+def adapter_help(cmdname: str = None) -> Dict[str, Any]:
     """Fallback: call adapter's help (simulate)."""
     dispatcher = registry.dispatcher
-    if not command:
+    if not cmdname:
         return {"source": "adapter", "commands": dispatcher.get_valid_commands()}
-    if command in dispatcher.get_valid_commands():
-        return {"source": "adapter", "command": command, "info": {"description": "Adapter help for command"}}
-    return {"source": "adapter", "error": f"Command '{command}' not found (adapter)", "available_commands": dispatcher.get_valid_commands()}
+    if cmdname in dispatcher.get_valid_commands():
+        return {"source": "adapter", "cmdname": cmdname, "info": {"description": "Adapter help for command"}}
+    return {"source": "adapter", "error": f"Command '{cmdname}' not found (adapter)", "available_commands": dispatcher.get_valid_commands()}
 
 if __name__ == "__main__":
     print("=== Project help (no param) ===")

mcp_proxy_adapter/examples/openapi_server.py

@@ -171,7 +171,7 @@ class MockDispatcher:
             "help": {
                 "description": "Show information about available commands or a specific command.",
                 "params": {
-                    "command": {
+                    "cmdname": {
                         "type": "string",
                         "description": "Command name for detailed info",
                         "required": False
@@ -278,119 +278,105 @@ class MockDispatcher:
 
     def help_command(self, **params):
         """Return info about all commands or a specific command."""
-        # Если в будущем появится пользовательская команда help, можно реализовать её здесь
-        command = params.get("command")
-        if command:
-            info = self.commands_info.get(command)
+        cmdname = params.get("cmdname")
+        if cmdname:
+            info = self.commands_info.get(cmdname)
             if info:
-                return {"command": command, "info": info}
+                return {"cmdname": cmdname, "info": info}
             else:
-                return {"error": f"Command '{command}' not found", "available_commands": list(self.commands_info.keys())}
-        # Если параметр command не указан, возвращаем краткую информацию обо всех
+                return {"error": f"Command '{cmdname}' not found", "available_commands": list(self.commands_info.keys())}
+        # Если параметр cmdname не указан, возвращаем краткую информацию обо всех
         return {
             "commands": {cmd: {"description": info["description"], "params": info["params"]} for cmd, info in self.commands_info.items()},
             "total": len(self.commands_info),
-            "note": "Use the 'command' parameter to get detailed information about a specific command"
+            "note": "Use the 'cmdname' parameter to get detailed information about a specific command"
         }
 
+# --- Создание registry и FastAPI-приложения на верхнем уровне ---
 class CustomMockRegistry(MockRegistry):
     """Custom command registry for example."""
-    
     def __init__(self):
-        """Initialization with custom dispatcher."""
         self.dispatcher = MockDispatcher()
         self.generators = []
 
-def main():
-    """Main function to start server."""
-    # Create command registry
-    registry = CustomMockRegistry()
-    
-    # Create FastAPI object
-    app = FastAPI(
-        title="OpenAPI Server Example",
-        description="Example OpenAPI server with MCP Proxy Adapter integration",
-        version="1.0.0"
-    )
-    
-    # Configure CORS
-    from fastapi.middleware.cors import CORSMiddleware
-    app.add_middleware(
-        CORSMiddleware,
-        allow_origins=["*"],  # Allow requests from all sources
-        allow_credentials=True,
-        allow_methods=["*"],  # Allow all methods
-        allow_headers=["*"],  # Allow all headers
-    )
-    
-    # Create MCP Proxy adapter with explicit endpoint
-    adapter = MCPProxyAdapter(registry, cmd_endpoint="/cmd")
-    
-    # Register adapter endpoints
-    adapter.register_endpoints(app)
-    
-    # Save MCP Proxy configuration to file
-    config_path = os.path.join(os.path.dirname(__file__), "mcp_proxy_config.json")
-    adapter.save_config_to_file(config_path)
-    logger.info(f"MCP Proxy configuration saved to {config_path}")
-    
-    # Define REST endpoints for example (not related to MCP Proxy)
-    @app.get("/")
-    def read_root():
-        """Root endpoint."""
-        return {
-            "message": "OpenAPI Server Example with MCP Proxy Adapter integration",
-            "endpoints": {
-                "items": "/items",
-                "item": "/items/{item_id}",
-                "search": "/items/search",
-                "mcp_proxy": "/cmd"
-            }
+registry = CustomMockRegistry()
+app = FastAPI(
+    title="OpenAPI Server Example",
+    description="Example OpenAPI server with MCP Proxy Adapter integration",
+    version="1.0.0"
+)
+
+# Configure CORS
+from fastapi.middleware.cors import CORSMiddleware
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# Create MCP Proxy adapter with explicit endpoint
+adapter = MCPProxyAdapter(registry, cmd_endpoint="/cmd")
+# Register adapter endpoints
+adapter.register_endpoints(app)
+# Save MCP Proxy configuration to file
+config_path = os.path.join(os.path.dirname(__file__), "mcp_proxy_config.json")
+adapter.save_config_to_file(config_path)
+logger.info(f"MCP Proxy configuration saved to {config_path}")
+
+# --- REST endpoints ---
+@app.get("/")
+def read_root():
+    return {
+        "message": "OpenAPI Server Example with MCP Proxy Adapter integration",
+        "endpoints": {
+            "items": "/items",
+            "item": "/items/{item_id}",
+            "search": "/items/search",
+            "mcp_proxy": "/cmd"
         }
-    
-    @app.get("/items", response_model=List[Item])
-    def read_items():
-        """Get all items."""
-        return items_db
-    
-    @app.get("/items/{item_id}", response_model=Item)
-    def read_item(item_id: int = Path(..., description="Item ID", gt=0)):
-        """Get item by ID."""
-        try:
-            return registry.dispatcher.get_item(item_id)
-        except ValueError as e:
-            return {"error": str(e)}
-    
-    @app.post("/items", response_model=Item)
-    def create_new_item(item: Item = Body(..., description="Data of new item")):
-        """Create new item."""
-        return registry.dispatcher.create_item(item.model_dump())
-    
-    @app.put("/items/{item_id}", response_model=Item)
-    def update_existing_item(
-        item_id: int = Path(..., description="Item ID to update", gt=0),
-        item: Item = Body(..., description="Updated item data")
-    ):
-        """Update item by ID."""
-        try:
-            return registry.dispatcher.update_item(item_id, item.model_dump())
-        except ValueError as e:
-            return {"error": str(e)}
-    
-    @app.delete("/items/{item_id}")
-    def delete_existing_item(item_id: int = Path(..., description="Item ID to delete", gt=0)):
-        """Delete item by ID."""
-        try:
-            return registry.dispatcher.delete_item(item_id)
-        except ValueError as e:
-            return {"error": str(e)}
-    
-    @app.get("/items/search", response_model=List[Item])
-    def search_items_by_keyword(keyword: str = Query(..., description="Search keyword")):
-        """Search items by keyword."""
-        return registry.dispatcher.search_items(keyword)
-    
-    # Start server
+    }
+
+@app.get("/items", response_model=List[Item])
+def read_items():
+    return items_db
+
+@app.get("/items/{item_id}", response_model=Item)
+def read_item(item_id: int = Path(..., description="Item ID", gt=0)):
+    try:
+        return registry.dispatcher.get_item(item_id)
+    except ValueError as e:
+        return {"error": str(e)}
+
+@app.post("/items", response_model=Item)
+def create_new_item(item: Item = Body(..., description="Data of new item")):
+    return registry.dispatcher.create_item(item.model_dump())
+
+@app.put("/items/{item_id}", response_model=Item)
+def update_existing_item(
+    item_id: int = Path(..., description="Item ID to update", gt=0),
+    item: Item = Body(..., description="Updated item data")
+):
+    try:
+        return registry.dispatcher.update_item(item_id, item.model_dump())
+    except ValueError as e:
+        return {"error": str(e)}
+
+@app.delete("/items/{item_id}")
+def delete_existing_item(item_id: int = Path(..., description="Item ID to delete", gt=0)):
+    try:
+        return registry.dispatcher.delete_item(item_id)
+    except ValueError as e:
+        return {"error": str(e)}
+
+@app.get("/items/search", response_model=List[Item])
+def search_items_by_keyword(keyword: str = Query(..., description="Search keyword")):
+    return registry.dispatcher.search_items(keyword)
+
+# --- main() только для запуска через python ---
+def main():
+    import uvicorn
     uvicorn.run(app, host="0.0.0.0", port=8000)
 
 if __name__ == "__main__":

{mcp_proxy_adapter-2.1.9.dist-info → mcp_proxy_adapter-2.1.11.dist-info}/METADATA

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

@@ -1,5 +1,5 @@
 mcp_proxy_adapter/__init__.py,sha256=_6D-TfANWp9zc550M5LUeGPvioFqG1bAl3tZj-gNmJU,463
-mcp_proxy_adapter/adapter.py,sha256=XQGhht_lhLH7eaSAgoxl4NdbT1MwMW5mwDrTJMXl8pk,29631
+mcp_proxy_adapter/adapter.py,sha256=76dkVeDuqLsJ5AhuftzLlwy2M6yr_PfNbmNfo9dXVhc,28844
 mcp_proxy_adapter/models.py,sha256=acqVQBYAojHXeJ1MJyvpMyT6-J6aMxWuZMszn_-RsOU,2338
 mcp_proxy_adapter/registry.py,sha256=jgC4TKaPbMbAsoxvGp2ToaOE4drD-VfZug7WJbm4IW4,15853
 mcp_proxy_adapter/schema.py,sha256=HZM0TTQTSi8ha1TEeVevdCyGZOUPoT1soB7Nex0hV50,10947
@@ -9,21 +9,21 @@ mcp_proxy_adapter/analyzers/docstring_analyzer.py,sha256=T3FLJEo_uChShfiEKRl8GpV
 mcp_proxy_adapter/analyzers/type_analyzer.py,sha256=6Wac7osKwF03waFSwQ8ZM0Wqn_zAP2D-I4WMEpR0hQM,5230
 mcp_proxy_adapter/dispatchers/__init__.py,sha256=FWgimgInGphIjCEnvA3-ZExiapUzYAVis2H9C5IWivU,365
 mcp_proxy_adapter/dispatchers/base_dispatcher.py,sha256=S5_Xri058jAmOWeit1tedB_GMZQ9RLcNcYabA83ZF6k,2288
-mcp_proxy_adapter/dispatchers/json_rpc_dispatcher.py,sha256=Iv7Z4GX5Wy6gGNESEYqjLnrPvxPYXa9WJiwaTSKMjg0,6238
+mcp_proxy_adapter/dispatchers/json_rpc_dispatcher.py,sha256=S98qSj0p3glfiPcRirqCZaoiD9PrVVM3t7Lrgd6S8kM,6461
 mcp_proxy_adapter/examples/analyze_config.py,sha256=vog7TNHDw5ZoYhQLbAvZvEoufmQwH54KJzQBJrSq5w4,4283
 mcp_proxy_adapter/examples/basic_integration.py,sha256=w_oA777YiQt36gzI113KPQ6k45caXbMCqW9hD8sy8zo,4657
 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=wUtZRnAktnpfAc9vAvqSxUquHEr5ewaPDPyc6BoCqdQ,2637
-mcp_proxy_adapter/examples/help_usage.py,sha256=UOd3HJeYlQpQkAyceGNm66jXX_h-T05pjIGD-b7-Pfg,2568
+mcp_proxy_adapter/examples/help_best_practices.py,sha256=Bit9Ywl9vGvM_kuV8DJ6pIDK4mY4mF2Gia9rLc56RpI,2646
+mcp_proxy_adapter/examples/help_usage.py,sha256=9-65TyECtQYqPJLG3tlOWctI1zoCh6dEewh_i8mCdus,2577
 mcp_proxy_adapter/examples/mcp_proxy_client.py,sha256=z4IzFlGigVTQSb8TpcrQ_a0migsmC58LnNwc8wZmTfw,3811
-mcp_proxy_adapter/examples/openapi_server.py,sha256=MXCr5qifI03oexgdY05SsnbhWCe2_6ebnYOfAdk_Uug,14027
+mcp_proxy_adapter/examples/openapi_server.py,sha256=KjUkXnGMnCxiRd71b1NFoHf40y9REXFqnmaxAgK4FB8,13229
 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/validators/docstring_validator.py,sha256=Onpq2iNJ1qF4ejkJJIlBkLROuSNIVALHVmXIgkCpaFI,2934
 mcp_proxy_adapter/validators/metadata_validator.py,sha256=uCrn38-VYYn89l6f5CC_GoTAHAweaOW2Z6Esro1rtGw,3155
-mcp_proxy_adapter-2.1.9.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
-mcp_proxy_adapter-2.1.9.dist-info/METADATA,sha256=nZ4aznn1akyMf7bPXO3kQb0Az6FiOx2hoCssFuvM05Y,12578
-mcp_proxy_adapter-2.1.9.dist-info/WHEEL,sha256=GHB6lJx2juba1wDgXDNlMTyM13ckjBMKf-OnwgKOCtA,91
-mcp_proxy_adapter-2.1.9.dist-info/top_level.txt,sha256=JZT7vPLBYrtroX-ij68JBhJYbjDdghcV-DFySRy-Nnw,18
-mcp_proxy_adapter-2.1.9.dist-info/RECORD,,
+mcp_proxy_adapter-2.1.11.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
+mcp_proxy_adapter-2.1.11.dist-info/METADATA,sha256=2Z-WGz0AwAtHoUkUDhvQ1B_3enFmOj7epWGpm4C7UZo,12579
+mcp_proxy_adapter-2.1.11.dist-info/WHEEL,sha256=GHB6lJx2juba1wDgXDNlMTyM13ckjBMKf-OnwgKOCtA,91
+mcp_proxy_adapter-2.1.11.dist-info/top_level.txt,sha256=JZT7vPLBYrtroX-ij68JBhJYbjDdghcV-DFySRy-Nnw,18
+mcp_proxy_adapter-2.1.11.dist-info/RECORD,,