mcp-proxy-adapter 2.1.1__py3-none-any.whl → 2.1.3__py3-none-any.whl

examples/openapi_server.py

@@ -1,369 +0,0 @@
-"""
-Example of creating an OpenAPI server using MCP Proxy Adapter.
-
-Usage:
-    python examples/openapi_server.py
-
-Server will be available at: http://localhost:8000
-"""
-import os
-import sys
-import logging
-from typing import Dict, List, Any
-
-# Add project root directory to sys.path
-sys.path.insert(0, os.path.abspath(os.path.dirname(os.path.dirname(__file__))))
-
-from fastapi import FastAPI, Query, Path, Body, Request
-from pydantic import BaseModel, Field
-import uvicorn
-
-# Import MCP Proxy Adapter
-from mcp_proxy_adapter.adapter import MCPProxyAdapter
-
-# Import models for JSON-RPC
-from mcp_proxy_adapter.models import JsonRpcRequest, JsonRpcResponse
-
-# Import MockRegistry from tests for example
-# (in a real project, CommandRegistry would be used)
-from tests.test_mcp_proxy_adapter import MockRegistry
-
-# Configure logging
-logging.basicConfig(level=logging.DEBUG)
-logger = logging.getLogger(__name__)
-
-# Data model definitions
-class Item(BaseModel):
-    """Data model for an item."""
-    id: int = Field(..., description="Unique item identifier")
-    name: str = Field(..., description="Item name")
-    description: str = Field(None, description="Item description")
-    price: float = Field(..., description="Item price")
-    is_available: bool = Field(True, description="Item availability")
-
-    model_config = {
-        "json_schema_extra": {
-            "example": {
-                "id": 1,
-                "name": "Super Product",
-                "description": "Best product on the market",
-                "price": 99.99,
-                "is_available": True
-            }
-        }
-    }
-
-# Example data
-items_db = [
-    {
-        "id": 1,
-        "name": "Smartphone X",
-        "description": "Latest smartphone with cutting-edge technology",
-        "price": 999.99,
-        "is_available": True
-    },
-    {
-        "id": 2,
-        "name": "Laptop Y",
-        "description": "Powerful laptop for professionals",
-        "price": 1499.99,
-        "is_available": True
-    },
-    {
-        "id": 3,
-        "name": "Tablet Z",
-        "description": "Compact tablet for creativity",
-        "price": 599.99,
-        "is_available": False
-    }
-]
-
-# Define commands for MockRegistry
-class MockDispatcher:
-    """Mock for command dispatcher in example."""
-    
-    def __init__(self):
-        self.commands = {
-            "get_items": self.get_items,
-            "get_item": self.get_item,
-            "create_item": self.create_item,
-            "update_item": self.update_item,
-            "delete_item": self.delete_item,
-            "search_items": self.search_items,
-            "execute": self.execute_command
-        }
-        self.commands_info = {
-            "get_items": {
-                "description": "Get list of all items",
-                "params": {}
-            },
-            "get_item": {
-                "description": "Get item by ID",
-                "params": {
-                    "item_id": {
-                        "type": "integer",
-                        "description": "Item ID to search for",
-                        "required": True
-                    }
-                }
-            },
-            "create_item": {
-                "description": "Create new item",
-                "params": {
-                    "item": {
-                        "type": "object",
-                        "description": "Item data",
-                        "required": True
-                    }
-                }
-            },
-            "update_item": {
-                "description": "Update item by ID",
-                "params": {
-                    "item_id": {
-                        "type": "integer",
-                        "description": "Item ID to update",
-                        "required": True
-                    },
-                    "updated_data": {
-                        "type": "object",
-                        "description": "Updated data",
-                        "required": True
-                    }
-                }
-            },
-            "delete_item": {
-                "description": "Delete item by ID",
-                "params": {
-                    "item_id": {
-                        "type": "integer",
-                        "description": "Item ID to delete",
-                        "required": True
-                    }
-                }
-            },
-            "search_items": {
-                "description": "Search items by keyword",
-                "params": {
-                    "keyword": {
-                        "type": "string",
-                        "description": "Search keyword",
-                        "required": True
-                    }
-                }
-            },
-            "execute": {
-                "description": "Universal command for executing queries",
-                "params": {
-                    "query": {
-                        "type": "string",
-                        "description": "Query to execute",
-                        "required": False
-                    },
-                    "subcommand": {
-                        "type": "string",
-                        "description": "Subcommand to execute",
-                        "required": False
-                    }
-                }
-            }
-        }
-    
-    def execute(self, command, **params):
-        """Executes command with specified parameters."""
-        if command not in self.commands:
-            raise KeyError(f"Unknown command: {command}")
-        return self.commands[command](**params)
-        
-    def execute_command(self, **params):
-        """Universal method for executing commands."""
-        query = params.get("query", "")
-        subcommand = params.get("subcommand", "")
-        
-        # Debug logging
-        logger.info(f"Executing universal command with query={query}, subcommand={subcommand}, params={params}")
-        
-        # Handle different command types
-        if query.lower() in ["list", "all", "items"]:
-            # Return list of all items
-            return self.get_items()
-        elif query.lower() == "search" and "keyword" in params:
-            # Search by keyword
-            return self.search_items(params["keyword"])
-        elif query.isdigit() or (isinstance(query, int) and query > 0):
-            # If query looks like an ID, return item by ID
-            try:
-                return self.get_item(int(query))
-            except ValueError:
-                return {"error": f"Item with ID {query} not found"}
-        else:
-            # By default return information about available commands
-            commands = list(self.commands.keys())
-            return {
-                "available_commands": commands,
-                "message": "Use one of the available commands or specify query for executing query",
-                "received_params": params
-            }
-    
-    def get_valid_commands(self):
-        """Returns list of available commands."""
-        return list(self.commands.keys())
-    
-    def get_command_info(self, command):
-        """Returns information about command."""
-        return self.commands_info.get(command)
-    
-    def get_commands_info(self):
-        """Returns information about all commands."""
-        return self.commands_info
-    
-    # Command implementations
-    def get_items(self):
-        """Get list of all items."""
-        return items_db
-    
-    def get_item(self, item_id):
-        """Get item by ID."""
-        for item in items_db:
-            if item["id"] == item_id:
-                return item
-        raise ValueError(f"Item with ID {item_id} not found")
-    
-    def create_item(self, item):
-        """Create new item."""
-        # Find maximum ID
-        max_id = max([i["id"] for i in items_db]) if items_db else 0
-        # Create new item with increased ID
-        new_item = {**item, "id": max_id + 1}
-        items_db.append(new_item)
-        return new_item
-    
-    def update_item(self, item_id, updated_data):
-        """Update item by ID."""
-        for i, item in enumerate(items_db):
-            if item["id"] == item_id:
-                # Update item, keeping original ID
-                updated_item = {**item, **updated_data, "id": item_id}
-                items_db[i] = updated_item
-                return updated_item
-        raise ValueError(f"Item with ID {item_id} not found")
-    
-    def delete_item(self, item_id):
-        """Delete item by ID."""
-        for i, item in enumerate(items_db):
-            if item["id"] == item_id:
-                del items_db[i]
-                return {"message": f"Item with ID {item_id} successfully deleted"}
-        raise ValueError(f"Item with ID {item_id} not found")
-    
-    def search_items(self, keyword):
-        """Search items by keyword."""
-        keyword = keyword.lower()
-        return [
-            item for item in items_db
-            if keyword in item["name"].lower() or 
-               (item["description"] and keyword in item["description"].lower())
-        ]
-
-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"
-            }
-        }
-    
-    @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
-    uvicorn.run(app, host="0.0.0.0", port=8000)
-
-if __name__ == "__main__":
-    main() 

