mcp-proxy-adapter-dev 8.11.16__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- mcp_proxy_adapter/__init__.py +73 -0
- mcp_proxy_adapter/__main__.py +13 -0
- mcp_proxy_adapter/api/__init__.py +38 -0
- mcp_proxy_adapter/api/app.py +64 -0
- mcp_proxy_adapter/api/command_session_service.py +455 -0
- mcp_proxy_adapter/api/core/__init__.py +19 -0
- mcp_proxy_adapter/api/core/app_factory.py +215 -0
- mcp_proxy_adapter/api/core/app_factory_certificates.py +159 -0
- mcp_proxy_adapter/api/core/app_factory_config.py +75 -0
- mcp_proxy_adapter/api/core/app_factory_routes.py +345 -0
- mcp_proxy_adapter/api/core/app_factory_validators.py +165 -0
- mcp_proxy_adapter/api/core/lifespan_manager/__init__.py +52 -0
- mcp_proxy_adapter/api/core/lifespan_manager/manager.py +354 -0
- mcp_proxy_adapter/api/core/lifespan_manager/queue_config.py +37 -0
- mcp_proxy_adapter/api/core/lifespan_manager/signal_registration.py +74 -0
- mcp_proxy_adapter/api/core/registration/__init__.py +24 -0
- mcp_proxy_adapter/api/core/registration/config_parsers.py +247 -0
- mcp_proxy_adapter/api/core/registration/context_builder.py +130 -0
- mcp_proxy_adapter/api/core/registration/helpers.py +36 -0
- mcp_proxy_adapter/api/core/registration/metadata_builders.py +117 -0
- mcp_proxy_adapter/api/core/registration/models.py +42 -0
- mcp_proxy_adapter/api/core/registration/resolvers.py +195 -0
- mcp_proxy_adapter/api/core/registration/url_builders.py +122 -0
- mcp_proxy_adapter/api/core/registration_context.py +30 -0
- mcp_proxy_adapter/api/core/registration_manager/__init__.py +31 -0
- mcp_proxy_adapter/api/core/registration_manager/helpers.py +307 -0
- mcp_proxy_adapter/api/core/registration_manager/manager.py +584 -0
- mcp_proxy_adapter/api/core/registration_manager/status.py +152 -0
- mcp_proxy_adapter/api/core/registration_tasks.py +387 -0
- mcp_proxy_adapter/api/core/ssl_context_factory.py +99 -0
- mcp_proxy_adapter/api/execute_async_contract.py +124 -0
- mcp_proxy_adapter/api/handlers/__init__.py +335 -0
- mcp_proxy_adapter/api/handlers/command_execution.py +709 -0
- mcp_proxy_adapter/api/handlers/health.py +157 -0
- mcp_proxy_adapter/api/handlers/jsonrpc.py +207 -0
- mcp_proxy_adapter/api/handlers/transfer_notify.py +313 -0
- mcp_proxy_adapter/api/handlers/transfer_sessions.py +287 -0
- mcp_proxy_adapter/api/handlers_async.py +233 -0
- mcp_proxy_adapter/api/health_provider.py +44 -0
- mcp_proxy_adapter/api/jsonrpc_job_lifecycle.py +165 -0
- mcp_proxy_adapter/api/jsonrpc_job_status.py +94 -0
- mcp_proxy_adapter/api/middleware/__init__.py +14 -0
- mcp_proxy_adapter/api/middleware/command_permission_middleware.py +73 -0
- mcp_proxy_adapter/api/middleware/request_logging.py +153 -0
- mcp_proxy_adapter/api/middleware/unified_security.py +367 -0
- mcp_proxy_adapter/api/openapi/__init__.py +18 -0
- mcp_proxy_adapter/api/openapi/command_integration.py +107 -0
- mcp_proxy_adapter/api/openapi/openapi_generator.py +138 -0
- mcp_proxy_adapter/api/openapi/openapi_registry.py +55 -0
- mcp_proxy_adapter/api/public_downloads.py +68 -0
- mcp_proxy_adapter/api/schemas.py +290 -0
- mcp_proxy_adapter/api/tool_integration.py +124 -0
- mcp_proxy_adapter/api/tools.py +244 -0
- mcp_proxy_adapter/api/transfer_session_service.py +329 -0
- mcp_proxy_adapter/api/ws_endpoint.py +653 -0
- mcp_proxy_adapter/api/ws_identity.py +111 -0
- mcp_proxy_adapter/cli/__init__.py +12 -0
- mcp_proxy_adapter/cli/commands/__init__.py +14 -0
- mcp_proxy_adapter/cli/commands/client.py +137 -0
- mcp_proxy_adapter/cli/commands/config_docs/__init__.py +23 -0
- mcp_proxy_adapter/cli/commands/config_docs/cli.py +63 -0
- mcp_proxy_adapter/cli/commands/config_docs/declared_settings.py +45 -0
- mcp_proxy_adapter/cli/commands/config_docs/render.py +58 -0
- mcp_proxy_adapter/cli/commands/config_docs/sections/__init__.py +61 -0
- mcp_proxy_adapter/cli/commands/config_docs/sections/_chunk.py +19 -0
- mcp_proxy_adapter/cli/commands/config_docs/sections/authentication.py +127 -0
- mcp_proxy_adapter/cli/commands/config_docs/sections/best_practices.py +166 -0
- mcp_proxy_adapter/cli/commands/config_docs/sections/common_patterns.py +154 -0
- mcp_proxy_adapter/cli/commands/config_docs/sections/overview.py +135 -0
- mcp_proxy_adapter/cli/commands/config_docs/sections/queue_manager.py +140 -0
- mcp_proxy_adapter/cli/commands/config_docs/sections/registration.py +212 -0
- mcp_proxy_adapter/cli/commands/config_docs/sections/server.py +193 -0
- mcp_proxy_adapter/cli/commands/config_docs/sections/troubleshooting.py +215 -0
- mcp_proxy_adapter/cli/commands/config_generate.py +95 -0
- mcp_proxy_adapter/cli/commands/config_generate_parts/__init__.py +1 -0
- mcp_proxy_adapter/cli/commands/config_generate_parts/arguments.py +44 -0
- mcp_proxy_adapter/cli/commands/config_generate_parts/arguments_core.py +141 -0
- mcp_proxy_adapter/cli/commands/config_generate_parts/arguments_queue.py +140 -0
- mcp_proxy_adapter/cli/commands/config_generate_parts/arguments_validation.py +142 -0
- mcp_proxy_adapter/cli/commands/config_generate_parts/generation.py +365 -0
- mcp_proxy_adapter/cli/commands/config_generate_parts/parsing.py +122 -0
- mcp_proxy_adapter/cli/commands/config_validate.py +154 -0
- mcp_proxy_adapter/cli/commands/info.py +297 -0
- mcp_proxy_adapter/cli/commands/server.py +361 -0
- mcp_proxy_adapter/cli/commands/sets.py +165 -0
- mcp_proxy_adapter/cli/commands/standalone_entry.py +25 -0
- mcp_proxy_adapter/cli/commands/testconfig.py +205 -0
- mcp_proxy_adapter/cli/examples/__init__.py +9 -0
- mcp_proxy_adapter/cli/main.py +75 -0
- mcp_proxy_adapter/cli/parser.py +244 -0
- mcp_proxy_adapter/cli/validators.py +389 -0
- mcp_proxy_adapter/client/jsonrpc_client/__init__.py +139 -0
- mcp_proxy_adapter/client/jsonrpc_client/client.py +257 -0
- mcp_proxy_adapter/client/jsonrpc_client/command_api.py +369 -0
- mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/__init__.py +1 -0
- mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/async_base.py +241 -0
- mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/basic_base.py +150 -0
- mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/catalog_base.py +178 -0
- mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/constants.py +38 -0
- mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/helpers.py +66 -0
- mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/queue_base.py +137 -0
- mcp_proxy_adapter/client/jsonrpc_client/exceptions/__init__.py +70 -0
- mcp_proxy_adapter/client/jsonrpc_client/exceptions/base.py +102 -0
- mcp_proxy_adapter/client/jsonrpc_client/exceptions/classification.py +143 -0
- mcp_proxy_adapter/client/jsonrpc_client/exceptions/request_errors.py +169 -0
- mcp_proxy_adapter/client/jsonrpc_client/exceptions/schema_errors.py +90 -0
- mcp_proxy_adapter/client/jsonrpc_client/exceptions/transfer_errors.py +48 -0
- mcp_proxy_adapter/client/jsonrpc_client/exceptions/transport_errors.py +153 -0
- mcp_proxy_adapter/client/jsonrpc_client/execution_status_observer.py +66 -0
- mcp_proxy_adapter/client/jsonrpc_client/job_event_registry.py +322 -0
- mcp_proxy_adapter/client/jsonrpc_client/job_tracking_mixin.py +206 -0
- mcp_proxy_adapter/client/jsonrpc_client/job_tracking_types.py +135 -0
- mcp_proxy_adapter/client/jsonrpc_client/openapi_validator.py +127 -0
- mcp_proxy_adapter/client/jsonrpc_client/operation_state.py +221 -0
- mcp_proxy_adapter/client/jsonrpc_client/proxy_api.py +93 -0
- mcp_proxy_adapter/client/jsonrpc_client/proxy_api_bases/__init__.py +1 -0
- mcp_proxy_adapter/client/jsonrpc_client/proxy_api_bases/client_base.py +117 -0
- mcp_proxy_adapter/client/jsonrpc_client/proxy_api_bases/lifecycle_base.py +222 -0
- mcp_proxy_adapter/client/jsonrpc_client/proxy_api_bases/register_base.py +230 -0
- mcp_proxy_adapter/client/jsonrpc_client/proxy_api_bases/uuid_base.py +95 -0
- mcp_proxy_adapter/client/jsonrpc_client/queue_api.py +302 -0
- mcp_proxy_adapter/client/jsonrpc_client/queue_status.py +192 -0
- mcp_proxy_adapter/client/jsonrpc_client/schema_generator.py +143 -0
- mcp_proxy_adapter/client/jsonrpc_client/schema_generator_bases/__init__.py +1 -0
- mcp_proxy_adapter/client/jsonrpc_client/schema_generator_bases/models.py +45 -0
- mcp_proxy_adapter/client/jsonrpc_client/schema_generator_bases/parse_base.py +215 -0
- mcp_proxy_adapter/client/jsonrpc_client/schema_generator_bases/validate_base.py +181 -0
- mcp_proxy_adapter/client/jsonrpc_client/transfer_integrity.py +57 -0
- mcp_proxy_adapter/client/jsonrpc_client/transport/__init__.py +161 -0
- mcp_proxy_adapter/client/jsonrpc_client/transport/constants.py +30 -0
- mcp_proxy_adapter/client/jsonrpc_client/transport/helpers.py +118 -0
- mcp_proxy_adapter/client/jsonrpc_client/transport/http_base.py +325 -0
- mcp_proxy_adapter/client/jsonrpc_client/transport/rpc_base.py +311 -0
- mcp_proxy_adapter/client/jsonrpc_client/transport/tls_base.py +295 -0
- mcp_proxy_adapter/client/jsonrpc_client/transport/transfer_base.py +282 -0
- mcp_proxy_adapter/client/jsonrpc_client/ws_command_session.py +230 -0
- mcp_proxy_adapter/client/jsonrpc_client/ws_command_session_bases/__init__.py +1 -0
- mcp_proxy_adapter/client/jsonrpc_client/ws_command_session_bases/core_base.py +154 -0
- mcp_proxy_adapter/client/jsonrpc_client/ws_command_session_bases/helpers.py +72 -0
- mcp_proxy_adapter/client/jsonrpc_client/ws_command_session_bases/wait_base.py +279 -0
- mcp_proxy_adapter/client/jsonrpc_client/ws_job_status.py +337 -0
- mcp_proxy_adapter/client/jsonrpc_client/ws_job_status_parts/__init__.py +1 -0
- mcp_proxy_adapter/client/jsonrpc_client/ws_job_status_parts/channel.py +159 -0
- mcp_proxy_adapter/client/jsonrpc_client/ws_job_status_parts/command_channel.py +154 -0
- mcp_proxy_adapter/client/jsonrpc_client/ws_job_status_parts/helpers.py +76 -0
- mcp_proxy_adapter/client/proxy.py +124 -0
- mcp_proxy_adapter/commands/__init__.py +27 -0
- mcp_proxy_adapter/commands/base.py +998 -0
- mcp_proxy_adapter/commands/builtin_commands.py +186 -0
- mcp_proxy_adapter/commands/command_help_info.py +101 -0
- mcp_proxy_adapter/commands/command_registry/__init__.py +55 -0
- mcp_proxy_adapter/commands/command_registry/builtins_part.py +206 -0
- mcp_proxy_adapter/commands/command_registry/facade.py +310 -0
- mcp_proxy_adapter/commands/command_registry/lifecycle_part.py +232 -0
- mcp_proxy_adapter/commands/command_registry/loader.py +145 -0
- mcp_proxy_adapter/commands/command_registry/mutations_part.py +228 -0
- mcp_proxy_adapter/commands/command_registry/part_base.py +59 -0
- mcp_proxy_adapter/commands/command_registry/queries_part.py +304 -0
- mcp_proxy_adapter/commands/config_command.py +208 -0
- mcp_proxy_adapter/commands/dependency_container.py +35 -0
- mcp_proxy_adapter/commands/echo_command.py +97 -0
- mcp_proxy_adapter/commands/health_command.py +162 -0
- mcp_proxy_adapter/commands/help_command.py +296 -0
- mcp_proxy_adapter/commands/hooks.py +590 -0
- mcp_proxy_adapter/commands/job_metadata.py +26 -0
- mcp_proxy_adapter/commands/load_command.py +134 -0
- mcp_proxy_adapter/commands/nested_validation.py +185 -0
- mcp_proxy_adapter/commands/plugins_command.py +250 -0
- mcp_proxy_adapter/commands/proxy_registration_command.py +475 -0
- mcp_proxy_adapter/commands/queue/__init__.py +83 -0
- mcp_proxy_adapter/commands/queue/add_job_command.py +358 -0
- mcp_proxy_adapter/commands/queue/command_execution_diagnostics.py +100 -0
- mcp_proxy_adapter/commands/queue/delete_job_command.py +92 -0
- mcp_proxy_adapter/commands/queue/get_logs_command.py +90 -0
- mcp_proxy_adapter/commands/queue/get_status_command.py +105 -0
- mcp_proxy_adapter/commands/queue/health_command.py +44 -0
- mcp_proxy_adapter/commands/queue/job_domain_errors.py +117 -0
- mcp_proxy_adapter/commands/queue/job_params.py +163 -0
- mcp_proxy_adapter/commands/queue/jobs/__init__.py +41 -0
- mcp_proxy_adapter/commands/queue/jobs/basic_jobs.py +205 -0
- mcp_proxy_adapter/commands/queue/jobs/command_execution_job.py +198 -0
- mcp_proxy_adapter/commands/queue/jobs/command_restore_base.py +48 -0
- mcp_proxy_adapter/commands/queue/jobs/command_run_base.py +389 -0
- mcp_proxy_adapter/commands/queue/jobs/job_helpers.py +80 -0
- mcp_proxy_adapter/commands/queue/jobs/long_jobs.py +257 -0
- mcp_proxy_adapter/commands/queue/list_jobs_command.py +127 -0
- mcp_proxy_adapter/commands/queue/start_job_command.py +97 -0
- mcp_proxy_adapter/commands/queue/stop_job_command.py +107 -0
- mcp_proxy_adapter/commands/queue_commands.py +49 -0
- mcp_proxy_adapter/commands/registration_status_command.py +83 -0
- mcp_proxy_adapter/commands/reload_command.py +183 -0
- mcp_proxy_adapter/commands/result.py +201 -0
- mcp_proxy_adapter/commands/result_helpers.py +43 -0
- mcp_proxy_adapter/commands/role_test_command.py +119 -0
- mcp_proxy_adapter/commands/roles_management_command/__init__.py +58 -0
- mcp_proxy_adapter/commands/roles_management_command/actions_part.py +400 -0
- mcp_proxy_adapter/commands/roles_management_command/dispatch_part.py +239 -0
- mcp_proxy_adapter/commands/roles_management_command/facade.py +233 -0
- mcp_proxy_adapter/commands/roles_management_command/part_base.py +61 -0
- mcp_proxy_adapter/commands/roles_management_command/results.py +105 -0
- mcp_proxy_adapter/commands/roles_management_command/storage_part.py +181 -0
- mcp_proxy_adapter/commands/schema_helpers.py +45 -0
- mcp_proxy_adapter/commands/settings_command.py +205 -0
- mcp_proxy_adapter/commands/transfer_command_support.py +83 -0
- mcp_proxy_adapter/commands/transfer_download_begin_command.py +245 -0
- mcp_proxy_adapter/commands/transfer_download_status_command.py +121 -0
- mcp_proxy_adapter/commands/transfer_schema_support.py +96 -0
- mcp_proxy_adapter/commands/transfer_upload_begin_command.py +254 -0
- mcp_proxy_adapter/commands/transfer_upload_complete_command.py +161 -0
- mcp_proxy_adapter/commands/transfer_upload_status_command.py +122 -0
- mcp_proxy_adapter/commands/transport_management_command.py +144 -0
- mcp_proxy_adapter/commands/unload_command.py +109 -0
- mcp_proxy_adapter/config.py +30 -0
- mcp_proxy_adapter/core/__init__.py +8 -0
- mcp_proxy_adapter/core/app_factory/__init__.py +17 -0
- mcp_proxy_adapter/core/app_factory/app_creator.py +66 -0
- mcp_proxy_adapter/core/app_factory/config_loader.py +125 -0
- mcp_proxy_adapter/core/app_factory/factory.py +158 -0
- mcp_proxy_adapter/core/app_factory/server_runner.py +152 -0
- mcp_proxy_adapter/core/app_factory/ssl_config.py +194 -0
- mcp_proxy_adapter/core/app_factory/validators.py +57 -0
- mcp_proxy_adapter/core/async_context.py +28 -0
- mcp_proxy_adapter/core/auth/__init__.py +18 -0
- mcp_proxy_adapter/core/auth/certificate_validator.py +239 -0
- mcp_proxy_adapter/core/auth/models.py +47 -0
- mcp_proxy_adapter/core/auth/mtls_validator.py +84 -0
- mcp_proxy_adapter/core/auth/token_validator.py +114 -0
- mcp_proxy_adapter/core/auth_validator.py +137 -0
- mcp_proxy_adapter/core/certificate/__init__.py +20 -0
- mcp_proxy_adapter/core/certificate/certificate_validator/__init__.py +55 -0
- mcp_proxy_adapter/core/certificate/certificate_validator/facade.py +340 -0
- mcp_proxy_adapter/core/certificate/certificate_validator/info_part.py +130 -0
- mcp_proxy_adapter/core/certificate/certificate_validator/key_part.py +146 -0
- mcp_proxy_adapter/core/certificate/certificate_validator/part_base.py +65 -0
- mcp_proxy_adapter/core/certificate/certificate_validator/revocation_part.py +112 -0
- mcp_proxy_adapter/core/client/__init__.py +11 -0
- mcp_proxy_adapter/core/client/auth_handler.py +120 -0
- mcp_proxy_adapter/core/client/client.py +314 -0
- mcp_proxy_adapter/core/client/factory.py +110 -0
- mcp_proxy_adapter/core/client/request_handler.py +122 -0
- mcp_proxy_adapter/core/client/ssl_handler.py +105 -0
- mcp_proxy_adapter/core/client_manager.py +281 -0
- mcp_proxy_adapter/core/client_security/__init__.py +53 -0
- mcp_proxy_adapter/core/client_security/auth_part.py +227 -0
- mcp_proxy_adapter/core/client_security/cert_part.py +124 -0
- mcp_proxy_adapter/core/client_security/facade.py +181 -0
- mcp_proxy_adapter/core/client_security/part_base.py +62 -0
- mcp_proxy_adapter/core/client_security/ssl_part.py +275 -0
- mcp_proxy_adapter/core/config/__init__.py +29 -0
- mcp_proxy_adapter/core/config/config.py +963 -0
- mcp_proxy_adapter/core/config/config_factory.py +16 -0
- mcp_proxy_adapter/core/config/config_graph.py +250 -0
- mcp_proxy_adapter/core/config/config_loader.py +70 -0
- mcp_proxy_adapter/core/config/env_placeholders.py +52 -0
- mcp_proxy_adapter/core/config/feature_manager.py +109 -0
- mcp_proxy_adapter/core/config/orchestration_section.py +119 -0
- mcp_proxy_adapter/core/config/reload_violations.py +269 -0
- mcp_proxy_adapter/core/config/section_validators.py +190 -0
- mcp_proxy_adapter/core/config/settings_declaration.py +255 -0
- mcp_proxy_adapter/core/config/simple_config.py +893 -0
- mcp_proxy_adapter/core/config/simple_config_generator.py +917 -0
- mcp_proxy_adapter/core/config/simple_config_validator.py +333 -0
- mcp_proxy_adapter/core/config/validators/__init__.py +29 -0
- mcp_proxy_adapter/core/config/validators/auth_validator.py +146 -0
- mcp_proxy_adapter/core/config/validators/base_validator.py +102 -0
- mcp_proxy_adapter/core/config/validators/certificate_validator_helper.py +114 -0
- mcp_proxy_adapter/core/config/validators/client_validator.py +131 -0
- mcp_proxy_adapter/core/config/validators/job_push_validator.py +55 -0
- mcp_proxy_adapter/core/config/validators/queue_manager_validator.py +133 -0
- mcp_proxy_adapter/core/config/validators/registration_validator.py +366 -0
- mcp_proxy_adapter/core/config/validators/server_validation_validator.py +154 -0
- mcp_proxy_adapter/core/config/validators/server_validator.py +326 -0
- mcp_proxy_adapter/core/config/validators/ssl_validator.py +221 -0
- mcp_proxy_adapter/core/config/websocket_validator.py +99 -0
- mcp_proxy_adapter/core/config_validator.py +29 -0
- mcp_proxy_adapter/core/constants.py +201 -0
- mcp_proxy_adapter/core/crl_utils.py +338 -0
- mcp_proxy_adapter/core/date_utils.py +119 -0
- mcp_proxy_adapter/core/delivery/__init__.py +35 -0
- mcp_proxy_adapter/core/delivery/contracts.py +57 -0
- mcp_proxy_adapter/core/delivery/exceptions.py +19 -0
- mcp_proxy_adapter/core/delivery/terminal_replay_store.py +129 -0
- mcp_proxy_adapter/core/delivery/ws_delivery_manager.py +117 -0
- mcp_proxy_adapter/core/domain_errors.py +189 -0
- mcp_proxy_adapter/core/error_handling.py +98 -0
- mcp_proxy_adapter/core/errors/__init__.py +259 -0
- mcp_proxy_adapter/core/errors/config_errors.py +142 -0
- mcp_proxy_adapter/core/file_utils.py +94 -0
- mcp_proxy_adapter/core/job_manager.py +115 -0
- mcp_proxy_adapter/core/job_push/__init__.py +124 -0
- mcp_proxy_adapter/core/job_push/caller_loss.py +89 -0
- mcp_proxy_adapter/core/job_push/engine.py +282 -0
- mcp_proxy_adapter/core/job_push/events/__init__.py +111 -0
- mcp_proxy_adapter/core/job_push/events/builders.py +282 -0
- mcp_proxy_adapter/core/job_push/events/command_session_payloads.py +50 -0
- mcp_proxy_adapter/core/job_push/events/delivery_payloads.py +52 -0
- mcp_proxy_adapter/core/job_push/events/event_names.py +163 -0
- mcp_proxy_adapter/core/job_push/events/job_payloads.py +83 -0
- mcp_proxy_adapter/core/job_push/events/transfer_payloads.py +72 -0
- mcp_proxy_adapter/core/job_push/execute_async_deliver_guard.py +55 -0
- mcp_proxy_adapter/core/job_push/finish_signal.py +91 -0
- mcp_proxy_adapter/core/job_push/hooks.py +53 -0
- mcp_proxy_adapter/core/job_push/job_status_accumulator.py +376 -0
- mcp_proxy_adapter/core/job_push/lifespan_wiring.py +252 -0
- mcp_proxy_adapter/core/job_push/notifier.py +139 -0
- mcp_proxy_adapter/core/job_push/notifier_policy.py +38 -0
- mcp_proxy_adapter/core/job_push/queue_custom_push.py +67 -0
- mcp_proxy_adapter/core/job_push/subscriptions.py +160 -0
- mcp_proxy_adapter/core/job_push/transfer_correlation.py +47 -0
- mcp_proxy_adapter/core/job_push/transfer_push.py +135 -0
- mcp_proxy_adapter/core/json_utils.py +81 -0
- mcp_proxy_adapter/core/logging/__init__.py +42 -0
- mcp_proxy_adapter/core/logging/formatters.py +55 -0
- mcp_proxy_adapter/core/logging/global_logger.py +41 -0
- mcp_proxy_adapter/core/logging/request_logger.py +50 -0
- mcp_proxy_adapter/core/logging/setup.py +190 -0
- mcp_proxy_adapter/core/logging/worker.py +107 -0
- mcp_proxy_adapter/core/mtls_asgi_app.py +216 -0
- mcp_proxy_adapter/core/mtls_server.py +180 -0
- mcp_proxy_adapter/core/orchestration/__init__.py +90 -0
- mcp_proxy_adapter/core/orchestration/candidate_validator.py +196 -0
- mcp_proxy_adapter/core/orchestration/catalog_builder.py +136 -0
- mcp_proxy_adapter/core/orchestration/catalog_snapshot.py +115 -0
- mcp_proxy_adapter/core/orchestration/command_record.py +43 -0
- mcp_proxy_adapter/core/orchestration/discovery_client.py +229 -0
- mcp_proxy_adapter/core/orchestration/orchestration_api.py +273 -0
- mcp_proxy_adapter/core/orchestration/orchestration_config.py +146 -0
- mcp_proxy_adapter/core/orchestration/orchestration_errors.py +305 -0
- mcp_proxy_adapter/core/orchestration/orchestration_lifespan.py +199 -0
- mcp_proxy_adapter/core/orchestration/parameter_graph.py +106 -0
- mcp_proxy_adapter/core/orchestration/polling_loop.py +281 -0
- mcp_proxy_adapter/core/orchestration/server_record.py +37 -0
- mcp_proxy_adapter/core/orchestration/snapshot_holder.py +90 -0
- mcp_proxy_adapter/core/orchestration/tool_context_exposure.py +83 -0
- mcp_proxy_adapter/core/orchestration/tool_context_snapshot.py +164 -0
- mcp_proxy_adapter/core/path_utils.py +220 -0
- mcp_proxy_adapter/core/protocol_manager.py +260 -0
- mcp_proxy_adapter/core/proxy/__init__.py +62 -0
- mcp_proxy_adapter/core/proxy/auth_manager.py +110 -0
- mcp_proxy_adapter/core/proxy_client.py +252 -0
- mcp_proxy_adapter/core/proxy_registration.py +55 -0
- mcp_proxy_adapter/core/role_utils.py +166 -0
- mcp_proxy_adapter/core/server_adapter.py +302 -0
- mcp_proxy_adapter/core/server_engine.py +384 -0
- mcp_proxy_adapter/core/settings.py +299 -0
- mcp_proxy_adapter/core/signal_handler.py +136 -0
- mcp_proxy_adapter/core/ssl_utils.py +482 -0
- mcp_proxy_adapter/core/transport_manager.py +168 -0
- mcp_proxy_adapter/core/utils.py +74 -0
- mcp_proxy_adapter/core/validation/__init__.py +21 -0
- mcp_proxy_adapter/core/validation/config_validator.py +256 -0
- mcp_proxy_adapter/core/validation/file_validator.py +229 -0
- mcp_proxy_adapter/core/validation/protocol_validator.py +322 -0
- mcp_proxy_adapter/core/validation/proxy_registration_validator.py +268 -0
- mcp_proxy_adapter/core/validation/security_validator.py +300 -0
- mcp_proxy_adapter/core/validation/validation_result.py +34 -0
- mcp_proxy_adapter/core/validation/validator_support.py +64 -0
- mcp_proxy_adapter/core/validation_utils.py +160 -0
- mcp_proxy_adapter/core/ws_timeouts.py +88 -0
- mcp_proxy_adapter/custom_openapi.py +93 -0
- mcp_proxy_adapter/examples/PROTOCOL_EXAMPLES.md +79 -0
- mcp_proxy_adapter/examples/README.md +272 -0
- mcp_proxy_adapter/examples/README_EN.md +258 -0
- mcp_proxy_adapter/examples/SECURITY_TESTING.md +455 -0
- mcp_proxy_adapter/examples/__init__.py +16 -0
- mcp_proxy_adapter/examples/basic_framework/__init__.py +9 -0
- mcp_proxy_adapter/examples/basic_framework/commands/__init__.py +4 -0
- mcp_proxy_adapter/examples/basic_framework/configs/http_auth.json +21 -0
- mcp_proxy_adapter/examples/basic_framework/configs/http_simple.json +21 -0
- mcp_proxy_adapter/examples/basic_framework/configs/https_auth.json +21 -0
- mcp_proxy_adapter/examples/basic_framework/configs/https_no_protocol_middleware.json +21 -0
- mcp_proxy_adapter/examples/basic_framework/configs/https_simple.json +21 -0
- mcp_proxy_adapter/examples/basic_framework/configs/mtls_no_protocol_middleware.json +21 -0
- mcp_proxy_adapter/examples/basic_framework/configs/mtls_no_roles.json +21 -0
- mcp_proxy_adapter/examples/basic_framework/configs/mtls_simple.json +21 -0
- mcp_proxy_adapter/examples/basic_framework/configs/mtls_with_registration.json +73 -0
- mcp_proxy_adapter/examples/basic_framework/configs/mtls_with_roles.json +21 -0
- mcp_proxy_adapter/examples/basic_framework/hooks/__init__.py +4 -0
- mcp_proxy_adapter/examples/basic_framework/main.py +123 -0
- mcp_proxy_adapter/examples/basic_framework/roles.json +1 -0
- mcp_proxy_adapter/examples/bug_report_security_framework.md +141 -0
- mcp_proxy_adapter/examples/cert_config.json +1 -0
- mcp_proxy_adapter/examples/certs/cert_config.json +1 -0
- mcp_proxy_adapter/examples/check_config.py +71 -0
- mcp_proxy_adapter/examples/check_config_split_parts/__init__.py +3 -0
- mcp_proxy_adapter/examples/check_config_split_parts/checker.py +247 -0
- mcp_proxy_adapter/examples/check_config_split_parts/cli.py +68 -0
- mcp_proxy_adapter/examples/check_config_split_parts/commands.py +102 -0
- mcp_proxy_adapter/examples/cli_config_examples/__init__.py +8 -0
- mcp_proxy_adapter/examples/cli_config_examples/examples_configs/http.json +69 -0
- mcp_proxy_adapter/examples/cli_config_examples/examples_configs/https_token_roles.json +84 -0
- mcp_proxy_adapter/examples/cli_config_examples/examples_configs/mtls_roles.json +84 -0
- mcp_proxy_adapter/examples/cli_config_examples/http_basic.py +97 -0
- mcp_proxy_adapter/examples/cli_config_examples/https_token.py +128 -0
- mcp_proxy_adapter/examples/cli_config_examples/mtls_roles.py +140 -0
- mcp_proxy_adapter/examples/client_configs/api_key_client.json +1 -0
- mcp_proxy_adapter/examples/client_configs/basic_auth_client.json +1 -0
- mcp_proxy_adapter/examples/client_configs/certificate_client.json +1 -0
- mcp_proxy_adapter/examples/client_configs/jwt_client.json +1 -0
- mcp_proxy_adapter/examples/client_configs/no_auth_client.json +1 -0
- mcp_proxy_adapter/examples/client_usage_example.py +216 -0
- mcp_proxy_adapter/examples/commands/__init__.py +5 -0
- mcp_proxy_adapter/examples/comprehensive/__init__.py +10 -0
- mcp_proxy_adapter/examples/comprehensive/run.py +906 -0
- mcp_proxy_adapter/examples/comprehensive_config.json +10 -0
- mcp_proxy_adapter/examples/config.json +10 -0
- mcp_proxy_adapter/examples/config_builder.py +272 -0
- mcp_proxy_adapter/examples/config_cli.py +340 -0
- mcp_proxy_adapter/examples/config_factory.py +325 -0
- mcp_proxy_adapter/examples/configs/full_featured.json +10 -0
- mcp_proxy_adapter/examples/configs/http_auth.json +10 -0
- mcp_proxy_adapter/examples/configs/http_simple.json +10 -0
- mcp_proxy_adapter/examples/configs/http_token.json +10 -0
- mcp_proxy_adapter/examples/configs/https_auth.json +10 -0
- mcp_proxy_adapter/examples/configs/https_simple.json +10 -0
- mcp_proxy_adapter/examples/configs/https_token.json +10 -0
- mcp_proxy_adapter/examples/configs/mtls_no_roles.json +10 -0
- mcp_proxy_adapter/examples/configs/mtls_simple.json +10 -0
- mcp_proxy_adapter/examples/configs/mtls_with_proxy.json +10 -0
- mcp_proxy_adapter/examples/configs/mtls_with_roles.json +10 -0
- mcp_proxy_adapter/examples/configs/roles.json +1 -0
- mcp_proxy_adapter/examples/create_test_configs.py +216 -0
- mcp_proxy_adapter/examples/debug_role_chain.py +192 -0
- mcp_proxy_adapter/examples/demo_client.py +339 -0
- mcp_proxy_adapter/examples/examples_correct/http_example.json +10 -0
- mcp_proxy_adapter/examples/full_application/__init__.py +11 -0
- mcp_proxy_adapter/examples/full_application/commands/__init__.py +32 -0
- mcp_proxy_adapter/examples/full_application/commands/custom_echo_command.py +75 -0
- mcp_proxy_adapter/examples/full_application/commands/dynamic_calculator_command.py +101 -0
- mcp_proxy_adapter/examples/full_application/commands/embed_job_status_command.py +133 -0
- mcp_proxy_adapter/examples/full_application/commands/embed_queue_command.py +153 -0
- mcp_proxy_adapter/examples/full_application/commands/long_running_command.py +175 -0
- mcp_proxy_adapter/examples/full_application/commands/slow_start_long_task_command.py +172 -0
- mcp_proxy_adapter/examples/full_application/configs/http_basic.json +73 -0
- mcp_proxy_adapter/examples/full_application/configs/http_basic_smart_assistant_proxy3004.json +67 -0
- mcp_proxy_adapter/examples/full_application/configs/http_no_registration.json +72 -0
- mcp_proxy_adapter/examples/full_application/configs/http_token.json +69 -0
- mcp_proxy_adapter/examples/full_application/configs/http_token_roles.json +81 -0
- mcp_proxy_adapter/examples/full_application/configs/http_token_roles_smart_assistant_proxy3004.json +81 -0
- mcp_proxy_adapter/examples/full_application/configs/http_token_smart_assistant_proxy3004.json +69 -0
- mcp_proxy_adapter/examples/full_application/configs/https_basic.json +74 -0
- mcp_proxy_adapter/examples/full_application/configs/https_basic_smart_assistant_proxy3004.json +81 -0
- mcp_proxy_adapter/examples/full_application/configs/https_token.json +76 -0
- mcp_proxy_adapter/examples/full_application/configs/https_token_roles.json +88 -0
- mcp_proxy_adapter/examples/full_application/configs/https_token_roles_smart_assistant_proxy3004.json +95 -0
- mcp_proxy_adapter/examples/full_application/configs/https_token_smart_assistant_proxy3004.json +83 -0
- mcp_proxy_adapter/examples/full_application/configs/mtls_no_roles.json +78 -0
- mcp_proxy_adapter/examples/full_application/configs/mtls_no_roles_correct.json +76 -0
- mcp_proxy_adapter/examples/full_application/configs/mtls_no_roles_smart_assistant_proxy3004.json +83 -0
- mcp_proxy_adapter/examples/full_application/configs/mtls_no_security.json +77 -0
- mcp_proxy_adapter/examples/full_application/configs/mtls_with_roles.json +82 -0
- mcp_proxy_adapter/examples/full_application/configs/mtls_with_roles_correct.json +88 -0
- mcp_proxy_adapter/examples/full_application/configs/mtls_with_roles_smart_assistant_proxy3004.json +95 -0
- mcp_proxy_adapter/examples/full_application/configs/mtls_ws_repro.json +76 -0
- mcp_proxy_adapter/examples/full_application/configs/proxy_server.json +64 -0
- mcp_proxy_adapter/examples/full_application/configs/proxy_server_https.json +63 -0
- mcp_proxy_adapter/examples/full_application/configs/proxy_server_mtls.json +63 -0
- mcp_proxy_adapter/examples/full_application/example_support.py +45 -0
- mcp_proxy_adapter/examples/full_application/hooks/__init__.py +4 -0
- mcp_proxy_adapter/examples/full_application/hooks/application_hooks.py +51 -0
- mcp_proxy_adapter/examples/full_application/hooks/builtin_command_hooks.py +46 -0
- mcp_proxy_adapter/examples/full_application/main.py +95 -0
- mcp_proxy_adapter/examples/full_application/main_modules/__init__.py +1 -0
- mcp_proxy_adapter/examples/full_application/main_modules/registration.py +122 -0
- mcp_proxy_adapter/examples/full_application/main_modules/runner.py +310 -0
- mcp_proxy_adapter/examples/full_application/proxy_commands/__init__.py +113 -0
- mcp_proxy_adapter/examples/full_application/proxy_commands/_shared.py +8 -0
- mcp_proxy_adapter/examples/full_application/proxy_commands/lifecycle_commands.py +196 -0
- mcp_proxy_adapter/examples/full_application/proxy_commands/register_command.py +254 -0
- mcp_proxy_adapter/examples/full_application/proxy_commands/registry_state.py +8 -0
- mcp_proxy_adapter/examples/full_application/proxy_commands/results.py +142 -0
- mcp_proxy_adapter/examples/full_application/proxy_endpoints.py +162 -0
- mcp_proxy_adapter/examples/full_application/proxy_schemas.py +91 -0
- mcp_proxy_adapter/examples/full_application/roles.json +1 -0
- mcp_proxy_adapter/examples/full_application/test_client.py +341 -0
- mcp_proxy_adapter/examples/full_application/test_minimal_server.py +57 -0
- mcp_proxy_adapter/examples/full_application/test_queue_and_descriptions.py +283 -0
- mcp_proxy_adapter/examples/full_application/test_server.py +221 -0
- mcp_proxy_adapter/examples/full_application/test_simple_server.py +141 -0
- mcp_proxy_adapter/examples/generate_all_certificates.py +74 -0
- mcp_proxy_adapter/examples/generate_config.py +44 -0
- mcp_proxy_adapter/examples/generate_config_parts/__init__.py +3 -0
- mcp_proxy_adapter/examples/generate_config_parts/builders.py +234 -0
- mcp_proxy_adapter/examples/generate_config_parts/cli.py +260 -0
- mcp_proxy_adapter/examples/generate_config_parts/outputs.py +137 -0
- mcp_proxy_adapter/examples/generator_validator_compatibility_report.md +127 -0
- mcp_proxy_adapter/examples/http_proxy_example.json +17 -0
- mcp_proxy_adapter/examples/https_proxy_example.json +17 -0
- mcp_proxy_adapter/examples/job_tracking_demo.py +235 -0
- mcp_proxy_adapter/examples/proxy_server_support.py +384 -0
- mcp_proxy_adapter/examples/queue_demo_simple.py +37 -0
- mcp_proxy_adapter/examples/queue_demo_simple_parts/__init__.py +3 -0
- mcp_proxy_adapter/examples/queue_demo_simple_parts/_shared.py +8 -0
- mcp_proxy_adapter/examples/queue_demo_simple_parts/demo.py +213 -0
- mcp_proxy_adapter/examples/queue_demo_simple_parts/mock_commands.py +130 -0
- mcp_proxy_adapter/examples/queue_demo_simple_parts/mock_manager.py +272 -0
- mcp_proxy_adapter/examples/queue_example_support.py +36 -0
- mcp_proxy_adapter/examples/queue_fire_and_forget_example.py +370 -0
- mcp_proxy_adapter/examples/queue_server_demo.py +73 -0
- mcp_proxy_adapter/examples/queue_server_example.py +76 -0
- mcp_proxy_adapter/examples/queue_server_simple.py +251 -0
- mcp_proxy_adapter/examples/required_certificates.py +216 -0
- mcp_proxy_adapter/examples/run_example.py +119 -0
- mcp_proxy_adapter/examples/run_full_test_suite.py +674 -0
- mcp_proxy_adapter/examples/run_proxy_server.py +118 -0
- mcp_proxy_adapter/examples/run_security_tests_fixed.py +876 -0
- mcp_proxy_adapter/examples/security_test/__init__.py +18 -0
- mcp_proxy_adapter/examples/security_test/auth_manager.py +49 -0
- mcp_proxy_adapter/examples/security_test/ssl_context_manager.py +144 -0
- mcp_proxy_adapter/examples/security_test/test_client.py +218 -0
- mcp_proxy_adapter/examples/security_test/test_result.py +23 -0
- mcp_proxy_adapter/examples/security_test_client.py +103 -0
- mcp_proxy_adapter/examples/server_configs/config_basic_http.json +16 -0
- mcp_proxy_adapter/examples/server_configs/config_http_token.json +16 -0
- mcp_proxy_adapter/examples/server_configs/config_https.json +16 -0
- mcp_proxy_adapter/examples/server_configs/config_https_token.json +16 -0
- mcp_proxy_adapter/examples/server_configs/config_mtls.json +16 -0
- mcp_proxy_adapter/examples/server_configs/config_proxy_registration.json +15 -0
- mcp_proxy_adapter/examples/server_configs/config_simple.json +9 -0
- mcp_proxy_adapter/examples/server_configs/http_simple.json +14 -0
- mcp_proxy_adapter/examples/server_configs/http_token.json +14 -0
- mcp_proxy_adapter/examples/server_configs/https_simple.json +14 -0
- mcp_proxy_adapter/examples/server_configs/https_token.json +14 -0
- mcp_proxy_adapter/examples/server_configs/mtls_no_roles.json +8 -0
- mcp_proxy_adapter/examples/server_configs/mtls_test.json +8 -0
- mcp_proxy_adapter/examples/server_configs/mtls_with_roles.json +14 -0
- mcp_proxy_adapter/examples/server_configs/roles.json +1 -0
- mcp_proxy_adapter/examples/setup/__init__.py +48 -0
- mcp_proxy_adapter/examples/setup/certificate_manager.py +384 -0
- mcp_proxy_adapter/examples/setup/config_generator.py +6 -0
- mcp_proxy_adapter/examples/setup/config_validator.py +140 -0
- mcp_proxy_adapter/examples/setup/environment_setup.py +143 -0
- mcp_proxy_adapter/examples/setup/test_files_generator.py +6 -0
- mcp_proxy_adapter/examples/setup/test_runner.py +143 -0
- mcp_proxy_adapter/examples/setup_test_environment.py +233 -0
- mcp_proxy_adapter/examples/simple_http_example.json +17 -0
- mcp_proxy_adapter/examples/simple_https_example.json +17 -0
- mcp_proxy_adapter/examples/simple_protocol_test.py +167 -0
- mcp_proxy_adapter/examples/test_client/README.md +166 -0
- mcp_proxy_adapter/examples/test_client/__init__.py +7 -0
- mcp_proxy_adapter/examples/test_client/main.py +102 -0
- mcp_proxy_adapter/examples/test_client/main_split_parts/__init__.py +1 -0
- mcp_proxy_adapter/examples/test_client/main_split_parts/helpers.py +83 -0
- mcp_proxy_adapter/examples/test_client/main_split_parts/runner.py +115 -0
- mcp_proxy_adapter/examples/test_client/main_split_parts/scenarios.py +195 -0
- mcp_proxy_adapter/examples/test_config.py +183 -0
- mcp_proxy_adapter/examples/test_configs/custom_https.json +10 -0
- mcp_proxy_adapter/examples/test_configs/http_simple.json +10 -0
- mcp_proxy_adapter/examples/test_examples.py +361 -0
- mcp_proxy_adapter/examples/test_mcp_server.py +249 -0
- mcp_proxy_adapter/examples/test_protocol_examples.py +373 -0
- mcp_proxy_adapter/examples/test_proxy/README.md +70 -0
- mcp_proxy_adapter/examples/test_proxy/__init__.py +7 -0
- mcp_proxy_adapter/examples/test_proxy/main.py +106 -0
- mcp_proxy_adapter/examples/test_server/README.md +58 -0
- mcp_proxy_adapter/examples/test_server/__init__.py +7 -0
- mcp_proxy_adapter/examples/test_server/main.py +349 -0
- mcp_proxy_adapter/examples/transparent_queue_commands.py +281 -0
- mcp_proxy_adapter/examples/transparent_queue_e1_sync_call.py +102 -0
- mcp_proxy_adapter/examples/transparent_queue_e2_event_stream.py +134 -0
- mcp_proxy_adapter/examples/transparent_queue_e3_ws_timeouts.py +341 -0
- mcp_proxy_adapter/examples/transparent_queue_e4_ws_fallback.py +159 -0
- mcp_proxy_adapter/examples/transparent_queue_e5_inner_failure.py +189 -0
- mcp_proxy_adapter/examples/transparent_queue_e6_atomic_state.py +203 -0
- mcp_proxy_adapter/examples/transparent_queue_e7_caller_loss.py +63 -0
- mcp_proxy_adapter/examples/transparent_queue_e7_split2/__init__.py +3 -0
- mcp_proxy_adapter/examples/transparent_queue_e7_split2/cases.py +335 -0
- mcp_proxy_adapter/examples/transparent_queue_e7_split2/helpers.py +66 -0
- mcp_proxy_adapter/examples/transparent_queue_support.py +377 -0
- mcp_proxy_adapter/examples/unified_error_handling_example.py +127 -0
- mcp_proxy_adapter/examples/unified_error_handling_split_parts/__init__.py +3 -0
- mcp_proxy_adapter/examples/unified_error_handling_split_parts/demos.py +180 -0
- mcp_proxy_adapter/examples/unified_error_handling_split_parts/runner.py +109 -0
- mcp_proxy_adapter/examples/unified_error_handling_split_parts/support.py +79 -0
- mcp_proxy_adapter/examples/unified_error_handling_texts.py +17 -0
- mcp_proxy_adapter/examples/universal_client.py +215 -0
- mcp_proxy_adapter/examples/universal_client_split_parts/__init__.py +3 -0
- mcp_proxy_adapter/examples/universal_client_split_parts/configs.py +104 -0
- mcp_proxy_adapter/examples/universal_client_split_parts/demos.py +144 -0
- mcp_proxy_adapter/examples/update_config_certificates.py +156 -0
- mcp_proxy_adapter/examples/validate_generator_compatibility_simple.py +60 -0
- mcp_proxy_adapter/examples/websocket_examples/__init__.py +8 -0
- mcp_proxy_adapter/examples/websocket_examples/client_bidirectional_websocket.py +100 -0
- mcp_proxy_adapter/examples/websocket_examples/client_websocket_job_status.py +103 -0
- mcp_proxy_adapter/examples/websocket_examples/run_ws_test_server.py +157 -0
- mcp_proxy_adapter/examples/ws_examples/__init__.py +6 -0
- mcp_proxy_adapter/examples/ws_examples/http_basic_ws.py +68 -0
- mcp_proxy_adapter/examples/ws_examples/http_token_roles_ws.py +66 -0
- mcp_proxy_adapter/examples/ws_examples/http_token_ws.py +80 -0
- mcp_proxy_adapter/examples/ws_examples/https_basic_ws.py +61 -0
- mcp_proxy_adapter/examples/ws_examples/https_token_roles_ws.py +67 -0
- mcp_proxy_adapter/examples/ws_examples/https_token_ws.py +64 -0
- mcp_proxy_adapter/examples/ws_examples/mtls_basic_ws.py +94 -0
- mcp_proxy_adapter/examples/ws_examples/mtls_roles_ws.py +88 -0
- mcp_proxy_adapter/examples/ws_examples/ws_example_runner.py +233 -0
- mcp_proxy_adapter/integrations/__init__.py +31 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/__init__.py +124 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/_compat.py +60 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/_health.py +299 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/_limits.py +70 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/_process_reap.py +232 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/_result_builders.py +119 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/_status_helpers.py +167 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/global_manager.py +174 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/job_types/__init__.py +375 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/job_types/value_types.py +97 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/job_types/worker_probe.py +29 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/manager/__init__.py +52 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/manager/fallback_base.py +240 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/manager/fallback_stop_base.py +179 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/manager/health_base.py +460 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/manager/integration.py +189 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/manager/job_start_base.py +333 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/manager/job_stop_base.py +274 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/manager/lifecycle_base.py +393 -0
- mcp_proxy_adapter/integrations/queuemgr_integration/manager/query_base.py +269 -0
- mcp_proxy_adapter/integrations/queuemgr_registration.py +66 -0
- mcp_proxy_adapter/integrations/queuemgr_version.py +39 -0
- mcp_proxy_adapter/main.py +385 -0
- mcp_proxy_adapter/main_ssl_paths.py +29 -0
- mcp_proxy_adapter/py.typed +0 -0
- mcp_proxy_adapter/schemas/base_schema.json +114 -0
- mcp_proxy_adapter/schemas/openapi_schema.json +269 -0
- mcp_proxy_adapter/schemas/roles.json +37 -0
- mcp_proxy_adapter/schemas/roles_schema.json +162 -0
- mcp_proxy_adapter/transfer/__init__.py +56 -0
- mcp_proxy_adapter/transfer/checksums.py +81 -0
- mcp_proxy_adapter/transfer/client_downloader/__init__.py +37 -0
- mcp_proxy_adapter/transfer/client_downloader/download_support.py +109 -0
- mcp_proxy_adapter/transfer/client_downloader/downloader.py +300 -0
- mcp_proxy_adapter/transfer/client_uploader.py +278 -0
- mcp_proxy_adapter/transfer/compression.py +127 -0
- mcp_proxy_adapter/transfer/errors.py +253 -0
- mcp_proxy_adapter/transfer/json_coerce.py +32 -0
- mcp_proxy_adapter/transfer/models.py +337 -0
- mcp_proxy_adapter/transfer/path_confinement.py +69 -0
- mcp_proxy_adapter/transfer/progress_percent.py +25 -0
- mcp_proxy_adapter/transfer/server_store.py +878 -0
- mcp_proxy_adapter/version.py +8 -0
- mcp_proxy_adapter_dev-8.11.16.dist-info/METADATA +1666 -0
- mcp_proxy_adapter_dev-8.11.16.dist-info/RECORD +644 -0
- mcp_proxy_adapter_dev-8.11.16.dist-info/WHEEL +5 -0
- mcp_proxy_adapter_dev-8.11.16.dist-info/entry_points.txt +12 -0
- mcp_proxy_adapter_dev-8.11.16.dist-info/top_level.txt +1 -0
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Custom OpenAPI schema generator for MCP Microservice compatible with MCP-Proxy.
|
|
3
|
+
|
|
4
|
+
Author: Vasiliy Zdanovskiy
|
|
5
|
+
email: vasilyvz@gmail.com
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
import copy
|
|
9
|
+
import threading
|
|
10
|
+
from typing import Any, Dict
|
|
11
|
+
|
|
12
|
+
from fastapi import FastAPI
|
|
13
|
+
|
|
14
|
+
# from mcp_proxy_adapter.api.openapi import (
|
|
15
|
+
# CustomOpenAPIGenerator,
|
|
16
|
+
# register_openapi_generator,
|
|
17
|
+
# get_openapi_generator,
|
|
18
|
+
# list_openapi_generators,
|
|
19
|
+
# )
|
|
20
|
+
|
|
21
|
+
_openapi_lock = threading.Lock()
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
def custom_openapi(app: FastAPI) -> Dict[str, Any]:
|
|
25
|
+
"""
|
|
26
|
+
Generate custom OpenAPI schema for the application.
|
|
27
|
+
|
|
28
|
+
Args:
|
|
29
|
+
app: FastAPI application instance
|
|
30
|
+
|
|
31
|
+
Returns:
|
|
32
|
+
Generated OpenAPI schema
|
|
33
|
+
"""
|
|
34
|
+
from mcp_proxy_adapter.api.openapi.openapi_generator import CustomOpenAPIGenerator
|
|
35
|
+
|
|
36
|
+
generator = CustomOpenAPIGenerator()
|
|
37
|
+
return generator.generate(app)
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
def custom_openapi_with_fallback(app: FastAPI) -> Dict[str, Any]:
|
|
41
|
+
"""
|
|
42
|
+
Generate custom OpenAPI schema with fallback to default generator.
|
|
43
|
+
|
|
44
|
+
Args:
|
|
45
|
+
app: FastAPI application instance
|
|
46
|
+
|
|
47
|
+
Returns:
|
|
48
|
+
Generated OpenAPI schema
|
|
49
|
+
"""
|
|
50
|
+
from mcp_proxy_adapter.commands import registry as command_registry
|
|
51
|
+
|
|
52
|
+
with _openapi_lock:
|
|
53
|
+
current_version = command_registry.get_openapi_version()
|
|
54
|
+
cached_version = getattr(app, "_openapi_registry_version", None)
|
|
55
|
+
if app.openapi_schema and cached_version == current_version:
|
|
56
|
+
return copy.deepcopy(app.openapi_schema)
|
|
57
|
+
try:
|
|
58
|
+
schema = custom_openapi(app)
|
|
59
|
+
except Exception as e:
|
|
60
|
+
from mcp_proxy_adapter.core.logging import get_global_logger
|
|
61
|
+
|
|
62
|
+
logger = get_global_logger()
|
|
63
|
+
logger.warning(f"Custom OpenAPI generation failed, using fallback: {e}")
|
|
64
|
+
|
|
65
|
+
# Fallback to default FastAPI OpenAPI generator
|
|
66
|
+
from fastapi.openapi.utils import get_openapi
|
|
67
|
+
|
|
68
|
+
schema = get_openapi(
|
|
69
|
+
title=app.title,
|
|
70
|
+
version=app.version,
|
|
71
|
+
description=app.description,
|
|
72
|
+
routes=app.routes,
|
|
73
|
+
)
|
|
74
|
+
app.openapi_schema = copy.deepcopy(schema)
|
|
75
|
+
# Stamp the registry version this schema was generated against, so a
|
|
76
|
+
# later command registration/unregistration (queue_load_command /
|
|
77
|
+
# queue_unload_command, plugin load/unload, ...) is detected on the
|
|
78
|
+
# NEXT request instead of staying invisible for the app's lifetime.
|
|
79
|
+
# `registry` is a process-global singleton (see
|
|
80
|
+
# commands/command_registry.py), but the version is stamped on the
|
|
81
|
+
# `app` object itself rather than kept in the registry, so this stays
|
|
82
|
+
# correct even with multiple FastAPI apps in one process: each app
|
|
83
|
+
# independently compares against the one shared counter and
|
|
84
|
+
# regenerates its own cached schema when it falls behind.
|
|
85
|
+
# Deliberate extension of the FastAPI instance with app-local cache
|
|
86
|
+
# state - `_openapi_registry_version` is not a real FastAPI attribute
|
|
87
|
+
# (mypy has no way to know this codebase stashes it there; its
|
|
88
|
+
# "maybe _openapi_routes_version?" suggestion is an unrelated,
|
|
89
|
+
# coincidentally-similar-looking name), it is this module's own
|
|
90
|
+
# per-app cache-invalidation marker, read back via the getattr()
|
|
91
|
+
# default-None guard above.
|
|
92
|
+
app._openapi_registry_version = current_version # type: ignore[attr-defined]
|
|
93
|
+
return copy.deepcopy(schema)
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# Protocol Examples
|
|
2
|
+
|
|
3
|
+
This directory contains real-world examples demonstrating HTTP and HTTPS protocols with proxy registration.
|
|
4
|
+
|
|
5
|
+
## Examples
|
|
6
|
+
|
|
7
|
+
### HTTP Protocol Example
|
|
8
|
+
- **File**: `http_proxy_example.json`
|
|
9
|
+
- **Port**: 20021
|
|
10
|
+
- **Protocol**: HTTP
|
|
11
|
+
- **Authentication**: API Key
|
|
12
|
+
- **Proxy Registration**: Enabled (HTTP)
|
|
13
|
+
|
|
14
|
+
### HTTPS Protocol Example
|
|
15
|
+
- **File**: `https_proxy_example.json`
|
|
16
|
+
- **Port**: 20022
|
|
17
|
+
- **Protocol**: HTTPS
|
|
18
|
+
- **Authentication**: API Key
|
|
19
|
+
- **Proxy Registration**: Enabled (HTTPS)
|
|
20
|
+
|
|
21
|
+
## Testing
|
|
22
|
+
|
|
23
|
+
Run the protocol examples test suite:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
python -m mcp_proxy_adapter.examples.test_protocol_examples
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
This will:
|
|
30
|
+
1. Start a proxy server on port 20005
|
|
31
|
+
2. Start HTTP test server on port 20021
|
|
32
|
+
3. Start HTTPS test server on port 20022
|
|
33
|
+
4. Test API key authentication on both protocols
|
|
34
|
+
5. Test proxy registration for both servers
|
|
35
|
+
6. Clean up all processes
|
|
36
|
+
|
|
37
|
+
## Configuration Details
|
|
38
|
+
|
|
39
|
+
### HTTP Example Features
|
|
40
|
+
- No SSL/TLS encryption
|
|
41
|
+
- API key authentication with admin/user roles
|
|
42
|
+
- Proxy registration over HTTP
|
|
43
|
+
- Heartbeat monitoring
|
|
44
|
+
|
|
45
|
+
### HTTPS Example Features
|
|
46
|
+
- SSL/TLS encryption with certificates
|
|
47
|
+
- API key authentication with admin/user roles
|
|
48
|
+
- Proxy registration over HTTPS
|
|
49
|
+
- Heartbeat monitoring
|
|
50
|
+
- Certificate validation
|
|
51
|
+
|
|
52
|
+
## API Keys
|
|
53
|
+
|
|
54
|
+
Both examples use the same API keys:
|
|
55
|
+
- **Admin**: `admin-secret-key`
|
|
56
|
+
- **User**: `user-secret-key`
|
|
57
|
+
|
|
58
|
+
## Proxy Registration
|
|
59
|
+
|
|
60
|
+
Both servers register with the proxy using:
|
|
61
|
+
- **HTTP Server**: `http://127.0.0.1:20005/proxy/register`
|
|
62
|
+
- **HTTPS Server**: `https://127.0.0.1:20005/proxy/register`
|
|
63
|
+
|
|
64
|
+
## Health Checks
|
|
65
|
+
|
|
66
|
+
Test server health:
|
|
67
|
+
- **HTTP**: `http://127.0.0.1:20021/health`
|
|
68
|
+
- **HTTPS**: `https://127.0.0.1:20022/health`
|
|
69
|
+
|
|
70
|
+
Test proxy health:
|
|
71
|
+
- **HTTP**: `http://127.0.0.1:20005/proxy/health`
|
|
72
|
+
- **HTTPS**: `https://127.0.0.1:20005/proxy/health`
|
|
73
|
+
|
|
74
|
+
## Requirements
|
|
75
|
+
|
|
76
|
+
- Python 3.8+
|
|
77
|
+
- mcp_proxy_adapter package
|
|
78
|
+
- SSL certificates (for HTTPS example)
|
|
79
|
+
- Ports 20005, 20021, 20022 available
|
|
@@ -0,0 +1,272 @@
|
|
|
1
|
+
# MCP Proxy Adapter - Examples and Security Testing
|
|
2
|
+
|
|
3
|
+
Этот каталог содержит примеры использования MCP Proxy Adapter с различными конфигурациями безопасности и комплексную систему тестирования.
|
|
4
|
+
|
|
5
|
+
## 📁 Структура каталога
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
examples/
|
|
9
|
+
├── README.md # Эта документация
|
|
10
|
+
├── SECURITY_TESTING.md # Документация по тестированию безопасности
|
|
11
|
+
├── generate_certificates.py # Скрипт генерации сертификатов
|
|
12
|
+
├── security_test_client.py # Клиент для тестирования безопасности
|
|
13
|
+
├── run_security_tests.py # Основной скрипт запуска тестов
|
|
14
|
+
├── cert_config.json # Конфигурация для генерации сертификатов
|
|
15
|
+
├── certs/ # Сгенерированные сертификаты
|
|
16
|
+
├── keys/ # Приватные ключи
|
|
17
|
+
├── server_configs/ # Конфигурации серверов
|
|
18
|
+
│ ├── config_basic_http.json # Базовый HTTP
|
|
19
|
+
│ ├── config_http_token.json # HTTP + токен
|
|
20
|
+
│ ├── config_https.json # HTTPS
|
|
21
|
+
│ ├── config_https_token.json # HTTPS + токен
|
|
22
|
+
│ ├── config_mtls.json # mTLS
|
|
23
|
+
│ └── roles.json # Роли и разрешения
|
|
24
|
+
└── commands/ # Пользовательские команды
|
|
25
|
+
└── __init__.py
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## 🚀 Быстрый старт
|
|
29
|
+
|
|
30
|
+
### 1. Подготовка окружения
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
# Активируйте виртуальную среду
|
|
34
|
+
source .venv/bin/activate
|
|
35
|
+
|
|
36
|
+
# Установите зависимости
|
|
37
|
+
pip install -e .
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
### 2. Запуск локального прокси (один для всех примеров)
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
python -m mcp_proxy_adapter.examples.run_proxy_server --host 127.0.0.1 --port 3004
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Оставьте это окно открытым. Все примеры будут автоматически регистрироваться в этом прокси.
|
|
47
|
+
|
|
48
|
+
### 3. Генерация сертификатов
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
# Сгенерируйте все необходимые сертификаты
|
|
52
|
+
cd mcp_proxy_adapter/examples
|
|
53
|
+
python generate_certificates.py
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### 4. Запуск комплексного тестирования безопасности
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
# Запустите все тесты безопасности (прокси запускается автоматически)
|
|
60
|
+
python -m mcp_proxy_adapter.examples.run_security_tests
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Этот скрипт автоматически:
|
|
64
|
+
- ✅ **Запускает прокси-сервер** на порту 3004 (если не запущен)
|
|
65
|
+
- ✅ Запускает все типы тестовых серверов (HTTP, HTTPS, mTLS)
|
|
66
|
+
- ✅ Выполняет комплексное тестирование безопасности
|
|
67
|
+
- ✅ Генерирует подробный отчет о результатах
|
|
68
|
+
- ✅ **Автоматически останавливает все серверы** после завершения
|
|
69
|
+
|
|
70
|
+
## 🔧 Конфигурации серверов
|
|
71
|
+
|
|
72
|
+
### Базовый HTTP (порт 8000)
|
|
73
|
+
```bash
|
|
74
|
+
python -m mcp_proxy_adapter.main --config server_configs/config_basic_http.json
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### HTTP + Токен аутентификация (порт 8001)
|
|
78
|
+
```bash
|
|
79
|
+
python -m mcp_proxy_adapter.main --config server_configs/config_http_token.json
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### HTTPS (порт 8443)
|
|
83
|
+
```bash
|
|
84
|
+
python -m mcp_proxy_adapter.main --config server_configs/config_https.json
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### HTTPS + Токен аутентификация (порт 8444)
|
|
88
|
+
```bash
|
|
89
|
+
python -m mcp_proxy_adapter.main --config server_configs/config_https_token.json
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### mTLS (порт 8445)
|
|
93
|
+
```bash
|
|
94
|
+
python -m mcp_proxy_adapter.main --config server_configs/config_mtls.json
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
## 🧪 Тестирование
|
|
98
|
+
|
|
99
|
+
### Тестирование отдельного сервера
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
# Тест базового HTTP сервера
|
|
103
|
+
python security_test_client.py --server http://localhost:8000 --auth none
|
|
104
|
+
|
|
105
|
+
# Тест HTTP с токеном
|
|
106
|
+
python security_test_client.py --server http://localhost:8001 --auth api_key --token test-token-123
|
|
107
|
+
|
|
108
|
+
# Тест HTTPS сервера
|
|
109
|
+
python security_test_client.py --server https://localhost:8443 --auth none
|
|
110
|
+
|
|
111
|
+
# Тест HTTPS с токеном
|
|
112
|
+
python security_test_client.py --server https://localhost:8444 --auth api_key --token test-token-123
|
|
113
|
+
|
|
114
|
+
# Тест mTLS с сертификатом
|
|
115
|
+
python security_test_client.py --server https://localhost:8445 --auth certificate --cert certs/admin_cert.pem --key keys/admin_key.pem --ca-cert certs/ca_cert.pem
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
### Тестирование всех сценариев
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
# Запустите все серверы и протестируйте их
|
|
122
|
+
python run_security_tests.py
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## 📋 Сценарии тестирования
|
|
126
|
+
|
|
127
|
+
### 1. Базовый HTTP (config_basic_http.json)
|
|
128
|
+
- **Порт**: 8000
|
|
129
|
+
- **Безопасность**: Отключена
|
|
130
|
+
- **Аутентификация**: Нет
|
|
131
|
+
- **Тесты**: Health check, echo command
|
|
132
|
+
|
|
133
|
+
### 2. HTTP + Токен (config_http_token.json)
|
|
134
|
+
- **Порт**: 8001
|
|
135
|
+
- **Безопасность**: API Key аутентификация
|
|
136
|
+
- **Токены**:
|
|
137
|
+
- `test-token-123` (admin)
|
|
138
|
+
- `user-token-456` (user)
|
|
139
|
+
- **Тесты**: Ролевая аутентификация, негативные тесты
|
|
140
|
+
|
|
141
|
+
### 3. HTTPS (config_https.json)
|
|
142
|
+
- **Порт**: 8443
|
|
143
|
+
- **Безопасность**: SSL/TLS
|
|
144
|
+
- **Сертификаты**: Самоподписанные
|
|
145
|
+
- **Тесты**: Защищенные соединения
|
|
146
|
+
|
|
147
|
+
### 4. HTTPS + Токен (config_https_token.json)
|
|
148
|
+
- **Порт**: 8444
|
|
149
|
+
- **Безопасность**: SSL/TLS + API Key
|
|
150
|
+
- **Тесты**: Комбинированная безопасность
|
|
151
|
+
|
|
152
|
+
### 5. mTLS (config_mtls.json)
|
|
153
|
+
- **Порт**: 8445
|
|
154
|
+
- **Безопасность**: Взаимная аутентификация сертификатами
|
|
155
|
+
- **Тесты**: Сертификатная аутентификация
|
|
156
|
+
|
|
157
|
+
## 🔑 Токены для тестирования
|
|
158
|
+
|
|
159
|
+
```json
|
|
160
|
+
{
|
|
161
|
+
"test-token-123": {
|
|
162
|
+
"roles": ["admin"],
|
|
163
|
+
"permissions": ["*"]
|
|
164
|
+
},
|
|
165
|
+
"user-token-456": {
|
|
166
|
+
"roles": ["user"],
|
|
167
|
+
"permissions": ["read", "execute"]
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
## 📜 Роли и разрешения
|
|
173
|
+
|
|
174
|
+
```json
|
|
175
|
+
{
|
|
176
|
+
"admin": ["*"],
|
|
177
|
+
"user": ["read", "write", "execute"],
|
|
178
|
+
"readonly": ["read"],
|
|
179
|
+
"guest": ["read"]
|
|
180
|
+
}
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
## 🛠️ Генерация конфигураций
|
|
184
|
+
|
|
185
|
+
Используйте встроенный генератор конфигураций:
|
|
186
|
+
|
|
187
|
+
```bash
|
|
188
|
+
# Генерация всех типов конфигураций
|
|
189
|
+
python -m mcp_proxy_adapter.utils.config_generator --all --output-dir ./generated_configs
|
|
190
|
+
|
|
191
|
+
# Генерация конкретного типа
|
|
192
|
+
python -m mcp_proxy_adapter.utils.config_generator --type https_token --output ./my_config.json
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
Доступные типы конфигураций:
|
|
196
|
+
- `minimal` - Минимальная конфигурация
|
|
197
|
+
- `development` - Для разработки
|
|
198
|
+
- `secure` - Максимальная безопасность
|
|
199
|
+
- `full` - Полная конфигурация
|
|
200
|
+
- `basic_http` - Базовый HTTP
|
|
201
|
+
- `http_token` - HTTP + токен
|
|
202
|
+
- `https` - HTTPS
|
|
203
|
+
- `https_token` - HTTPS + токен
|
|
204
|
+
- `mtls` - mTLS
|
|
205
|
+
|
|
206
|
+
## 🔍 Мониторинг и логи
|
|
207
|
+
|
|
208
|
+
Логи сохраняются в:
|
|
209
|
+
- `./logs/server.log` - Логи сервера
|
|
210
|
+
- `./logs/security.log` - Логи безопасности
|
|
211
|
+
|
|
212
|
+
Для просмотра логов в реальном времени:
|
|
213
|
+
```bash
|
|
214
|
+
tail -f logs/server.log
|
|
215
|
+
tail -f logs/security.log
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
## 🚨 Устранение неполадок
|
|
219
|
+
|
|
220
|
+
### Проблема: Сертификаты не найдены
|
|
221
|
+
```bash
|
|
222
|
+
# Проверьте наличие сертификатов
|
|
223
|
+
ls -la certs/
|
|
224
|
+
ls -la keys/
|
|
225
|
+
|
|
226
|
+
# Перегенерируйте сертификаты
|
|
227
|
+
python generate_certificates.py
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
### Проблема: Порт занят
|
|
231
|
+
```bash
|
|
232
|
+
# Найдите процесс, использующий порт
|
|
233
|
+
lsof -i :8000
|
|
234
|
+
lsof -i :8443
|
|
235
|
+
|
|
236
|
+
# Остановите процесс
|
|
237
|
+
kill -9 <PID>
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
### Проблема: SSL ошибки
|
|
241
|
+
```bash
|
|
242
|
+
# Проверьте сертификаты
|
|
243
|
+
openssl x509 -in certs/server_cert.pem -text -noout
|
|
244
|
+
|
|
245
|
+
# Проверьте приватный ключ
|
|
246
|
+
openssl rsa -in keys/server_key.pem -check
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
## 📚 Дополнительная документация
|
|
250
|
+
|
|
251
|
+
- [SECURITY_TESTING.md](SECURITY_TESTING.md) - Подробное руководство по тестированию безопасности
|
|
252
|
+
- [API Documentation](../docs/api/) - Документация API
|
|
253
|
+
- [Configuration Guide](../docs/configuration.md) - Руководство по конфигурации
|
|
254
|
+
|
|
255
|
+
## 🤝 Поддержка
|
|
256
|
+
|
|
257
|
+
Если у вас возникли проблемы:
|
|
258
|
+
|
|
259
|
+
1. Проверьте логи в `./logs/`
|
|
260
|
+
2. Убедитесь, что все зависимости установлены
|
|
261
|
+
3. Проверьте, что сертификаты сгенерированы корректно
|
|
262
|
+
4. Обратитесь к документации по устранению неполадок
|
|
263
|
+
|
|
264
|
+
## 📄 Лицензия
|
|
265
|
+
|
|
266
|
+
Этот проект распространяется под лицензией MIT. См. файл [LICENSE](../../LICENSE) для подробностей.
|
|
267
|
+
|
|
268
|
+
---
|
|
269
|
+
|
|
270
|
+
**Автор**: Vasiliy Zdanovskiy
|
|
271
|
+
**Email**: vasilyvz@gmail.com
|
|
272
|
+
**Версия**: 1.0.0
|
|
@@ -0,0 +1,258 @@
|
|
|
1
|
+
# MCP Proxy Adapter - Examples and Security Testing
|
|
2
|
+
|
|
3
|
+
This directory contains examples of using MCP Proxy Adapter with various security configurations and a comprehensive testing system.
|
|
4
|
+
|
|
5
|
+
## 📁 Directory Structure
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
examples/
|
|
9
|
+
├── README.md # This documentation
|
|
10
|
+
├── README_EN.md # English documentation
|
|
11
|
+
├── SECURITY_TESTING.md # Security testing documentation
|
|
12
|
+
├── generate_certificates.py # Certificate generation script
|
|
13
|
+
├── security_test_client.py # Security testing client
|
|
14
|
+
├── run_security_tests.py # Main test runner script
|
|
15
|
+
├── cert_config.json # Certificate generation configuration
|
|
16
|
+
├── certs/ # Generated certificates
|
|
17
|
+
├── keys/ # Private keys
|
|
18
|
+
├── server_configs/ # Server configurations
|
|
19
|
+
│ ├── config_basic_http.json # Basic HTTP
|
|
20
|
+
│ ├── config_http_token.json # HTTP + token
|
|
21
|
+
│ ├── config_https.json # HTTPS
|
|
22
|
+
│ ├── config_https_token.json # HTTPS + token
|
|
23
|
+
│ ├── config_mtls.json # mTLS
|
|
24
|
+
│ └── roles.json # Roles and permissions
|
|
25
|
+
└── commands/ # Custom commands
|
|
26
|
+
└── __init__.py
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## 🚀 Quick Start
|
|
30
|
+
|
|
31
|
+
### 1. Environment Setup
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
# Activate virtual environment
|
|
35
|
+
source .venv/bin/activate
|
|
36
|
+
|
|
37
|
+
# Install dependencies
|
|
38
|
+
pip install -e .
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### 2. Generate Certificates
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
# Generate all necessary certificates
|
|
45
|
+
cd mcp_proxy_adapter/examples
|
|
46
|
+
python generate_certificates.py
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### 3. Run Security Tests
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# Run all security tests
|
|
53
|
+
python run_security_tests.py
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## 🔧 Server Configurations
|
|
57
|
+
|
|
58
|
+
### Basic HTTP (port 8000)
|
|
59
|
+
```bash
|
|
60
|
+
python -m mcp_proxy_adapter.main --config server_configs/config_basic_http.json
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
### HTTP + Token Authentication (port 8001)
|
|
64
|
+
```bash
|
|
65
|
+
python -m mcp_proxy_adapter.main --config server_configs/config_http_token.json
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### HTTPS (port 8443)
|
|
69
|
+
```bash
|
|
70
|
+
python -m mcp_proxy_adapter.main --config server_configs/config_https.json
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### HTTPS + Token Authentication (port 8444)
|
|
74
|
+
```bash
|
|
75
|
+
python -m mcp_proxy_adapter.main --config server_configs/config_https_token.json
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### mTLS (port 8445)
|
|
79
|
+
```bash
|
|
80
|
+
python -m mcp_proxy_adapter.main --config server_configs/config_mtls.json
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## 🧪 Testing
|
|
84
|
+
|
|
85
|
+
### Testing Individual Server
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
# Test basic HTTP server
|
|
89
|
+
python security_test_client.py --server http://localhost:8000 --auth none
|
|
90
|
+
|
|
91
|
+
# Test HTTP with token
|
|
92
|
+
python security_test_client.py --server http://localhost:8001 --auth api_key --token test-token-123
|
|
93
|
+
|
|
94
|
+
# Test HTTPS server
|
|
95
|
+
python security_test_client.py --server https://localhost:8443 --auth none
|
|
96
|
+
|
|
97
|
+
# Test HTTPS with token
|
|
98
|
+
python security_test_client.py --server https://localhost:8444 --auth api_key --token test-token-123
|
|
99
|
+
|
|
100
|
+
# Test mTLS with certificate
|
|
101
|
+
python security_test_client.py --server https://localhost:8445 --auth certificate --cert certs/admin_cert.pem --key keys/admin_key.pem --ca-cert certs/ca_cert.pem
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### Testing All Scenarios
|
|
105
|
+
|
|
106
|
+
```bash
|
|
107
|
+
# Start all servers and test them
|
|
108
|
+
python run_security_tests.py
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## 📋 Testing Scenarios
|
|
112
|
+
|
|
113
|
+
### 1. Basic HTTP (config_basic_http.json)
|
|
114
|
+
- **Port**: 8000
|
|
115
|
+
- **Security**: Disabled
|
|
116
|
+
- **Authentication**: None
|
|
117
|
+
- **Tests**: Health check, echo command
|
|
118
|
+
|
|
119
|
+
### 2. HTTP + Token (config_http_token.json)
|
|
120
|
+
- **Port**: 8001
|
|
121
|
+
- **Security**: API Key authentication
|
|
122
|
+
- **Tokens**:
|
|
123
|
+
- `test-token-123` (admin)
|
|
124
|
+
- `user-token-456` (user)
|
|
125
|
+
- **Tests**: Role-based authentication, negative tests
|
|
126
|
+
|
|
127
|
+
### 3. HTTPS (config_https.json)
|
|
128
|
+
- **Port**: 8443
|
|
129
|
+
- **Security**: SSL/TLS
|
|
130
|
+
- **Certificates**: Self-signed
|
|
131
|
+
- **Tests**: Secure connections
|
|
132
|
+
|
|
133
|
+
### 4. HTTPS + Token (config_https_token.json)
|
|
134
|
+
- **Port**: 8444
|
|
135
|
+
- **Security**: SSL/TLS + API Key
|
|
136
|
+
- **Tests**: Combined security
|
|
137
|
+
|
|
138
|
+
### 5. mTLS (config_mtls.json)
|
|
139
|
+
- **Port**: 8445
|
|
140
|
+
- **Security**: Mutual certificate authentication
|
|
141
|
+
- **Tests**: Certificate authentication
|
|
142
|
+
|
|
143
|
+
## 🔑 Test Tokens
|
|
144
|
+
|
|
145
|
+
```json
|
|
146
|
+
{
|
|
147
|
+
"test-token-123": {
|
|
148
|
+
"roles": ["admin"],
|
|
149
|
+
"permissions": ["*"]
|
|
150
|
+
},
|
|
151
|
+
"user-token-456": {
|
|
152
|
+
"roles": ["user"],
|
|
153
|
+
"permissions": ["read", "execute"]
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
## 📜 Roles and Permissions
|
|
159
|
+
|
|
160
|
+
```json
|
|
161
|
+
{
|
|
162
|
+
"admin": ["*"],
|
|
163
|
+
"user": ["read", "write", "execute"],
|
|
164
|
+
"readonly": ["read"],
|
|
165
|
+
"guest": ["read"]
|
|
166
|
+
}
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
## 🛠️ Configuration Generation
|
|
170
|
+
|
|
171
|
+
Use the built-in configuration generator:
|
|
172
|
+
|
|
173
|
+
```bash
|
|
174
|
+
# Generate all configuration types
|
|
175
|
+
python -m mcp_proxy_adapter.utils.config_generator --all --output-dir ./generated_configs
|
|
176
|
+
|
|
177
|
+
# Generate specific type
|
|
178
|
+
python -m mcp_proxy_adapter.utils.config_generator --type https_token --output ./my_config.json
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
Available configuration types:
|
|
182
|
+
- `minimal` - Minimal configuration
|
|
183
|
+
- `development` - For development
|
|
184
|
+
- `secure` - Maximum security
|
|
185
|
+
- `full` - Full configuration
|
|
186
|
+
- `basic_http` - Basic HTTP
|
|
187
|
+
- `http_token` - HTTP + token
|
|
188
|
+
- `https` - HTTPS
|
|
189
|
+
- `https_token` - HTTPS + token
|
|
190
|
+
- `mtls` - mTLS
|
|
191
|
+
|
|
192
|
+
## 🔍 Monitoring and Logs
|
|
193
|
+
|
|
194
|
+
Logs are saved to:
|
|
195
|
+
- `./logs/server.log` - Server logs
|
|
196
|
+
- `./logs/security.log` - Security logs
|
|
197
|
+
|
|
198
|
+
To view logs in real-time:
|
|
199
|
+
```bash
|
|
200
|
+
tail -f logs/server.log
|
|
201
|
+
tail -f logs/security.log
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
## 🚨 Troubleshooting
|
|
205
|
+
|
|
206
|
+
### Issue: Certificates not found
|
|
207
|
+
```bash
|
|
208
|
+
# Check certificate availability
|
|
209
|
+
ls -la certs/
|
|
210
|
+
ls -la keys/
|
|
211
|
+
|
|
212
|
+
# Regenerate certificates
|
|
213
|
+
python generate_certificates.py
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
### Issue: Port in use
|
|
217
|
+
```bash
|
|
218
|
+
# Find process using port
|
|
219
|
+
lsof -i :8000
|
|
220
|
+
lsof -i :8443
|
|
221
|
+
|
|
222
|
+
# Stop process
|
|
223
|
+
kill -9 <PID>
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
### Issue: SSL errors
|
|
227
|
+
```bash
|
|
228
|
+
# Check certificates
|
|
229
|
+
openssl x509 -in certs/server_cert.pem -text -noout
|
|
230
|
+
|
|
231
|
+
# Check private key
|
|
232
|
+
openssl rsa -in keys/server_key.pem -check
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
## 📚 Additional Documentation
|
|
236
|
+
|
|
237
|
+
- [SECURITY_TESTING.md](SECURITY_TESTING.md) - Detailed security testing guide
|
|
238
|
+
- [API Documentation](../docs/api/) - API documentation
|
|
239
|
+
- [Configuration Guide](../docs/configuration.md) - Configuration guide
|
|
240
|
+
|
|
241
|
+
## 🤝 Support
|
|
242
|
+
|
|
243
|
+
If you encounter issues:
|
|
244
|
+
|
|
245
|
+
1. Check logs in `./logs/`
|
|
246
|
+
2. Ensure all dependencies are installed
|
|
247
|
+
3. Verify certificates are generated correctly
|
|
248
|
+
4. Refer to troubleshooting documentation
|
|
249
|
+
|
|
250
|
+
## 📄 License
|
|
251
|
+
|
|
252
|
+
This project is licensed under the MIT License. See the [LICENSE](../../LICENSE) file for details.
|
|
253
|
+
|
|
254
|
+
---
|
|
255
|
+
|
|
256
|
+
**Author**: Vasiliy Zdanovskiy
|
|
257
|
+
**Email**: vasilyvz@gmail.com
|
|
258
|
+
**Version**: 1.0.0
|