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.
Files changed (644) hide show
  1. mcp_proxy_adapter/__init__.py +73 -0
  2. mcp_proxy_adapter/__main__.py +13 -0
  3. mcp_proxy_adapter/api/__init__.py +38 -0
  4. mcp_proxy_adapter/api/app.py +64 -0
  5. mcp_proxy_adapter/api/command_session_service.py +455 -0
  6. mcp_proxy_adapter/api/core/__init__.py +19 -0
  7. mcp_proxy_adapter/api/core/app_factory.py +215 -0
  8. mcp_proxy_adapter/api/core/app_factory_certificates.py +159 -0
  9. mcp_proxy_adapter/api/core/app_factory_config.py +75 -0
  10. mcp_proxy_adapter/api/core/app_factory_routes.py +345 -0
  11. mcp_proxy_adapter/api/core/app_factory_validators.py +165 -0
  12. mcp_proxy_adapter/api/core/lifespan_manager/__init__.py +52 -0
  13. mcp_proxy_adapter/api/core/lifespan_manager/manager.py +354 -0
  14. mcp_proxy_adapter/api/core/lifespan_manager/queue_config.py +37 -0
  15. mcp_proxy_adapter/api/core/lifespan_manager/signal_registration.py +74 -0
  16. mcp_proxy_adapter/api/core/registration/__init__.py +24 -0
  17. mcp_proxy_adapter/api/core/registration/config_parsers.py +247 -0
  18. mcp_proxy_adapter/api/core/registration/context_builder.py +130 -0
  19. mcp_proxy_adapter/api/core/registration/helpers.py +36 -0
  20. mcp_proxy_adapter/api/core/registration/metadata_builders.py +117 -0
  21. mcp_proxy_adapter/api/core/registration/models.py +42 -0
  22. mcp_proxy_adapter/api/core/registration/resolvers.py +195 -0
  23. mcp_proxy_adapter/api/core/registration/url_builders.py +122 -0
  24. mcp_proxy_adapter/api/core/registration_context.py +30 -0
  25. mcp_proxy_adapter/api/core/registration_manager/__init__.py +31 -0
  26. mcp_proxy_adapter/api/core/registration_manager/helpers.py +307 -0
  27. mcp_proxy_adapter/api/core/registration_manager/manager.py +584 -0
  28. mcp_proxy_adapter/api/core/registration_manager/status.py +152 -0
  29. mcp_proxy_adapter/api/core/registration_tasks.py +387 -0
  30. mcp_proxy_adapter/api/core/ssl_context_factory.py +99 -0
  31. mcp_proxy_adapter/api/execute_async_contract.py +124 -0
  32. mcp_proxy_adapter/api/handlers/__init__.py +335 -0
  33. mcp_proxy_adapter/api/handlers/command_execution.py +709 -0
  34. mcp_proxy_adapter/api/handlers/health.py +157 -0
  35. mcp_proxy_adapter/api/handlers/jsonrpc.py +207 -0
  36. mcp_proxy_adapter/api/handlers/transfer_notify.py +313 -0
  37. mcp_proxy_adapter/api/handlers/transfer_sessions.py +287 -0
  38. mcp_proxy_adapter/api/handlers_async.py +233 -0
  39. mcp_proxy_adapter/api/health_provider.py +44 -0
  40. mcp_proxy_adapter/api/jsonrpc_job_lifecycle.py +165 -0
  41. mcp_proxy_adapter/api/jsonrpc_job_status.py +94 -0
  42. mcp_proxy_adapter/api/middleware/__init__.py +14 -0
  43. mcp_proxy_adapter/api/middleware/command_permission_middleware.py +73 -0
  44. mcp_proxy_adapter/api/middleware/request_logging.py +153 -0
  45. mcp_proxy_adapter/api/middleware/unified_security.py +367 -0
  46. mcp_proxy_adapter/api/openapi/__init__.py +18 -0
  47. mcp_proxy_adapter/api/openapi/command_integration.py +107 -0
  48. mcp_proxy_adapter/api/openapi/openapi_generator.py +138 -0
  49. mcp_proxy_adapter/api/openapi/openapi_registry.py +55 -0
  50. mcp_proxy_adapter/api/public_downloads.py +68 -0
  51. mcp_proxy_adapter/api/schemas.py +290 -0
  52. mcp_proxy_adapter/api/tool_integration.py +124 -0
  53. mcp_proxy_adapter/api/tools.py +244 -0
  54. mcp_proxy_adapter/api/transfer_session_service.py +329 -0
  55. mcp_proxy_adapter/api/ws_endpoint.py +653 -0
  56. mcp_proxy_adapter/api/ws_identity.py +111 -0
  57. mcp_proxy_adapter/cli/__init__.py +12 -0
  58. mcp_proxy_adapter/cli/commands/__init__.py +14 -0
  59. mcp_proxy_adapter/cli/commands/client.py +137 -0
  60. mcp_proxy_adapter/cli/commands/config_docs/__init__.py +23 -0
  61. mcp_proxy_adapter/cli/commands/config_docs/cli.py +63 -0
  62. mcp_proxy_adapter/cli/commands/config_docs/declared_settings.py +45 -0
  63. mcp_proxy_adapter/cli/commands/config_docs/render.py +58 -0
  64. mcp_proxy_adapter/cli/commands/config_docs/sections/__init__.py +61 -0
  65. mcp_proxy_adapter/cli/commands/config_docs/sections/_chunk.py +19 -0
  66. mcp_proxy_adapter/cli/commands/config_docs/sections/authentication.py +127 -0
  67. mcp_proxy_adapter/cli/commands/config_docs/sections/best_practices.py +166 -0
  68. mcp_proxy_adapter/cli/commands/config_docs/sections/common_patterns.py +154 -0
  69. mcp_proxy_adapter/cli/commands/config_docs/sections/overview.py +135 -0
  70. mcp_proxy_adapter/cli/commands/config_docs/sections/queue_manager.py +140 -0
  71. mcp_proxy_adapter/cli/commands/config_docs/sections/registration.py +212 -0
  72. mcp_proxy_adapter/cli/commands/config_docs/sections/server.py +193 -0
  73. mcp_proxy_adapter/cli/commands/config_docs/sections/troubleshooting.py +215 -0
  74. mcp_proxy_adapter/cli/commands/config_generate.py +95 -0
  75. mcp_proxy_adapter/cli/commands/config_generate_parts/__init__.py +1 -0
  76. mcp_proxy_adapter/cli/commands/config_generate_parts/arguments.py +44 -0
  77. mcp_proxy_adapter/cli/commands/config_generate_parts/arguments_core.py +141 -0
  78. mcp_proxy_adapter/cli/commands/config_generate_parts/arguments_queue.py +140 -0
  79. mcp_proxy_adapter/cli/commands/config_generate_parts/arguments_validation.py +142 -0
  80. mcp_proxy_adapter/cli/commands/config_generate_parts/generation.py +365 -0
  81. mcp_proxy_adapter/cli/commands/config_generate_parts/parsing.py +122 -0
  82. mcp_proxy_adapter/cli/commands/config_validate.py +154 -0
  83. mcp_proxy_adapter/cli/commands/info.py +297 -0
  84. mcp_proxy_adapter/cli/commands/server.py +361 -0
  85. mcp_proxy_adapter/cli/commands/sets.py +165 -0
  86. mcp_proxy_adapter/cli/commands/standalone_entry.py +25 -0
  87. mcp_proxy_adapter/cli/commands/testconfig.py +205 -0
  88. mcp_proxy_adapter/cli/examples/__init__.py +9 -0
  89. mcp_proxy_adapter/cli/main.py +75 -0
  90. mcp_proxy_adapter/cli/parser.py +244 -0
  91. mcp_proxy_adapter/cli/validators.py +389 -0
  92. mcp_proxy_adapter/client/jsonrpc_client/__init__.py +139 -0
  93. mcp_proxy_adapter/client/jsonrpc_client/client.py +257 -0
  94. mcp_proxy_adapter/client/jsonrpc_client/command_api.py +369 -0
  95. mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/__init__.py +1 -0
  96. mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/async_base.py +241 -0
  97. mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/basic_base.py +150 -0
  98. mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/catalog_base.py +178 -0
  99. mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/constants.py +38 -0
  100. mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/helpers.py +66 -0
  101. mcp_proxy_adapter/client/jsonrpc_client/command_api_bases/queue_base.py +137 -0
  102. mcp_proxy_adapter/client/jsonrpc_client/exceptions/__init__.py +70 -0
  103. mcp_proxy_adapter/client/jsonrpc_client/exceptions/base.py +102 -0
  104. mcp_proxy_adapter/client/jsonrpc_client/exceptions/classification.py +143 -0
  105. mcp_proxy_adapter/client/jsonrpc_client/exceptions/request_errors.py +169 -0
  106. mcp_proxy_adapter/client/jsonrpc_client/exceptions/schema_errors.py +90 -0
  107. mcp_proxy_adapter/client/jsonrpc_client/exceptions/transfer_errors.py +48 -0
  108. mcp_proxy_adapter/client/jsonrpc_client/exceptions/transport_errors.py +153 -0
  109. mcp_proxy_adapter/client/jsonrpc_client/execution_status_observer.py +66 -0
  110. mcp_proxy_adapter/client/jsonrpc_client/job_event_registry.py +322 -0
  111. mcp_proxy_adapter/client/jsonrpc_client/job_tracking_mixin.py +206 -0
  112. mcp_proxy_adapter/client/jsonrpc_client/job_tracking_types.py +135 -0
  113. mcp_proxy_adapter/client/jsonrpc_client/openapi_validator.py +127 -0
  114. mcp_proxy_adapter/client/jsonrpc_client/operation_state.py +221 -0
  115. mcp_proxy_adapter/client/jsonrpc_client/proxy_api.py +93 -0
  116. mcp_proxy_adapter/client/jsonrpc_client/proxy_api_bases/__init__.py +1 -0
  117. mcp_proxy_adapter/client/jsonrpc_client/proxy_api_bases/client_base.py +117 -0
  118. mcp_proxy_adapter/client/jsonrpc_client/proxy_api_bases/lifecycle_base.py +222 -0
  119. mcp_proxy_adapter/client/jsonrpc_client/proxy_api_bases/register_base.py +230 -0
  120. mcp_proxy_adapter/client/jsonrpc_client/proxy_api_bases/uuid_base.py +95 -0
  121. mcp_proxy_adapter/client/jsonrpc_client/queue_api.py +302 -0
  122. mcp_proxy_adapter/client/jsonrpc_client/queue_status.py +192 -0
  123. mcp_proxy_adapter/client/jsonrpc_client/schema_generator.py +143 -0
  124. mcp_proxy_adapter/client/jsonrpc_client/schema_generator_bases/__init__.py +1 -0
  125. mcp_proxy_adapter/client/jsonrpc_client/schema_generator_bases/models.py +45 -0
  126. mcp_proxy_adapter/client/jsonrpc_client/schema_generator_bases/parse_base.py +215 -0
  127. mcp_proxy_adapter/client/jsonrpc_client/schema_generator_bases/validate_base.py +181 -0
  128. mcp_proxy_adapter/client/jsonrpc_client/transfer_integrity.py +57 -0
  129. mcp_proxy_adapter/client/jsonrpc_client/transport/__init__.py +161 -0
  130. mcp_proxy_adapter/client/jsonrpc_client/transport/constants.py +30 -0
  131. mcp_proxy_adapter/client/jsonrpc_client/transport/helpers.py +118 -0
  132. mcp_proxy_adapter/client/jsonrpc_client/transport/http_base.py +325 -0
  133. mcp_proxy_adapter/client/jsonrpc_client/transport/rpc_base.py +311 -0
  134. mcp_proxy_adapter/client/jsonrpc_client/transport/tls_base.py +295 -0
  135. mcp_proxy_adapter/client/jsonrpc_client/transport/transfer_base.py +282 -0
  136. mcp_proxy_adapter/client/jsonrpc_client/ws_command_session.py +230 -0
  137. mcp_proxy_adapter/client/jsonrpc_client/ws_command_session_bases/__init__.py +1 -0
  138. mcp_proxy_adapter/client/jsonrpc_client/ws_command_session_bases/core_base.py +154 -0
  139. mcp_proxy_adapter/client/jsonrpc_client/ws_command_session_bases/helpers.py +72 -0
  140. mcp_proxy_adapter/client/jsonrpc_client/ws_command_session_bases/wait_base.py +279 -0
  141. mcp_proxy_adapter/client/jsonrpc_client/ws_job_status.py +337 -0
  142. mcp_proxy_adapter/client/jsonrpc_client/ws_job_status_parts/__init__.py +1 -0
  143. mcp_proxy_adapter/client/jsonrpc_client/ws_job_status_parts/channel.py +159 -0
  144. mcp_proxy_adapter/client/jsonrpc_client/ws_job_status_parts/command_channel.py +154 -0
  145. mcp_proxy_adapter/client/jsonrpc_client/ws_job_status_parts/helpers.py +76 -0
  146. mcp_proxy_adapter/client/proxy.py +124 -0
  147. mcp_proxy_adapter/commands/__init__.py +27 -0
  148. mcp_proxy_adapter/commands/base.py +998 -0
  149. mcp_proxy_adapter/commands/builtin_commands.py +186 -0
  150. mcp_proxy_adapter/commands/command_help_info.py +101 -0
  151. mcp_proxy_adapter/commands/command_registry/__init__.py +55 -0
  152. mcp_proxy_adapter/commands/command_registry/builtins_part.py +206 -0
  153. mcp_proxy_adapter/commands/command_registry/facade.py +310 -0
  154. mcp_proxy_adapter/commands/command_registry/lifecycle_part.py +232 -0
  155. mcp_proxy_adapter/commands/command_registry/loader.py +145 -0
  156. mcp_proxy_adapter/commands/command_registry/mutations_part.py +228 -0
  157. mcp_proxy_adapter/commands/command_registry/part_base.py +59 -0
  158. mcp_proxy_adapter/commands/command_registry/queries_part.py +304 -0
  159. mcp_proxy_adapter/commands/config_command.py +208 -0
  160. mcp_proxy_adapter/commands/dependency_container.py +35 -0
  161. mcp_proxy_adapter/commands/echo_command.py +97 -0
  162. mcp_proxy_adapter/commands/health_command.py +162 -0
  163. mcp_proxy_adapter/commands/help_command.py +296 -0
  164. mcp_proxy_adapter/commands/hooks.py +590 -0
  165. mcp_proxy_adapter/commands/job_metadata.py +26 -0
  166. mcp_proxy_adapter/commands/load_command.py +134 -0
  167. mcp_proxy_adapter/commands/nested_validation.py +185 -0
  168. mcp_proxy_adapter/commands/plugins_command.py +250 -0
  169. mcp_proxy_adapter/commands/proxy_registration_command.py +475 -0
  170. mcp_proxy_adapter/commands/queue/__init__.py +83 -0
  171. mcp_proxy_adapter/commands/queue/add_job_command.py +358 -0
  172. mcp_proxy_adapter/commands/queue/command_execution_diagnostics.py +100 -0
  173. mcp_proxy_adapter/commands/queue/delete_job_command.py +92 -0
  174. mcp_proxy_adapter/commands/queue/get_logs_command.py +90 -0
  175. mcp_proxy_adapter/commands/queue/get_status_command.py +105 -0
  176. mcp_proxy_adapter/commands/queue/health_command.py +44 -0
  177. mcp_proxy_adapter/commands/queue/job_domain_errors.py +117 -0
  178. mcp_proxy_adapter/commands/queue/job_params.py +163 -0
  179. mcp_proxy_adapter/commands/queue/jobs/__init__.py +41 -0
  180. mcp_proxy_adapter/commands/queue/jobs/basic_jobs.py +205 -0
  181. mcp_proxy_adapter/commands/queue/jobs/command_execution_job.py +198 -0
  182. mcp_proxy_adapter/commands/queue/jobs/command_restore_base.py +48 -0
  183. mcp_proxy_adapter/commands/queue/jobs/command_run_base.py +389 -0
  184. mcp_proxy_adapter/commands/queue/jobs/job_helpers.py +80 -0
  185. mcp_proxy_adapter/commands/queue/jobs/long_jobs.py +257 -0
  186. mcp_proxy_adapter/commands/queue/list_jobs_command.py +127 -0
  187. mcp_proxy_adapter/commands/queue/start_job_command.py +97 -0
  188. mcp_proxy_adapter/commands/queue/stop_job_command.py +107 -0
  189. mcp_proxy_adapter/commands/queue_commands.py +49 -0
  190. mcp_proxy_adapter/commands/registration_status_command.py +83 -0
  191. mcp_proxy_adapter/commands/reload_command.py +183 -0
  192. mcp_proxy_adapter/commands/result.py +201 -0
  193. mcp_proxy_adapter/commands/result_helpers.py +43 -0
  194. mcp_proxy_adapter/commands/role_test_command.py +119 -0
  195. mcp_proxy_adapter/commands/roles_management_command/__init__.py +58 -0
  196. mcp_proxy_adapter/commands/roles_management_command/actions_part.py +400 -0
  197. mcp_proxy_adapter/commands/roles_management_command/dispatch_part.py +239 -0
  198. mcp_proxy_adapter/commands/roles_management_command/facade.py +233 -0
  199. mcp_proxy_adapter/commands/roles_management_command/part_base.py +61 -0
  200. mcp_proxy_adapter/commands/roles_management_command/results.py +105 -0
  201. mcp_proxy_adapter/commands/roles_management_command/storage_part.py +181 -0
  202. mcp_proxy_adapter/commands/schema_helpers.py +45 -0
  203. mcp_proxy_adapter/commands/settings_command.py +205 -0
  204. mcp_proxy_adapter/commands/transfer_command_support.py +83 -0
  205. mcp_proxy_adapter/commands/transfer_download_begin_command.py +245 -0
  206. mcp_proxy_adapter/commands/transfer_download_status_command.py +121 -0
  207. mcp_proxy_adapter/commands/transfer_schema_support.py +96 -0
  208. mcp_proxy_adapter/commands/transfer_upload_begin_command.py +254 -0
  209. mcp_proxy_adapter/commands/transfer_upload_complete_command.py +161 -0
  210. mcp_proxy_adapter/commands/transfer_upload_status_command.py +122 -0
  211. mcp_proxy_adapter/commands/transport_management_command.py +144 -0
  212. mcp_proxy_adapter/commands/unload_command.py +109 -0
  213. mcp_proxy_adapter/config.py +30 -0
  214. mcp_proxy_adapter/core/__init__.py +8 -0
  215. mcp_proxy_adapter/core/app_factory/__init__.py +17 -0
  216. mcp_proxy_adapter/core/app_factory/app_creator.py +66 -0
  217. mcp_proxy_adapter/core/app_factory/config_loader.py +125 -0
  218. mcp_proxy_adapter/core/app_factory/factory.py +158 -0
  219. mcp_proxy_adapter/core/app_factory/server_runner.py +152 -0
  220. mcp_proxy_adapter/core/app_factory/ssl_config.py +194 -0
  221. mcp_proxy_adapter/core/app_factory/validators.py +57 -0
  222. mcp_proxy_adapter/core/async_context.py +28 -0
  223. mcp_proxy_adapter/core/auth/__init__.py +18 -0
  224. mcp_proxy_adapter/core/auth/certificate_validator.py +239 -0
  225. mcp_proxy_adapter/core/auth/models.py +47 -0
  226. mcp_proxy_adapter/core/auth/mtls_validator.py +84 -0
  227. mcp_proxy_adapter/core/auth/token_validator.py +114 -0
  228. mcp_proxy_adapter/core/auth_validator.py +137 -0
  229. mcp_proxy_adapter/core/certificate/__init__.py +20 -0
  230. mcp_proxy_adapter/core/certificate/certificate_validator/__init__.py +55 -0
  231. mcp_proxy_adapter/core/certificate/certificate_validator/facade.py +340 -0
  232. mcp_proxy_adapter/core/certificate/certificate_validator/info_part.py +130 -0
  233. mcp_proxy_adapter/core/certificate/certificate_validator/key_part.py +146 -0
  234. mcp_proxy_adapter/core/certificate/certificate_validator/part_base.py +65 -0
  235. mcp_proxy_adapter/core/certificate/certificate_validator/revocation_part.py +112 -0
  236. mcp_proxy_adapter/core/client/__init__.py +11 -0
  237. mcp_proxy_adapter/core/client/auth_handler.py +120 -0
  238. mcp_proxy_adapter/core/client/client.py +314 -0
  239. mcp_proxy_adapter/core/client/factory.py +110 -0
  240. mcp_proxy_adapter/core/client/request_handler.py +122 -0
  241. mcp_proxy_adapter/core/client/ssl_handler.py +105 -0
  242. mcp_proxy_adapter/core/client_manager.py +281 -0
  243. mcp_proxy_adapter/core/client_security/__init__.py +53 -0
  244. mcp_proxy_adapter/core/client_security/auth_part.py +227 -0
  245. mcp_proxy_adapter/core/client_security/cert_part.py +124 -0
  246. mcp_proxy_adapter/core/client_security/facade.py +181 -0
  247. mcp_proxy_adapter/core/client_security/part_base.py +62 -0
  248. mcp_proxy_adapter/core/client_security/ssl_part.py +275 -0
  249. mcp_proxy_adapter/core/config/__init__.py +29 -0
  250. mcp_proxy_adapter/core/config/config.py +963 -0
  251. mcp_proxy_adapter/core/config/config_factory.py +16 -0
  252. mcp_proxy_adapter/core/config/config_graph.py +250 -0
  253. mcp_proxy_adapter/core/config/config_loader.py +70 -0
  254. mcp_proxy_adapter/core/config/env_placeholders.py +52 -0
  255. mcp_proxy_adapter/core/config/feature_manager.py +109 -0
  256. mcp_proxy_adapter/core/config/orchestration_section.py +119 -0
  257. mcp_proxy_adapter/core/config/reload_violations.py +269 -0
  258. mcp_proxy_adapter/core/config/section_validators.py +190 -0
  259. mcp_proxy_adapter/core/config/settings_declaration.py +255 -0
  260. mcp_proxy_adapter/core/config/simple_config.py +893 -0
  261. mcp_proxy_adapter/core/config/simple_config_generator.py +917 -0
  262. mcp_proxy_adapter/core/config/simple_config_validator.py +333 -0
  263. mcp_proxy_adapter/core/config/validators/__init__.py +29 -0
  264. mcp_proxy_adapter/core/config/validators/auth_validator.py +146 -0
  265. mcp_proxy_adapter/core/config/validators/base_validator.py +102 -0
  266. mcp_proxy_adapter/core/config/validators/certificate_validator_helper.py +114 -0
  267. mcp_proxy_adapter/core/config/validators/client_validator.py +131 -0
  268. mcp_proxy_adapter/core/config/validators/job_push_validator.py +55 -0
  269. mcp_proxy_adapter/core/config/validators/queue_manager_validator.py +133 -0
  270. mcp_proxy_adapter/core/config/validators/registration_validator.py +366 -0
  271. mcp_proxy_adapter/core/config/validators/server_validation_validator.py +154 -0
  272. mcp_proxy_adapter/core/config/validators/server_validator.py +326 -0
  273. mcp_proxy_adapter/core/config/validators/ssl_validator.py +221 -0
  274. mcp_proxy_adapter/core/config/websocket_validator.py +99 -0
  275. mcp_proxy_adapter/core/config_validator.py +29 -0
  276. mcp_proxy_adapter/core/constants.py +201 -0
  277. mcp_proxy_adapter/core/crl_utils.py +338 -0
  278. mcp_proxy_adapter/core/date_utils.py +119 -0
  279. mcp_proxy_adapter/core/delivery/__init__.py +35 -0
  280. mcp_proxy_adapter/core/delivery/contracts.py +57 -0
  281. mcp_proxy_adapter/core/delivery/exceptions.py +19 -0
  282. mcp_proxy_adapter/core/delivery/terminal_replay_store.py +129 -0
  283. mcp_proxy_adapter/core/delivery/ws_delivery_manager.py +117 -0
  284. mcp_proxy_adapter/core/domain_errors.py +189 -0
  285. mcp_proxy_adapter/core/error_handling.py +98 -0
  286. mcp_proxy_adapter/core/errors/__init__.py +259 -0
  287. mcp_proxy_adapter/core/errors/config_errors.py +142 -0
  288. mcp_proxy_adapter/core/file_utils.py +94 -0
  289. mcp_proxy_adapter/core/job_manager.py +115 -0
  290. mcp_proxy_adapter/core/job_push/__init__.py +124 -0
  291. mcp_proxy_adapter/core/job_push/caller_loss.py +89 -0
  292. mcp_proxy_adapter/core/job_push/engine.py +282 -0
  293. mcp_proxy_adapter/core/job_push/events/__init__.py +111 -0
  294. mcp_proxy_adapter/core/job_push/events/builders.py +282 -0
  295. mcp_proxy_adapter/core/job_push/events/command_session_payloads.py +50 -0
  296. mcp_proxy_adapter/core/job_push/events/delivery_payloads.py +52 -0
  297. mcp_proxy_adapter/core/job_push/events/event_names.py +163 -0
  298. mcp_proxy_adapter/core/job_push/events/job_payloads.py +83 -0
  299. mcp_proxy_adapter/core/job_push/events/transfer_payloads.py +72 -0
  300. mcp_proxy_adapter/core/job_push/execute_async_deliver_guard.py +55 -0
  301. mcp_proxy_adapter/core/job_push/finish_signal.py +91 -0
  302. mcp_proxy_adapter/core/job_push/hooks.py +53 -0
  303. mcp_proxy_adapter/core/job_push/job_status_accumulator.py +376 -0
  304. mcp_proxy_adapter/core/job_push/lifespan_wiring.py +252 -0
  305. mcp_proxy_adapter/core/job_push/notifier.py +139 -0
  306. mcp_proxy_adapter/core/job_push/notifier_policy.py +38 -0
  307. mcp_proxy_adapter/core/job_push/queue_custom_push.py +67 -0
  308. mcp_proxy_adapter/core/job_push/subscriptions.py +160 -0
  309. mcp_proxy_adapter/core/job_push/transfer_correlation.py +47 -0
  310. mcp_proxy_adapter/core/job_push/transfer_push.py +135 -0
  311. mcp_proxy_adapter/core/json_utils.py +81 -0
  312. mcp_proxy_adapter/core/logging/__init__.py +42 -0
  313. mcp_proxy_adapter/core/logging/formatters.py +55 -0
  314. mcp_proxy_adapter/core/logging/global_logger.py +41 -0
  315. mcp_proxy_adapter/core/logging/request_logger.py +50 -0
  316. mcp_proxy_adapter/core/logging/setup.py +190 -0
  317. mcp_proxy_adapter/core/logging/worker.py +107 -0
  318. mcp_proxy_adapter/core/mtls_asgi_app.py +216 -0
  319. mcp_proxy_adapter/core/mtls_server.py +180 -0
  320. mcp_proxy_adapter/core/orchestration/__init__.py +90 -0
  321. mcp_proxy_adapter/core/orchestration/candidate_validator.py +196 -0
  322. mcp_proxy_adapter/core/orchestration/catalog_builder.py +136 -0
  323. mcp_proxy_adapter/core/orchestration/catalog_snapshot.py +115 -0
  324. mcp_proxy_adapter/core/orchestration/command_record.py +43 -0
  325. mcp_proxy_adapter/core/orchestration/discovery_client.py +229 -0
  326. mcp_proxy_adapter/core/orchestration/orchestration_api.py +273 -0
  327. mcp_proxy_adapter/core/orchestration/orchestration_config.py +146 -0
  328. mcp_proxy_adapter/core/orchestration/orchestration_errors.py +305 -0
  329. mcp_proxy_adapter/core/orchestration/orchestration_lifespan.py +199 -0
  330. mcp_proxy_adapter/core/orchestration/parameter_graph.py +106 -0
  331. mcp_proxy_adapter/core/orchestration/polling_loop.py +281 -0
  332. mcp_proxy_adapter/core/orchestration/server_record.py +37 -0
  333. mcp_proxy_adapter/core/orchestration/snapshot_holder.py +90 -0
  334. mcp_proxy_adapter/core/orchestration/tool_context_exposure.py +83 -0
  335. mcp_proxy_adapter/core/orchestration/tool_context_snapshot.py +164 -0
  336. mcp_proxy_adapter/core/path_utils.py +220 -0
  337. mcp_proxy_adapter/core/protocol_manager.py +260 -0
  338. mcp_proxy_adapter/core/proxy/__init__.py +62 -0
  339. mcp_proxy_adapter/core/proxy/auth_manager.py +110 -0
  340. mcp_proxy_adapter/core/proxy_client.py +252 -0
  341. mcp_proxy_adapter/core/proxy_registration.py +55 -0
  342. mcp_proxy_adapter/core/role_utils.py +166 -0
  343. mcp_proxy_adapter/core/server_adapter.py +302 -0
  344. mcp_proxy_adapter/core/server_engine.py +384 -0
  345. mcp_proxy_adapter/core/settings.py +299 -0
  346. mcp_proxy_adapter/core/signal_handler.py +136 -0
  347. mcp_proxy_adapter/core/ssl_utils.py +482 -0
  348. mcp_proxy_adapter/core/transport_manager.py +168 -0
  349. mcp_proxy_adapter/core/utils.py +74 -0
  350. mcp_proxy_adapter/core/validation/__init__.py +21 -0
  351. mcp_proxy_adapter/core/validation/config_validator.py +256 -0
  352. mcp_proxy_adapter/core/validation/file_validator.py +229 -0
  353. mcp_proxy_adapter/core/validation/protocol_validator.py +322 -0
  354. mcp_proxy_adapter/core/validation/proxy_registration_validator.py +268 -0
  355. mcp_proxy_adapter/core/validation/security_validator.py +300 -0
  356. mcp_proxy_adapter/core/validation/validation_result.py +34 -0
  357. mcp_proxy_adapter/core/validation/validator_support.py +64 -0
  358. mcp_proxy_adapter/core/validation_utils.py +160 -0
  359. mcp_proxy_adapter/core/ws_timeouts.py +88 -0
  360. mcp_proxy_adapter/custom_openapi.py +93 -0
  361. mcp_proxy_adapter/examples/PROTOCOL_EXAMPLES.md +79 -0
  362. mcp_proxy_adapter/examples/README.md +272 -0
  363. mcp_proxy_adapter/examples/README_EN.md +258 -0
  364. mcp_proxy_adapter/examples/SECURITY_TESTING.md +455 -0
  365. mcp_proxy_adapter/examples/__init__.py +16 -0
  366. mcp_proxy_adapter/examples/basic_framework/__init__.py +9 -0
  367. mcp_proxy_adapter/examples/basic_framework/commands/__init__.py +4 -0
  368. mcp_proxy_adapter/examples/basic_framework/configs/http_auth.json +21 -0
  369. mcp_proxy_adapter/examples/basic_framework/configs/http_simple.json +21 -0
  370. mcp_proxy_adapter/examples/basic_framework/configs/https_auth.json +21 -0
  371. mcp_proxy_adapter/examples/basic_framework/configs/https_no_protocol_middleware.json +21 -0
  372. mcp_proxy_adapter/examples/basic_framework/configs/https_simple.json +21 -0
  373. mcp_proxy_adapter/examples/basic_framework/configs/mtls_no_protocol_middleware.json +21 -0
  374. mcp_proxy_adapter/examples/basic_framework/configs/mtls_no_roles.json +21 -0
  375. mcp_proxy_adapter/examples/basic_framework/configs/mtls_simple.json +21 -0
  376. mcp_proxy_adapter/examples/basic_framework/configs/mtls_with_registration.json +73 -0
  377. mcp_proxy_adapter/examples/basic_framework/configs/mtls_with_roles.json +21 -0
  378. mcp_proxy_adapter/examples/basic_framework/hooks/__init__.py +4 -0
  379. mcp_proxy_adapter/examples/basic_framework/main.py +123 -0
  380. mcp_proxy_adapter/examples/basic_framework/roles.json +1 -0
  381. mcp_proxy_adapter/examples/bug_report_security_framework.md +141 -0
  382. mcp_proxy_adapter/examples/cert_config.json +1 -0
  383. mcp_proxy_adapter/examples/certs/cert_config.json +1 -0
  384. mcp_proxy_adapter/examples/check_config.py +71 -0
  385. mcp_proxy_adapter/examples/check_config_split_parts/__init__.py +3 -0
  386. mcp_proxy_adapter/examples/check_config_split_parts/checker.py +247 -0
  387. mcp_proxy_adapter/examples/check_config_split_parts/cli.py +68 -0
  388. mcp_proxy_adapter/examples/check_config_split_parts/commands.py +102 -0
  389. mcp_proxy_adapter/examples/cli_config_examples/__init__.py +8 -0
  390. mcp_proxy_adapter/examples/cli_config_examples/examples_configs/http.json +69 -0
  391. mcp_proxy_adapter/examples/cli_config_examples/examples_configs/https_token_roles.json +84 -0
  392. mcp_proxy_adapter/examples/cli_config_examples/examples_configs/mtls_roles.json +84 -0
  393. mcp_proxy_adapter/examples/cli_config_examples/http_basic.py +97 -0
  394. mcp_proxy_adapter/examples/cli_config_examples/https_token.py +128 -0
  395. mcp_proxy_adapter/examples/cli_config_examples/mtls_roles.py +140 -0
  396. mcp_proxy_adapter/examples/client_configs/api_key_client.json +1 -0
  397. mcp_proxy_adapter/examples/client_configs/basic_auth_client.json +1 -0
  398. mcp_proxy_adapter/examples/client_configs/certificate_client.json +1 -0
  399. mcp_proxy_adapter/examples/client_configs/jwt_client.json +1 -0
  400. mcp_proxy_adapter/examples/client_configs/no_auth_client.json +1 -0
  401. mcp_proxy_adapter/examples/client_usage_example.py +216 -0
  402. mcp_proxy_adapter/examples/commands/__init__.py +5 -0
  403. mcp_proxy_adapter/examples/comprehensive/__init__.py +10 -0
  404. mcp_proxy_adapter/examples/comprehensive/run.py +906 -0
  405. mcp_proxy_adapter/examples/comprehensive_config.json +10 -0
  406. mcp_proxy_adapter/examples/config.json +10 -0
  407. mcp_proxy_adapter/examples/config_builder.py +272 -0
  408. mcp_proxy_adapter/examples/config_cli.py +340 -0
  409. mcp_proxy_adapter/examples/config_factory.py +325 -0
  410. mcp_proxy_adapter/examples/configs/full_featured.json +10 -0
  411. mcp_proxy_adapter/examples/configs/http_auth.json +10 -0
  412. mcp_proxy_adapter/examples/configs/http_simple.json +10 -0
  413. mcp_proxy_adapter/examples/configs/http_token.json +10 -0
  414. mcp_proxy_adapter/examples/configs/https_auth.json +10 -0
  415. mcp_proxy_adapter/examples/configs/https_simple.json +10 -0
  416. mcp_proxy_adapter/examples/configs/https_token.json +10 -0
  417. mcp_proxy_adapter/examples/configs/mtls_no_roles.json +10 -0
  418. mcp_proxy_adapter/examples/configs/mtls_simple.json +10 -0
  419. mcp_proxy_adapter/examples/configs/mtls_with_proxy.json +10 -0
  420. mcp_proxy_adapter/examples/configs/mtls_with_roles.json +10 -0
  421. mcp_proxy_adapter/examples/configs/roles.json +1 -0
  422. mcp_proxy_adapter/examples/create_test_configs.py +216 -0
  423. mcp_proxy_adapter/examples/debug_role_chain.py +192 -0
  424. mcp_proxy_adapter/examples/demo_client.py +339 -0
  425. mcp_proxy_adapter/examples/examples_correct/http_example.json +10 -0
  426. mcp_proxy_adapter/examples/full_application/__init__.py +11 -0
  427. mcp_proxy_adapter/examples/full_application/commands/__init__.py +32 -0
  428. mcp_proxy_adapter/examples/full_application/commands/custom_echo_command.py +75 -0
  429. mcp_proxy_adapter/examples/full_application/commands/dynamic_calculator_command.py +101 -0
  430. mcp_proxy_adapter/examples/full_application/commands/embed_job_status_command.py +133 -0
  431. mcp_proxy_adapter/examples/full_application/commands/embed_queue_command.py +153 -0
  432. mcp_proxy_adapter/examples/full_application/commands/long_running_command.py +175 -0
  433. mcp_proxy_adapter/examples/full_application/commands/slow_start_long_task_command.py +172 -0
  434. mcp_proxy_adapter/examples/full_application/configs/http_basic.json +73 -0
  435. mcp_proxy_adapter/examples/full_application/configs/http_basic_smart_assistant_proxy3004.json +67 -0
  436. mcp_proxy_adapter/examples/full_application/configs/http_no_registration.json +72 -0
  437. mcp_proxy_adapter/examples/full_application/configs/http_token.json +69 -0
  438. mcp_proxy_adapter/examples/full_application/configs/http_token_roles.json +81 -0
  439. mcp_proxy_adapter/examples/full_application/configs/http_token_roles_smart_assistant_proxy3004.json +81 -0
  440. mcp_proxy_adapter/examples/full_application/configs/http_token_smart_assistant_proxy3004.json +69 -0
  441. mcp_proxy_adapter/examples/full_application/configs/https_basic.json +74 -0
  442. mcp_proxy_adapter/examples/full_application/configs/https_basic_smart_assistant_proxy3004.json +81 -0
  443. mcp_proxy_adapter/examples/full_application/configs/https_token.json +76 -0
  444. mcp_proxy_adapter/examples/full_application/configs/https_token_roles.json +88 -0
  445. mcp_proxy_adapter/examples/full_application/configs/https_token_roles_smart_assistant_proxy3004.json +95 -0
  446. mcp_proxy_adapter/examples/full_application/configs/https_token_smart_assistant_proxy3004.json +83 -0
  447. mcp_proxy_adapter/examples/full_application/configs/mtls_no_roles.json +78 -0
  448. mcp_proxy_adapter/examples/full_application/configs/mtls_no_roles_correct.json +76 -0
  449. mcp_proxy_adapter/examples/full_application/configs/mtls_no_roles_smart_assistant_proxy3004.json +83 -0
  450. mcp_proxy_adapter/examples/full_application/configs/mtls_no_security.json +77 -0
  451. mcp_proxy_adapter/examples/full_application/configs/mtls_with_roles.json +82 -0
  452. mcp_proxy_adapter/examples/full_application/configs/mtls_with_roles_correct.json +88 -0
  453. mcp_proxy_adapter/examples/full_application/configs/mtls_with_roles_smart_assistant_proxy3004.json +95 -0
  454. mcp_proxy_adapter/examples/full_application/configs/mtls_ws_repro.json +76 -0
  455. mcp_proxy_adapter/examples/full_application/configs/proxy_server.json +64 -0
  456. mcp_proxy_adapter/examples/full_application/configs/proxy_server_https.json +63 -0
  457. mcp_proxy_adapter/examples/full_application/configs/proxy_server_mtls.json +63 -0
  458. mcp_proxy_adapter/examples/full_application/example_support.py +45 -0
  459. mcp_proxy_adapter/examples/full_application/hooks/__init__.py +4 -0
  460. mcp_proxy_adapter/examples/full_application/hooks/application_hooks.py +51 -0
  461. mcp_proxy_adapter/examples/full_application/hooks/builtin_command_hooks.py +46 -0
  462. mcp_proxy_adapter/examples/full_application/main.py +95 -0
  463. mcp_proxy_adapter/examples/full_application/main_modules/__init__.py +1 -0
  464. mcp_proxy_adapter/examples/full_application/main_modules/registration.py +122 -0
  465. mcp_proxy_adapter/examples/full_application/main_modules/runner.py +310 -0
  466. mcp_proxy_adapter/examples/full_application/proxy_commands/__init__.py +113 -0
  467. mcp_proxy_adapter/examples/full_application/proxy_commands/_shared.py +8 -0
  468. mcp_proxy_adapter/examples/full_application/proxy_commands/lifecycle_commands.py +196 -0
  469. mcp_proxy_adapter/examples/full_application/proxy_commands/register_command.py +254 -0
  470. mcp_proxy_adapter/examples/full_application/proxy_commands/registry_state.py +8 -0
  471. mcp_proxy_adapter/examples/full_application/proxy_commands/results.py +142 -0
  472. mcp_proxy_adapter/examples/full_application/proxy_endpoints.py +162 -0
  473. mcp_proxy_adapter/examples/full_application/proxy_schemas.py +91 -0
  474. mcp_proxy_adapter/examples/full_application/roles.json +1 -0
  475. mcp_proxy_adapter/examples/full_application/test_client.py +341 -0
  476. mcp_proxy_adapter/examples/full_application/test_minimal_server.py +57 -0
  477. mcp_proxy_adapter/examples/full_application/test_queue_and_descriptions.py +283 -0
  478. mcp_proxy_adapter/examples/full_application/test_server.py +221 -0
  479. mcp_proxy_adapter/examples/full_application/test_simple_server.py +141 -0
  480. mcp_proxy_adapter/examples/generate_all_certificates.py +74 -0
  481. mcp_proxy_adapter/examples/generate_config.py +44 -0
  482. mcp_proxy_adapter/examples/generate_config_parts/__init__.py +3 -0
  483. mcp_proxy_adapter/examples/generate_config_parts/builders.py +234 -0
  484. mcp_proxy_adapter/examples/generate_config_parts/cli.py +260 -0
  485. mcp_proxy_adapter/examples/generate_config_parts/outputs.py +137 -0
  486. mcp_proxy_adapter/examples/generator_validator_compatibility_report.md +127 -0
  487. mcp_proxy_adapter/examples/http_proxy_example.json +17 -0
  488. mcp_proxy_adapter/examples/https_proxy_example.json +17 -0
  489. mcp_proxy_adapter/examples/job_tracking_demo.py +235 -0
  490. mcp_proxy_adapter/examples/proxy_server_support.py +384 -0
  491. mcp_proxy_adapter/examples/queue_demo_simple.py +37 -0
  492. mcp_proxy_adapter/examples/queue_demo_simple_parts/__init__.py +3 -0
  493. mcp_proxy_adapter/examples/queue_demo_simple_parts/_shared.py +8 -0
  494. mcp_proxy_adapter/examples/queue_demo_simple_parts/demo.py +213 -0
  495. mcp_proxy_adapter/examples/queue_demo_simple_parts/mock_commands.py +130 -0
  496. mcp_proxy_adapter/examples/queue_demo_simple_parts/mock_manager.py +272 -0
  497. mcp_proxy_adapter/examples/queue_example_support.py +36 -0
  498. mcp_proxy_adapter/examples/queue_fire_and_forget_example.py +370 -0
  499. mcp_proxy_adapter/examples/queue_server_demo.py +73 -0
  500. mcp_proxy_adapter/examples/queue_server_example.py +76 -0
  501. mcp_proxy_adapter/examples/queue_server_simple.py +251 -0
  502. mcp_proxy_adapter/examples/required_certificates.py +216 -0
  503. mcp_proxy_adapter/examples/run_example.py +119 -0
  504. mcp_proxy_adapter/examples/run_full_test_suite.py +674 -0
  505. mcp_proxy_adapter/examples/run_proxy_server.py +118 -0
  506. mcp_proxy_adapter/examples/run_security_tests_fixed.py +876 -0
  507. mcp_proxy_adapter/examples/security_test/__init__.py +18 -0
  508. mcp_proxy_adapter/examples/security_test/auth_manager.py +49 -0
  509. mcp_proxy_adapter/examples/security_test/ssl_context_manager.py +144 -0
  510. mcp_proxy_adapter/examples/security_test/test_client.py +218 -0
  511. mcp_proxy_adapter/examples/security_test/test_result.py +23 -0
  512. mcp_proxy_adapter/examples/security_test_client.py +103 -0
  513. mcp_proxy_adapter/examples/server_configs/config_basic_http.json +16 -0
  514. mcp_proxy_adapter/examples/server_configs/config_http_token.json +16 -0
  515. mcp_proxy_adapter/examples/server_configs/config_https.json +16 -0
  516. mcp_proxy_adapter/examples/server_configs/config_https_token.json +16 -0
  517. mcp_proxy_adapter/examples/server_configs/config_mtls.json +16 -0
  518. mcp_proxy_adapter/examples/server_configs/config_proxy_registration.json +15 -0
  519. mcp_proxy_adapter/examples/server_configs/config_simple.json +9 -0
  520. mcp_proxy_adapter/examples/server_configs/http_simple.json +14 -0
  521. mcp_proxy_adapter/examples/server_configs/http_token.json +14 -0
  522. mcp_proxy_adapter/examples/server_configs/https_simple.json +14 -0
  523. mcp_proxy_adapter/examples/server_configs/https_token.json +14 -0
  524. mcp_proxy_adapter/examples/server_configs/mtls_no_roles.json +8 -0
  525. mcp_proxy_adapter/examples/server_configs/mtls_test.json +8 -0
  526. mcp_proxy_adapter/examples/server_configs/mtls_with_roles.json +14 -0
  527. mcp_proxy_adapter/examples/server_configs/roles.json +1 -0
  528. mcp_proxy_adapter/examples/setup/__init__.py +48 -0
  529. mcp_proxy_adapter/examples/setup/certificate_manager.py +384 -0
  530. mcp_proxy_adapter/examples/setup/config_generator.py +6 -0
  531. mcp_proxy_adapter/examples/setup/config_validator.py +140 -0
  532. mcp_proxy_adapter/examples/setup/environment_setup.py +143 -0
  533. mcp_proxy_adapter/examples/setup/test_files_generator.py +6 -0
  534. mcp_proxy_adapter/examples/setup/test_runner.py +143 -0
  535. mcp_proxy_adapter/examples/setup_test_environment.py +233 -0
  536. mcp_proxy_adapter/examples/simple_http_example.json +17 -0
  537. mcp_proxy_adapter/examples/simple_https_example.json +17 -0
  538. mcp_proxy_adapter/examples/simple_protocol_test.py +167 -0
  539. mcp_proxy_adapter/examples/test_client/README.md +166 -0
  540. mcp_proxy_adapter/examples/test_client/__init__.py +7 -0
  541. mcp_proxy_adapter/examples/test_client/main.py +102 -0
  542. mcp_proxy_adapter/examples/test_client/main_split_parts/__init__.py +1 -0
  543. mcp_proxy_adapter/examples/test_client/main_split_parts/helpers.py +83 -0
  544. mcp_proxy_adapter/examples/test_client/main_split_parts/runner.py +115 -0
  545. mcp_proxy_adapter/examples/test_client/main_split_parts/scenarios.py +195 -0
  546. mcp_proxy_adapter/examples/test_config.py +183 -0
  547. mcp_proxy_adapter/examples/test_configs/custom_https.json +10 -0
  548. mcp_proxy_adapter/examples/test_configs/http_simple.json +10 -0
  549. mcp_proxy_adapter/examples/test_examples.py +361 -0
  550. mcp_proxy_adapter/examples/test_mcp_server.py +249 -0
  551. mcp_proxy_adapter/examples/test_protocol_examples.py +373 -0
  552. mcp_proxy_adapter/examples/test_proxy/README.md +70 -0
  553. mcp_proxy_adapter/examples/test_proxy/__init__.py +7 -0
  554. mcp_proxy_adapter/examples/test_proxy/main.py +106 -0
  555. mcp_proxy_adapter/examples/test_server/README.md +58 -0
  556. mcp_proxy_adapter/examples/test_server/__init__.py +7 -0
  557. mcp_proxy_adapter/examples/test_server/main.py +349 -0
  558. mcp_proxy_adapter/examples/transparent_queue_commands.py +281 -0
  559. mcp_proxy_adapter/examples/transparent_queue_e1_sync_call.py +102 -0
  560. mcp_proxy_adapter/examples/transparent_queue_e2_event_stream.py +134 -0
  561. mcp_proxy_adapter/examples/transparent_queue_e3_ws_timeouts.py +341 -0
  562. mcp_proxy_adapter/examples/transparent_queue_e4_ws_fallback.py +159 -0
  563. mcp_proxy_adapter/examples/transparent_queue_e5_inner_failure.py +189 -0
  564. mcp_proxy_adapter/examples/transparent_queue_e6_atomic_state.py +203 -0
  565. mcp_proxy_adapter/examples/transparent_queue_e7_caller_loss.py +63 -0
  566. mcp_proxy_adapter/examples/transparent_queue_e7_split2/__init__.py +3 -0
  567. mcp_proxy_adapter/examples/transparent_queue_e7_split2/cases.py +335 -0
  568. mcp_proxy_adapter/examples/transparent_queue_e7_split2/helpers.py +66 -0
  569. mcp_proxy_adapter/examples/transparent_queue_support.py +377 -0
  570. mcp_proxy_adapter/examples/unified_error_handling_example.py +127 -0
  571. mcp_proxy_adapter/examples/unified_error_handling_split_parts/__init__.py +3 -0
  572. mcp_proxy_adapter/examples/unified_error_handling_split_parts/demos.py +180 -0
  573. mcp_proxy_adapter/examples/unified_error_handling_split_parts/runner.py +109 -0
  574. mcp_proxy_adapter/examples/unified_error_handling_split_parts/support.py +79 -0
  575. mcp_proxy_adapter/examples/unified_error_handling_texts.py +17 -0
  576. mcp_proxy_adapter/examples/universal_client.py +215 -0
  577. mcp_proxy_adapter/examples/universal_client_split_parts/__init__.py +3 -0
  578. mcp_proxy_adapter/examples/universal_client_split_parts/configs.py +104 -0
  579. mcp_proxy_adapter/examples/universal_client_split_parts/demos.py +144 -0
  580. mcp_proxy_adapter/examples/update_config_certificates.py +156 -0
  581. mcp_proxy_adapter/examples/validate_generator_compatibility_simple.py +60 -0
  582. mcp_proxy_adapter/examples/websocket_examples/__init__.py +8 -0
  583. mcp_proxy_adapter/examples/websocket_examples/client_bidirectional_websocket.py +100 -0
  584. mcp_proxy_adapter/examples/websocket_examples/client_websocket_job_status.py +103 -0
  585. mcp_proxy_adapter/examples/websocket_examples/run_ws_test_server.py +157 -0
  586. mcp_proxy_adapter/examples/ws_examples/__init__.py +6 -0
  587. mcp_proxy_adapter/examples/ws_examples/http_basic_ws.py +68 -0
  588. mcp_proxy_adapter/examples/ws_examples/http_token_roles_ws.py +66 -0
  589. mcp_proxy_adapter/examples/ws_examples/http_token_ws.py +80 -0
  590. mcp_proxy_adapter/examples/ws_examples/https_basic_ws.py +61 -0
  591. mcp_proxy_adapter/examples/ws_examples/https_token_roles_ws.py +67 -0
  592. mcp_proxy_adapter/examples/ws_examples/https_token_ws.py +64 -0
  593. mcp_proxy_adapter/examples/ws_examples/mtls_basic_ws.py +94 -0
  594. mcp_proxy_adapter/examples/ws_examples/mtls_roles_ws.py +88 -0
  595. mcp_proxy_adapter/examples/ws_examples/ws_example_runner.py +233 -0
  596. mcp_proxy_adapter/integrations/__init__.py +31 -0
  597. mcp_proxy_adapter/integrations/queuemgr_integration/__init__.py +124 -0
  598. mcp_proxy_adapter/integrations/queuemgr_integration/_compat.py +60 -0
  599. mcp_proxy_adapter/integrations/queuemgr_integration/_health.py +299 -0
  600. mcp_proxy_adapter/integrations/queuemgr_integration/_limits.py +70 -0
  601. mcp_proxy_adapter/integrations/queuemgr_integration/_process_reap.py +232 -0
  602. mcp_proxy_adapter/integrations/queuemgr_integration/_result_builders.py +119 -0
  603. mcp_proxy_adapter/integrations/queuemgr_integration/_status_helpers.py +167 -0
  604. mcp_proxy_adapter/integrations/queuemgr_integration/global_manager.py +174 -0
  605. mcp_proxy_adapter/integrations/queuemgr_integration/job_types/__init__.py +375 -0
  606. mcp_proxy_adapter/integrations/queuemgr_integration/job_types/value_types.py +97 -0
  607. mcp_proxy_adapter/integrations/queuemgr_integration/job_types/worker_probe.py +29 -0
  608. mcp_proxy_adapter/integrations/queuemgr_integration/manager/__init__.py +52 -0
  609. mcp_proxy_adapter/integrations/queuemgr_integration/manager/fallback_base.py +240 -0
  610. mcp_proxy_adapter/integrations/queuemgr_integration/manager/fallback_stop_base.py +179 -0
  611. mcp_proxy_adapter/integrations/queuemgr_integration/manager/health_base.py +460 -0
  612. mcp_proxy_adapter/integrations/queuemgr_integration/manager/integration.py +189 -0
  613. mcp_proxy_adapter/integrations/queuemgr_integration/manager/job_start_base.py +333 -0
  614. mcp_proxy_adapter/integrations/queuemgr_integration/manager/job_stop_base.py +274 -0
  615. mcp_proxy_adapter/integrations/queuemgr_integration/manager/lifecycle_base.py +393 -0
  616. mcp_proxy_adapter/integrations/queuemgr_integration/manager/query_base.py +269 -0
  617. mcp_proxy_adapter/integrations/queuemgr_registration.py +66 -0
  618. mcp_proxy_adapter/integrations/queuemgr_version.py +39 -0
  619. mcp_proxy_adapter/main.py +385 -0
  620. mcp_proxy_adapter/main_ssl_paths.py +29 -0
  621. mcp_proxy_adapter/py.typed +0 -0
  622. mcp_proxy_adapter/schemas/base_schema.json +114 -0
  623. mcp_proxy_adapter/schemas/openapi_schema.json +269 -0
  624. mcp_proxy_adapter/schemas/roles.json +37 -0
  625. mcp_proxy_adapter/schemas/roles_schema.json +162 -0
  626. mcp_proxy_adapter/transfer/__init__.py +56 -0
  627. mcp_proxy_adapter/transfer/checksums.py +81 -0
  628. mcp_proxy_adapter/transfer/client_downloader/__init__.py +37 -0
  629. mcp_proxy_adapter/transfer/client_downloader/download_support.py +109 -0
  630. mcp_proxy_adapter/transfer/client_downloader/downloader.py +300 -0
  631. mcp_proxy_adapter/transfer/client_uploader.py +278 -0
  632. mcp_proxy_adapter/transfer/compression.py +127 -0
  633. mcp_proxy_adapter/transfer/errors.py +253 -0
  634. mcp_proxy_adapter/transfer/json_coerce.py +32 -0
  635. mcp_proxy_adapter/transfer/models.py +337 -0
  636. mcp_proxy_adapter/transfer/path_confinement.py +69 -0
  637. mcp_proxy_adapter/transfer/progress_percent.py +25 -0
  638. mcp_proxy_adapter/transfer/server_store.py +878 -0
  639. mcp_proxy_adapter/version.py +8 -0
  640. mcp_proxy_adapter_dev-8.11.16.dist-info/METADATA +1666 -0
  641. mcp_proxy_adapter_dev-8.11.16.dist-info/RECORD +644 -0
  642. mcp_proxy_adapter_dev-8.11.16.dist-info/WHEEL +5 -0
  643. mcp_proxy_adapter_dev-8.11.16.dist-info/entry_points.txt +12 -0
  644. 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