mcp-proxy-adapter 1.0.0__tar.gz

mcp_proxy_adapter-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023-2024 Vasiliy VZ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

mcp_proxy_adapter-1.0.0/MANIFEST.in

@@ -0,0 +1,12 @@
+include README.md
+include LICENSE
+include requirements.txt
+include pyproject.toml
+include code_index.yaml
+recursive-include docs *.md
+recursive-include examples *.py *.json
+recursive-include tests *.py
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *.so
+global-exclude .DS_Store 

mcp_proxy_adapter-1.0.0/PKG-INFO

@@ -0,0 +1,262 @@
+Metadata-Version: 2.4
+Name: mcp-proxy-adapter
+Version: 1.0.0
+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
+Author-email: Vasiliy VZ <vasilyvz@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/vasilyvz/mcp-proxy-adapter
+Project-URL: Bug Tracker, https://github.com/vasilyvz/mcp-proxy-adapter/issues
+Project-URL: Documentation, https://github.com/vasilyvz/mcp-proxy-adapter/tree/main/docs
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9, <4
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi<1.0.0,>=0.95.0
+Requires-Dist: pydantic<2.0.0,>=1.10.0
+Requires-Dist: uvicorn<1.0.0,>=0.22.0
+Requires-Dist: docstring-parser<1.0.0,>=0.15
+Requires-Dist: typing-extensions<5.0.0,>=4.5.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# MCP Proxy Adapter
+
+Adapter for integrating [Command Registry](docs/README.md) with MCP Proxy, allowing you to use commands as tools for AI models.
+
+## Overview
+
+MCP Proxy Adapter transforms commands registered in the Command Registry into a format compatible with MCP Proxy. This enables:
+
+1. Using existing commands as tools for AI models
+2. Creating a hybrid REST/JSON-RPC API for command execution
+3. Automatic generation of OpenAPI schemas optimized for MCP Proxy
+4. Managing tool metadata for better AI system integration
+
+## Installation
+
+```bash
+pip install mcp-proxy-adapter
+```
+
+## Quick Start
+
+```python
+from mcp_proxy_adapter import MCPProxyAdapter, CommandRegistry
+from fastapi import FastAPI
+
+# Create a command registry instance
+registry = CommandRegistry()
+
+# Register commands
+@registry.command
+def calculate_total(prices: list[float], discount: float = 0.0) -> float:
+    """
+    Calculates the total price with discount.
+    Args:
+        prices: List of item prices
+        discount: Discount percentage (0-100)
+    Returns:
+        Total price with discount
+    """
+    subtotal = sum(prices)
+    return subtotal * (1 - discount / 100)
+
+# Create FastAPI app
+app = FastAPI()
+
+# Create and configure MCP Proxy adapter
+adapter = MCPProxyAdapter(registry)
+
+# Register endpoints in FastAPI app
+adapter.register_endpoints(app)
+
+# Generate and save MCP Proxy config
+adapter.save_config_to_file("mcp_proxy_config.json")
+```
+
+## Supported Request Formats
+
+The adapter supports three request formats for command execution:
+
+### 1. JSON-RPC format
+
+```json
+{
+  "jsonrpc": "2.0",
+  "method": "command_name",
+  "params": {
+    "param1": "value1",
+    "param2": "value2"
+  },
+  "id": 1
+}
+```
+
+Example request to `/cmd` endpoint:
+
+```bash
+curl -X POST -H "Content-Type: application/json" -d '{
+  "jsonrpc": "2.0",
+  "method": "calculate_total",
+  "params": {
+    "prices": [100, 200, 300],
+    "discount": 10
+  },
+  "id": 1
+}' http://localhost:8000/cmd
+```
+
+Response:
+
+```json
+{
+  "jsonrpc": "2.0",
+  "result": 540.0,
+  "id": 1
+}
+```
+
+### 2. MCP Proxy format
+
+```json
+{
+  "command": "command_name",
+  "params": {
+    "param1": "value1",
+    "param2": "value2"
+  }
+}
+```
+
+Example request:
+
+```bash
+curl -X POST -H "Content-Type: application/json" -d '{
+  "command": "calculate_total",
+  "params": {
+    "prices": [100, 200, 300],
+    "discount": 10
+  }
+}' http://localhost:8000/cmd
+```
+
+Response:
+
+```json
+{
+  "result": 540.0
+}
+```
+
+### 3. Params-only format
+
+```json
+{
+  "params": {
+    "command": "command_name",
+    "param1": "value1",
+    "param2": "value2"
+  }
+}
+```
+
+or
+
+```json
+{
+  "params": {
+    "query": "command_name",
+    "param1": "value1",
+    "param2": "value2"
+  }
+}
+```
+
+Example request:
+
+```bash
+curl -X POST -H "Content-Type: application/json" -d '{
+  "params": {
+    "command": "calculate_total",
+    "prices": [100, 200, 300],
+    "discount": 10
+  }
+}' http://localhost:8000/cmd
+```
+
+Response:
+
+```json
+{
+  "result": 540.0
+}
+```
+
+## Full Example: Integration with FastAPI
+
+```python
+import logging
+from fastapi import FastAPI, APIRouter
+from mcp_proxy_adapter import CommandRegistry, MCPProxyAdapter, configure_logger
+
+# Configure logging
+logging.basicConfig(level=logging.INFO)
+project_logger = logging.getLogger("my_project")
+
+# Create FastAPI app
+app = FastAPI(title="My API with MCP Proxy Integration")
+
+# Create existing API router
+router = APIRouter()
+
+@router.get("/items")
+async def get_items():
+    """Returns a list of items."""
+    return [
+        {"id": 1, "name": "Smartphone X", "price": 999.99},
+        {"id": 2, "name": "Laptop Y", "price": 1499.99},
+    ]
+
+app.include_router(router)
+
+# Register commands
+registry = CommandRegistry()
+
+@registry.command
+def get_discounted_price(price: float, discount: float = 0.0) -> float:
+    """
+    Returns the price after applying a discount.
+    """
+    return price * (1 - discount / 100)
+
+# Create and register MCP Proxy adapter
+adapter = MCPProxyAdapter(registry)
+adapter.register_endpoints(app)
+
+# Save MCP Proxy config
+adapter.save_config_to_file("mcp_proxy_config.json")
+```
+
+## Features
+- Universal JSON-RPC endpoint for command execution
+- Automatic OpenAPI schema generation and optimization for MCP Proxy
+- Tool metadata for AI models
+- Customizable endpoints and logging
+- Full test coverage and examples
+
+## License
+MIT
+
+## Documentation
+See [docs/](docs/) for detailed guides, architecture, and examples. 