examples/project_structure_example.py

@@ -1,47 +0,0 @@
-"""
-Project Structure Example for MCPProxyAdapter
-
-- How to organize your project for clean integration
-- Where to place registry, commands, adapter
-- How to register endpoints in FastAPI
-
-Run:
-    python examples/project_structure_example.py
-"""
-import os
-import sys
-sys.path.insert(0, os.path.abspath(os.path.dirname(os.path.dirname(__file__))))
-from fastapi import FastAPI
-from mcp_proxy_adapter.adapter import MCPProxyAdapter
-
-# --- Command registry and commands ---
-class MyRegistry:
-    def __init__(self):
-        self.dispatcher = self
-        self.commands = {"hello": self.hello}
-        self.commands_info = {"hello": {"description": "Say hello", "params": {}}}
-    def get_valid_commands(self):
-        return list(self.commands.keys())
-    def get_command_info(self, command):
-        return self.commands_info.get(command)
-    def get_commands_info(self):
-        return self.commands_info
-    def execute(self, command, **params):
-        if command == "hello":
-            return {"message": "Hello, world!"}
-        raise KeyError(f"Unknown command: {command}")
-    def add_generator(self, generator):
-        pass
-    def hello(self):
-        """Say hello."""
-        return {"message": "Hello, world!"}
-
-# --- FastAPI app and adapter ---
-app = FastAPI()
-registry = MyRegistry()
-adapter = MCPProxyAdapter(registry)
-adapter.register_endpoints(app)
-
-if __name__ == "__main__":
-    import uvicorn
-    uvicorn.run(app, host="0.0.0.0", port=8000) 

