mcp-proxy-adapter 6.0.0__tar.gz → 6.1.0__tar.gz

{mcp_proxy_adapter-6.0.0 → mcp_proxy_adapter-6.1.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023-2024 Vasiliy VZ
+Copyright (c) 2024 Vasiliy Zdanovskiy
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ 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. 
+SOFTWARE.

mcp_proxy_adapter-6.1.0/MANIFEST.in

@@ -0,0 +1,35 @@
+# Include README and license
+include README.md
+include LICENSE
+include requirements.txt
+include pyproject.toml
+include setup.py
+
+# Include package data
+recursive-include mcp_proxy_adapter/schemas *.json
+recursive-include mcp_proxy_adapter/examples *
+recursive-include mcp_proxy_adapter/docs *.md
+
+# Include test files
+recursive-include tests *.py
+recursive-include tests *.json
+recursive-include tests *.md
+
+# Include configuration examples
+include *.json
+include *.md
+
+# Exclude development files
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude *.pyd
+global-exclude __pycache__
+global-exclude .git*
+global-exclude .venv
+global-exclude venv
+global-exclude .pytest_cache
+global-exclude .coverage
+global-exclude htmlcov
+global-exclude dist
+global-exclude build
+global-exclude *.egg-info

mcp_proxy_adapter-6.1.0/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: mcp-proxy-adapter
+Version: 6.1.0
+Summary: Model Context Protocol Proxy Adapter with Security Framework
+Home-page: https://github.com/maverikod/mcp-proxy-adapter
+Author: Vasiliy Zdanovskiy
+Author-email: Vasiliy Zdanovskiy <vasilyvz@gmail.com>
+Maintainer-email: Vasiliy Zdanovskiy <vasilyvz@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/vasilyvz/mcp-proxy-adapter
+Project-URL: Documentation, https://mcp-proxy-adapter.readthedocs.io/
+Project-URL: Repository, https://github.com/vasilyvz/mcp-proxy-adapter.git
+Project-URL: Bug Tracker, https://github.com/vasilyvz/mcp-proxy-adapter/issues
+Project-URL: Security Policy, https://github.com/vasilyvz/mcp-proxy-adapter/security/policy
+Keywords: mcp,proxy,adapter,json-rpc,microservice,security,fastapi
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: Security
+Classifier: Framework :: FastAPI
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: uvicorn[standard]>=0.20.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: mcp-security-framework>=0.1.0
+Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: python-jose[cryptography]>=3.3.0
+Requires-Dist: passlib[bcrypt]>=1.7.4
+Requires-Dist: cryptography>=3.4.8
+Requires-Dist: pyOpenSSL>=23.0.0
+Requires-Dist: certifi>=2023.7.22
+Requires-Dist: requests>=2.31.0
+Requires-Dist: aiofiles>=23.1.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Requires-Dist: httpx>=0.24.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Requires-Dist: httpx>=0.24.0; extra == "test"
+Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.4.0; extra == "docs"
+Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.20.0; extra == "docs"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# MCP Proxy Adapter
+
+A powerful framework for creating JSON-RPC-enabled microservices with built-in security, authentication, and proxy registration capabilities.
+
+## Features
+
+- **JSON-RPC Framework**: Complete JSON-RPC 2.0 implementation
+- **Security Integration**: Built-in support for mcp_security_framework
+- **Authentication**: Multiple auth methods (API Key, JWT, Certificate, Basic Auth)
+- **Proxy Registration**: Automatic registration and discovery of services
+- **Command System**: Extensible command framework with role-based access control
+- **SSL/TLS Support**: Full SSL/TLS support including mTLS
+- **Async Support**: Built on FastAPI with full async support
+- **Extensible**: Plugin system for custom commands and middleware
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install mcp-proxy-adapter
+```
+
+### Basic Usage
+
+```python
+from mcp_proxy_adapter import create_app, Command, SuccessResult
+
+# Create a custom command
+class HelloCommand(Command):
+    name = "hello"
+    descr = "Say hello"
+    
+    async def execute(self, **kwargs) -> SuccessResult:
+        name = kwargs.get("name", "World")
+        return SuccessResult(f"Hello, {name}!")
+
+# Create and run the application
+app = create_app()
+```
+
+### Configuration
+
+```json
+{
+  "server": {
+    "host": "0.0.0.0",
+    "port": 8000
+  },
+  "security": {
+    "enabled": true,
+    "framework": "mcp_security_framework"
+  },
+  "commands": {
+    "auto_discovery": true,
+    "builtin_commands": ["echo", "health", "config"]
+  }
+}
+```
+
+## Examples
+
+### Proxy Registration Example
+
+```python
+# Example of proxy registration with authentication
+import asyncio
+from mcp_proxy_adapter.examples.proxy_registration_example import ProxyRegistrationExample
+
+async def main():
+    async with ProxyRegistrationExample("http://localhost:8002", "your-token") as client:
+        result = await client.test_registration({
+            "server_id": "my-server",
+            "server_url": "http://localhost:8001",
+            "server_name": "My Server"
+        })
+        print(f"Registration result: {result}")
+
+asyncio.run(main())
+```
+
+### Security Testing
+
+The framework includes comprehensive security testing examples:
+
+- HTTP with Token Authentication
+- HTTPS with Certificate Authentication  
+- mTLS (Mutual TLS) Authentication
+- Role-based Access Control
+- Permission Validation
+
+## Documentation
+
+For detailed documentation, examples, and API reference, see the [documentation](https://github.com/maverikod/mcp-proxy-adapter).
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/maverikod/mcp-proxy-adapter.git
+cd mcp-proxy-adapter
+python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+### Running Tests
+
+```bash
+pytest tests/
+```
+
+### Running Examples
+
+```bash
+# Start server
+python -m mcp_proxy_adapter.main --config examples/server_configs/config_simple.json
+
+# Run proxy registration example
+python examples/proxy_registration_example.py
+```
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Author
+
+**Vasiliy Zdanovskiy** - vasilyvz@gmail.com
+
+## Version
+
+6.1.0 - Major release with security framework integration and proxy registration capabilities. 

mcp_proxy_adapter-6.1.0/README.md

@@ -0,0 +1,134 @@
+# MCP Proxy Adapter
+
+A powerful framework for creating JSON-RPC-enabled microservices with built-in security, authentication, and proxy registration capabilities.
+
+## Features
+
+- **JSON-RPC Framework**: Complete JSON-RPC 2.0 implementation
+- **Security Integration**: Built-in support for mcp_security_framework
+- **Authentication**: Multiple auth methods (API Key, JWT, Certificate, Basic Auth)
+- **Proxy Registration**: Automatic registration and discovery of services
+- **Command System**: Extensible command framework with role-based access control
+- **SSL/TLS Support**: Full SSL/TLS support including mTLS
+- **Async Support**: Built on FastAPI with full async support
+- **Extensible**: Plugin system for custom commands and middleware
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install mcp-proxy-adapter
+```
+
+### Basic Usage
+
+```python
+from mcp_proxy_adapter import create_app, Command, SuccessResult
+
+# Create a custom command
+class HelloCommand(Command):
+    name = "hello"
+    descr = "Say hello"
+    
+    async def execute(self, **kwargs) -> SuccessResult:
+        name = kwargs.get("name", "World")
+        return SuccessResult(f"Hello, {name}!")
+
+# Create and run the application
+app = create_app()
+```
+
+### Configuration
+
+```json
+{
+  "server": {
+    "host": "0.0.0.0",
+    "port": 8000
+  },
+  "security": {
+    "enabled": true,
+    "framework": "mcp_security_framework"
+  },
+  "commands": {
+    "auto_discovery": true,
+    "builtin_commands": ["echo", "health", "config"]
+  }
+}
+```
+
+## Examples
+
+### Proxy Registration Example
+
+```python
+# Example of proxy registration with authentication
+import asyncio
+from mcp_proxy_adapter.examples.proxy_registration_example import ProxyRegistrationExample
+
+async def main():
+    async with ProxyRegistrationExample("http://localhost:8002", "your-token") as client:
+        result = await client.test_registration({
+            "server_id": "my-server",
+            "server_url": "http://localhost:8001",
+            "server_name": "My Server"
+        })
+        print(f"Registration result: {result}")
+
+asyncio.run(main())
+```
+
+### Security Testing
+
+The framework includes comprehensive security testing examples:
+
+- HTTP with Token Authentication
+- HTTPS with Certificate Authentication  
+- mTLS (Mutual TLS) Authentication
+- Role-based Access Control
+- Permission Validation
+
+## Documentation
+
+For detailed documentation, examples, and API reference, see the [documentation](https://github.com/maverikod/mcp-proxy-adapter).
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/maverikod/mcp-proxy-adapter.git
+cd mcp-proxy-adapter
+python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+### Running Tests
+
+```bash
+pytest tests/
+```
+
+### Running Examples
+
+```bash
+# Start server
+python -m mcp_proxy_adapter.main --config examples/server_configs/config_simple.json
+
+# Run proxy registration example
+python examples/proxy_registration_example.py
+```
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Author
+
+**Vasiliy Zdanovskiy** - vasilyvz@gmail.com
+
+## Version
+
+6.1.0 - Major release with security framework integration and proxy registration capabilities. 

mcp_proxy_adapter-6.1.0/TODO_SECURITY_INTEGRATION.md

@@ -0,0 +1,157 @@
+# TODO: Security Framework Integration
+
+**Author**: Vasiliy Zdanovskiy  
+**Email**: vasilyvz@gmail.com  
+**Date**: 2025-08-30
+
+## ✅ Выполненные задачи
+
+### 1. Анализ конфигурации фреймворка
+- [x] Проанализирована структура `mcp_security_framework/schemas/config.py`
+- [x] Изучены все схемы: `SecurityConfig`, `AuthConfig`, `SSLConfig`, `PermissionConfig`, `RateLimitConfig`, `CertificateConfig`, `LoggingConfig`
+- [x] Понята структура конфигурации фреймворка
+
+### 2. Создание утилиты генерации конфигов
+- [x] Создан `mcp_proxy_adapter/utils/config_generator.py`
+- [x] Реализована генерация 4 типов конфигов: minimal, development, secure, full
+- [x] Добавлены комментарии и документация
+- [x] Протестирована генерация конфигов
+
+### 3. Прямая интеграция с фреймворком
+- [x] Создан `mcp_proxy_adapter/core/security_integration.py`
+- [x] Реализованы прямые вызовы методов фреймворка:
+  - `SecurityManager` - валидация запросов
+  - `AuthManager` - аутентификация (API key, JWT, certificate)
+  - `CertificateManager` - управление сертификатами
+  - `PermissionManager` - управление ролями и правами
+  - `RateLimiter` - ограничение скорости
+- [x] Заменен `UnifiedSecurityMiddleware` на прямое использование `FastAPISecurityMiddleware`
+
+### 4. Новая команда безопасности
+- [x] Создан `mcp_proxy_adapter/commands/security_command.py`
+- [x] Реализованы все операции безопасности через фреймворк
+- [x] Поддержка аутентификации, управления сертификатами, ролями, rate limiting
+
+### 5. Клиентская интеграция с фреймворком
+- [x] Создан `mcp_proxy_adapter/core/client_security.py`
+- [x] Реализованы клиентские методы безопасности:
+  - Создание SSL контекстов для клиентских подключений
+  - Генерация API ключей и JWT токенов
+  - Валидация серверных сертификатов
+  - Извлечение ролей из сертификатов
+  - Создание заголовков аутентификации
+- [x] Интеграция с утилитами фреймворка
+
+### 6. Конфигурация регистрации прокси
+- [x] Добавлена секция `registration` в конфигурацию
+- [x] Поддержка различных методов аутентификации:
+  - Сертификаты (cert_file, key_file, ca_cert_file)
+  - Токены (token, token_type, refresh_interval)
+  - API ключи (key, key_header)
+- [x] Настройки heartbeat и auto_discovery
+- [x] Информация о прокси (capabilities, endpoints)
+
+### 7. Обновление модуля регистрации прокси
+- [x] Обновлен `mcp_proxy_adapter/core/proxy_registration.py`
+- [x] Интеграция с `ClientSecurityManager`
+- [x] Безопасные подключения с SSL/TLS
+- [x] Аутентификация через фреймворк безопасности
+- [x] Heartbeat с безопасными запросами
+- [x] Валидация ответов сервера
+
+## 🔄 Текущие задачи
+
+### 8. Интеграция в основное приложение
+- [ ] Обновить `mcp_proxy_adapter/api/app.py` для инициализации регистрации
+- [ ] Добавить инициализацию `ClientSecurityManager` в startup
+- [ ] Интегрировать безопасную регистрацию в lifecycle приложения
+
+### 9. Обновление команд
+- [ ] Обновить `mcp_proxy_adapter/commands/proxy_registration_command.py`
+- [ ] Добавить команды для управления безопасной регистрацией
+- [ ] Интегрировать с новой командой безопасности
+
+### 10. Тестирование и документация
+- [ ] Создать тесты для клиентской безопасности
+- [ ] Протестировать безопасную регистрацию
+- [ ] Обновить документацию
+- [ ] Создать примеры использования
+
+## 📋 План действий
+
+### Этап 1: Интеграция в приложение (1 день)
+1. Обновить `api/app.py` для инициализации компонентов безопасности
+2. Добавить безопасную регистрацию в startup/shutdown
+3. Интегрировать с middleware
+
+### Этап 2: Обновление команд (0.5 дня)
+1. Обновить команду регистрации прокси
+2. Добавить новые команды безопасности
+3. Протестировать команды
+
+### Этап 3: Тестирование (0.5 дня)
+1. Создать тесты для клиентской безопасности
+2. Протестировать безопасную регистрацию
+3. Проверить все сценарии
+
+## 🎯 Критические моменты
+
+### Архитектура безопасности
+```
+mcp_proxy_adapter
+├── core/
+│   ├── security_integration.py      ✅ Готово
+│   ├── client_security.py           ✅ Готово
+│   ├── proxy_registration.py        ✅ Готово
+│   └── proxy_manager.py             🔄 Нужно обновить
+├── commands/
+│   ├── security_command.py          ✅ Готово
+│   └── proxy_registration_command.py 🔄 Нужно обновить
+├── api/
+│   ├── app.py                       🔄 Нужно обновить
+│   └── middleware/
+│       └── unified_security.py      ✅ Готово
+└── utils/
+    └── config_generator.py          ✅ Готово
+```
+
+### Конфигурация регистрации
+```json
+{
+  "registration": {
+    "enabled": true,
+    "server_url": "https://proxy-registry.example.com",
+    "auth_method": "certificate",
+    "certificate": {
+      "enabled": true,
+      "cert_file": "./certs/proxy_client.crt",
+      "key_file": "./keys/proxy_client.key",
+      "ca_cert_file": "./certs/ca.crt"
+    },
+    "heartbeat": {
+      "enabled": true,
+      "interval": 300
+    }
+  }
+}
+```
+
+## 📝 Заметки
+
+### Выполненные интеграции
+- ✅ Прямое использование `SecurityManager`, `AuthManager`, `CertificateManager`
+- ✅ Клиентская безопасность с SSL/TLS и аутентификацией
+- ✅ Безопасная регистрация прокси с heartbeat
+- ✅ Конфигурация с поддержкой сертификатов, токенов, API ключей
+
+### Следующие шаги
+1. Интегрировать в основное приложение
+2. Обновить команды
+3. Протестировать полную интеграцию
+4. Обновить документацию
+
+### Результаты
+- **Удалено дублирование**: Все методы безопасности теперь используют фреймворк
+- **Добавлена безопасность**: Клиентские подключения защищены SSL/TLS
+- **Улучшена конфигурация**: Единая конфигурация для проекта и фреймворка
+- **Готова регистрация**: Безопасная регистрация прокси с аутентификацией