mcp_proxy_adapter-1.0.0/README.md

@@ -0,0 +1,230 @@
+# MCP Proxy Adapter
+
+Adapter for integrating [Command Registry](docs/README.md) with MCP Proxy, allowing you to use commands as tools for AI models.
+
+## Overview
+
+MCP Proxy Adapter transforms commands registered in the Command Registry into a format compatible with MCP Proxy. This enables:
+
+1. Using existing commands as tools for AI models
+2. Creating a hybrid REST/JSON-RPC API for command execution
+3. Automatic generation of OpenAPI schemas optimized for MCP Proxy
+4. Managing tool metadata for better AI system integration
+
+## Installation
+
+```bash
+pip install mcp-proxy-adapter
+```
+
+## Quick Start
+
+```python
+from mcp_proxy_adapter import MCPProxyAdapter, CommandRegistry
+from fastapi import FastAPI
+
+# Create a command registry instance
+registry = CommandRegistry()
+
+# Register commands
+@registry.command
+def calculate_total(prices: list[float], discount: float = 0.0) -> float:
+    """
+    Calculates the total price with discount.
+    Args:
+        prices: List of item prices
+        discount: Discount percentage (0-100)
+    Returns:
+        Total price with discount
+    """
+    subtotal = sum(prices)
+    return subtotal * (1 - discount / 100)
+
+# Create FastAPI app
+app = FastAPI()
+
+# Create and configure MCP Proxy adapter
+adapter = MCPProxyAdapter(registry)
+
+# Register endpoints in FastAPI app
+adapter.register_endpoints(app)
+
+# Generate and save MCP Proxy config
+adapter.save_config_to_file("mcp_proxy_config.json")
+```
+
+## Supported Request Formats
+
+The adapter supports three request formats for command execution:
+
+### 1. JSON-RPC format
+
+```json
+{
+  "jsonrpc": "2.0",
+  "method": "command_name",
+  "params": {
+    "param1": "value1",
+    "param2": "value2"
+  },
+  "id": 1
+}
+```
+
+Example request to `/cmd` endpoint:
+
+```bash
+curl -X POST -H "Content-Type: application/json" -d '{
+  "jsonrpc": "2.0",
+  "method": "calculate_total",
+  "params": {
+    "prices": [100, 200, 300],
+    "discount": 10
+  },
+  "id": 1
+}' http://localhost:8000/cmd
+```
+
+Response:
+
+```json
+{
+  "jsonrpc": "2.0",
+  "result": 540.0,
+  "id": 1
+}
+```
+
+### 2. MCP Proxy format
+
+```json
+{
+  "command": "command_name",
+  "params": {
+    "param1": "value1",
+    "param2": "value2"
+  }
+}
+```
+
+Example request:
+
+```bash
+curl -X POST -H "Content-Type: application/json" -d '{
+  "command": "calculate_total",
+  "params": {
+    "prices": [100, 200, 300],
+    "discount": 10
+  }
+}' http://localhost:8000/cmd
+```
+
+Response:
+
+```json
+{
+  "result": 540.0
+}
+```
+
+### 3. Params-only format
+
+```json
+{
+  "params": {
+    "command": "command_name",
+    "param1": "value1",
+    "param2": "value2"
+  }
+}
+```
+
+or
+
+```json
+{
+  "params": {
+    "query": "command_name",
+    "param1": "value1",
+    "param2": "value2"
+  }
+}
+```
+
+Example request:
+
+```bash
+curl -X POST -H "Content-Type: application/json" -d '{
+  "params": {
+    "command": "calculate_total",
+    "prices": [100, 200, 300],
+    "discount": 10
+  }
+}' http://localhost:8000/cmd
+```
+
+Response:
+
+```json
+{
+  "result": 540.0
+}
+```
+
+## Full Example: Integration with FastAPI
+
+```python
+import logging
+from fastapi import FastAPI, APIRouter
+from mcp_proxy_adapter import CommandRegistry, MCPProxyAdapter, configure_logger
+
+# Configure logging
+logging.basicConfig(level=logging.INFO)
+project_logger = logging.getLogger("my_project")
+
+# Create FastAPI app
+app = FastAPI(title="My API with MCP Proxy Integration")
+
+# Create existing API router
+router = APIRouter()
+
+@router.get("/items")
+async def get_items():
+    """Returns a list of items."""
+    return [
+        {"id": 1, "name": "Smartphone X", "price": 999.99},
+        {"id": 2, "name": "Laptop Y", "price": 1499.99},
+    ]
+
+app.include_router(router)
+
+# Register commands
+registry = CommandRegistry()
+
+@registry.command
+def get_discounted_price(price: float, discount: float = 0.0) -> float:
+    """
+    Returns the price after applying a discount.
+    """
+    return price * (1 - discount / 100)
+
+# Create and register MCP Proxy adapter
+adapter = MCPProxyAdapter(registry)
+adapter.register_endpoints(app)
+
+# Save MCP Proxy config
+adapter.save_config_to_file("mcp_proxy_config.json")
+```
+
+## Features
+- Universal JSON-RPC endpoint for command execution
+- Automatic OpenAPI schema generation and optimization for MCP Proxy
+- Tool metadata for AI models
+- Customizable endpoints and logging
+- Full test coverage and examples
+
+## License
+MIT
+
+## Documentation
+See [docs/](docs/) for detailed guides, architecture, and examples.