examples/testing_example.py

@@ -1,53 +0,0 @@
-"""
-Testing Example for MCPProxyAdapter
-
-- How to write unit and integration tests for commands
-- How to test help and error handling
-- Best practices for test structure
-
-Run:
-    python examples/testing_example.py
-"""
-import os
-import sys
-sys.path.insert(0, os.path.abspath(os.path.dirname(os.path.dirname(__file__))))
-from mcp_proxy_adapter.adapter import MCPProxyAdapter
-
-class MyRegistry:
-    def __init__(self):
-        self.dispatcher = self
-        self.commands = {"echo": self.echo}
-        self.commands_info = {"echo": {"description": "Echo input string", "params": {"text": {"type": "string", "description": "Text to echo", "required": True}}}}
-    def get_valid_commands(self):
-        return list(self.commands.keys())
-    def get_command_info(self, command):
-        return self.commands_info.get(command)
-    def get_commands_info(self):
-        return self.commands_info
-    def execute(self, command, **params):
-        if command == "echo":
-            return self.echo(**params)
-        raise KeyError(f"Unknown command: {command}")
-    def add_generator(self, generator):
-        pass
-    def echo(self, text: str) -> str:
-        """Echo input string."""
-        return text
-
-def test_echo():
-    registry = MyRegistry()
-    adapter = MCPProxyAdapter(registry)
-    # Unit test
-    assert registry.execute("echo", text="hi") == "hi"
-    # Integration test (simulate JSON-RPC)
-    class Request:
-        method = "echo"
-        params = {"text": "hello"}
-        id = 1
-    response = adapter.router.routes[0].endpoint(Request())
-    # Not a real FastAPI call, just for illustration
-    print("[TEST] Echo command passed.")
-
-if __name__ == "__main__":
-    test_echo()
-    print("All tests passed.") 

mcp_proxy_adapter-2.1.1.dist-info/RECORD

@@ -1,61 +0,0 @@
-docs/README.md,sha256=XpZqqKcf7GZ_uqtaadmIZc4dE9oyKv7biKj41kDtQo4,4633
-docs/README_ru.md,sha256=Ln8oDVOurhBVurQaEFDweVvq_bZZbdFSSTvWTrpBgMs,6326
-docs/architecture.md,sha256=wF5-RMQI-QssY4jA2lSKjjq6iHunda-n2PqI5ELAj84,10430
-docs/architecture_ru.md,sha256=Ato3CoAmhNBukMO6uje12e5-OlpDYVrwGIcN1CKqTsw,15529
-docs/command_development.md,sha256=-CKfEtLO-4tB2WKZNbIT1Ao4juiKFBcKS7As4_1ja74,6645
-docs/command_development_ru.md,sha256=kzvYpnEfsXfZxZY1wswwDChzBtMtEY9l74M7XkWxtHk,19968
-docs/deployment.md,sha256=eOOCq8V6Gz_SDo9hReXKXXNtaS8WmrxR-KXjJjUE1pw,4988
-docs/deployment_ru.md,sha256=0eNxKqiqc-sIht4brdZVEcxZkbrUP4y95PhfpD_0Qyg,40107
-docs/examples.md,sha256=85kfd73rgqJ2DUD3PrRfjViCXgv5bM_9Uqizm_ET7NE,6348
-docs/examples_ru.md,sha256=mxQqwKXMX6OcY6tyfuRgmYqAQXYnrzTGOJS_u5ECUcs,11866
-docs/mcp_proxy_adapter.md,sha256=Y-dcFKwYbYJe5_zDrvlDPuSz-S1czL7Gh848EzclS7k,8210
-docs/mcp_proxy_adapter_ru.md,sha256=aJ1KAyoyzcRPSn7YGralpUGO-zmUQMtDKoQ2zrOUVTc,17489
-docs/quickstart.md,sha256=YH0KspJcbe59ynpRf9kne-QsLGcUo4kKtNiEZ48nrus,5419
-docs/quickstart_ru.md,sha256=biipkQ4_XGVzqxLeGptzfWxyr6J9TN1ggdhCf2pDWKA,11884
-docs/testing.md,sha256=Z1hdqairo14QMoPxeBX1_YAbbS3Uedy4uaxfvu8aG5k,7572
-docs/testing_ru.md,sha256=z2-zGIXuFx8GpLYwydP9Oe3N8l_zVzheLBYvxgI-f6k,18219
-docs/validation_ru.md,sha256=iYtM3ZoFGe3_EaCG0738LkGJ5FPayrEr2z_KPhNcs0Q,15886
-examples/analyze_config.py,sha256=vog7TNHDw5ZoYhQLbAvZvEoufmQwH54KJzQBJrSq5w4,4283
-examples/basic_integration.py,sha256=w_oA777YiQt36gzI113KPQ6k45caXbMCqW9hD8sy8zo,4657
-examples/docstring_and_schema_example.py,sha256=c96L4KF_7yWzffmvd4hyeQuXSdYyYkv7Uvuy0QxgMcQ,1929
-examples/extension_example.py,sha256=vnatnFdNTapMpPcQ79Ugitk92ZiUfpLTs7Dvsodf1og,2277
-examples/help_best_practices.py,sha256=wUtZRnAktnpfAc9vAvqSxUquHEr5ewaPDPyc6BoCqdQ,2637
-examples/help_usage.py,sha256=UOd3HJeYlQpQkAyceGNm66jXX_h-T05pjIGD-b7-Pfg,2568
-examples/mcp_proxy_client.py,sha256=z4IzFlGigVTQSb8TpcrQ_a0migsmC58LnNwc8wZmTfw,3811
-examples/mcp_proxy_config.json,sha256=39aeV7NNEZstX9RAOdsr5tUZnvCuo7bR38Xc1sGGCJI,3655
-examples/openapi_server.py,sha256=hueoG9KcimOc4W27euWksMYjjG8Jz-li9hEKi3ZCDBk,12515
-examples/project_structure_example.py,sha256=sswTo6FZb1F5juHa0FYG3cgvrh3wfgGfJu2bBy5tCm4,1460
-examples/testing_example.py,sha256=AB13c4C1bjs1145O-yriwyreeVXtMOlQLzs2BCGmprk,1719
-mcp_proxy_adapter/__init__.py,sha256=_6D-TfANWp9zc550M5LUeGPvioFqG1bAl3tZj-gNmJU,463
-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
-mcp_proxy_adapter/analyzers/__init__.py,sha256=2rcYZDP-bXq078MQpxP32lAwYYyRhOwAQGBcefBfBzY,368
-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=FWgimgInGphIjCEnvA3-ZExiapUzYAVis2H9C5IWivU,365
-mcp_proxy_adapter/dispatchers/base_dispatcher.py,sha256=S5_Xri058jAmOWeit1tedB_GMZQ9RLcNcYabA83ZF6k,2288
-mcp_proxy_adapter/dispatchers/json_rpc_dispatcher.py,sha256=ffu1M32E1AdC7IB44mlbV2L56eJQMsp-7fYi_r4rmHc,6331
-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.1.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
-scripts/publish.py,sha256=MMKksSAzWoZOlxxHOm9-o6juEJYj5AMS4OG5pDIeChw,2627
-scripts/code_analyzer/code_analyzer.py,sha256=FmWctoxttImvIPJoyNMLyUt7pEg3mQihqt6T9vMBKVQ,12766
-scripts/code_analyzer/register_commands.py,sha256=GpQxdFsA0BWHONZpDjl18zkoqlbV6pmkabLMwIR_1JE,20545
-tests/conftest.py,sha256=gkusSolrEp6-AHLjMKDUVxEcmfboa2P5SbeyiMugP-E,495
-tests/test_adapter.py,sha256=ohLX1wGFmHnv5DXJx2segjT2EEg9-3ZU9FKwS74D7KI,18247
-tests/test_adapter_coverage.py,sha256=k5oCvT9EQy_8JYam4Os88Npnn-Hgr0pm_ChHyRwk4Vc,8813
-tests/test_basic_dispatcher.py,sha256=wB30AM3UPI_EklAMrGIwQHDTqbfY80I5spi6arpdxCc,5472
-tests/test_command_registry.py,sha256=Ze4qwi2fV-EOuJ0su2l-jclLRCB9ZdZNUY54GFtde9E,12000
-tests/test_examples.py,sha256=dYiRgV3Z74MiOJq4I1soPE4xmJNSM8L-IqxdV4vXCWI,1615
-tests/test_mcp_proxy_adapter.py,sha256=WDYkLpz9Kd4OW0XbfhSanmhca7m7DIGZNC1L6CAoNpA,24890
-tests/test_mcp_proxy_adapter_basic.py,sha256=gKIcqYzZVEdJcp3PKKJPKNxtJ05l80Wj4ig1Vd2dagM,10624
-tests/test_part1.py,sha256=gb7lQ-lKjqYMMLGMt_7aSuScXSqy80tP8vBq2TBSiTs,14191
-tests/test_part2.py,sha256=842aTEHCwqS6UBs3sE0DRbXRdeiZ8n0w4rJTAWschnY,18220
-tests/test_schema.py,sha256=-X_323kncA0l3o1GKIKYf9OjhIj1hOJBPCH71682pk8,13704
-tests/test_simple_adapter.py,sha256=IFLbVphiRMl1w5LoT1AihYOt0b66GNnt8uDafwokVCI,8374
-mcp_proxy_adapter-2.1.1.dist-info/METADATA,sha256=Jo8aOojmaxOd3D2Op5_ogBCV7xqJ4SOFyE9WOnj2NHM,8150
-mcp_proxy_adapter-2.1.1.dist-info/WHEEL,sha256=wXxTzcEDnjrTwFYjLPcsW_7_XihufBwmpiBeiXNBGEA,91
-mcp_proxy_adapter-2.1.1.dist-info/top_level.txt,sha256=FkpPEr9rFZcEWxGfy6kRIUkCiLMxHpTD3--73ThTnPo,46
-mcp_proxy_adapter-2.1.1.dist-info/RECORD,,

mcp_proxy_adapter-2.1.1.dist-info/top_level.txt

@@ -1,5 +0,0 @@
-docs
-examples
-mcp_proxy_adapter
-scripts
-tests