mcp-proxy-adapter 6.1.1__py3-none-any.whl → 6.2.1__py3-none-any.whl

mcp_proxy_adapter-6.2.1.dist-info/RECORD

@@ -0,0 +1,119 @@
+mcp_proxy_adapter/__init__.py,sha256=B7m1YWyv_Wb87-Q-JqVpHQgwajnfIgDyZ_iIxzdTbBY,1021
+mcp_proxy_adapter/__main__.py,sha256=jxXP9WnXJvuIlurBnTCu3dt9jL-K1wA6VfPnjdGatg0,768
+mcp_proxy_adapter/config.py,sha256=z4rUbJdxYj6vYw05OM_kMXs1Qn2HRQXGHI9PB4hgPd4,12867
+mcp_proxy_adapter/custom_openapi.py,sha256=jYUrCy8C1mShh3sjKj-JkzSMLAvxDLTvtzSJFj5HUNg,15023
+mcp_proxy_adapter/main.py,sha256=_DJwMZdN0393UR-U7xfQh59EpbDDgv1oWPFf-v2MoII,2147
+mcp_proxy_adapter/openapi.py,sha256=36vOEbJjGnVZR6hUhl6mHCD29HYOEFKo2bL0JdGSm-4,13952
+mcp_proxy_adapter/version.py,sha256=7alALj2xnhN0mIeNQ1R7XRGv1R6iGUjP4UWziMB1Kys,75
+mcp_proxy_adapter/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_proxy_adapter/api/app.py,sha256=pYrsDWhZAYoYbxujD0MGeOWdTnBUGueIGmZqeAbaB9A,27884
+mcp_proxy_adapter/api/handlers.py,sha256=DcZT7MVBV33q-0EJ0iFqxE0VgBkFt6d_SqoRkntwyvc,8477
+mcp_proxy_adapter/api/schemas.py,sha256=xOmiSwHaapY6myEFnLu7o-LWVPM7vwmLYZXFo2c6NfE,12381
+mcp_proxy_adapter/api/tool_integration.py,sha256=MrtX7vUXCGBBuZuOs3C6EF67R_U_0xMfOmlmsAz-wuE,10245
+mcp_proxy_adapter/api/tools.py,sha256=rRCRN2I8Odd2biBJZKByQS15rAWf0XwLRZEHDELc7Tg,8116
+mcp_proxy_adapter/api/middleware/__init__.py,sha256=f3bUYU6iaPsVe1acsRHip0RgLhX3X2qjKWzgO-Ej998,2131
+mcp_proxy_adapter/api/middleware/base.py,sha256=aMV9YPLHkUnJECuQWYbnlEGaj6xUJFHZR_hJb0OKvu8,2282
+mcp_proxy_adapter/api/middleware/command_permission_middleware.py,sha256=sSdHTZ-ZxtcV3fJmcweB3sqlQivrYO_FO0H835jnPFA,5076
+mcp_proxy_adapter/api/middleware/error_handling.py,sha256=avIZTjXj1sNOT3ekKtLAYJKM7V4duX0BF9PW-j18dEY,7134
+mcp_proxy_adapter/api/middleware/factory.py,sha256=yDo7f4E-YL7qQZgGApyk8HZfLYOnrpsNx-Eh3fJBikE,8404
+mcp_proxy_adapter/api/middleware/logging.py,sha256=VvUUX7bN4davCzFO6GYbN1O4sgJjOspV-EBLE3xpwpc,4730
+mcp_proxy_adapter/api/middleware/performance.py,sha256=dHBxTF43LEGXMKHMH3A8ybKmwAWURd_zswqq_oC4xbw,2454
+mcp_proxy_adapter/api/middleware/protocol_middleware.py,sha256=RwXBew04AatChvcmyuOOPCOkyJ2_RwCpnZWbKKn4XPM,5547
+mcp_proxy_adapter/api/middleware/transport_middleware.py,sha256=Esy2gGKpEV5RoUTilr1YKKTDc5jh5RxsomD0VXyR2pE,4396
+mcp_proxy_adapter/api/middleware/unified_security.py,sha256=32BWiQaFyWgEgdIlj-La_4GUgD180zB4jh1O7-DkHDE,5377
+mcp_proxy_adapter/api/middleware/user_info_middleware.py,sha256=dQJWroIihEa5aZmrzrNAYE189K1Uy9OJyeOa9XpWaJk,2682
+mcp_proxy_adapter/commands/__init__.py,sha256=r791wg4FKhWSi5rqA3vekDcGf5kr18pwF1woX-dnZKo,1525
+mcp_proxy_adapter/commands/auth_validation_command.py,sha256=z612WJDVgZwaCrxdQhATwRc5i3qxH37MPuIV6SuZPn8,15083
+mcp_proxy_adapter/commands/base.py,sha256=tunyrmt-LYJMQZslAZQor3KZvOrn1IYNpL5uOAnSdxc,15791
+mcp_proxy_adapter/commands/builtin_commands.py,sha256=oloxk0itnY4Uy1a3ARXqHPm48RqkHxBbHqzXZ4bUGN8,3258
+mcp_proxy_adapter/commands/catalog_manager.py,sha256=FVyF2Ky8DUmvFxjiem3YeC9ASFOzCZ9Lp2MsNobA1wI,34712
+mcp_proxy_adapter/commands/cert_monitor_command.py,sha256=JWitmmHDeooWXt2fWLbcfAHDeHpsTL2AuBaoka7OWNE,24485
+mcp_proxy_adapter/commands/certificate_management_command.py,sha256=4byTb1yCqTQCbNH_L4p_z3HithuugzI3a-H9gjiLDhg,24440
+mcp_proxy_adapter/commands/command_registry.py,sha256=mPNhLnJ4L1lSyVzYXpUjeCBJkWIqEtlzpr9JcprHIf4,35260
+mcp_proxy_adapter/commands/config_command.py,sha256=-Z6BGaEQTf859l56zZpHYBeZFeIVdpMYybDrd7LOPIg,3553
+mcp_proxy_adapter/commands/dependency_container.py,sha256=Uz9OPRAUZN7tsVrMVgXgPQcsRD2N-e2Ixg9XarPOlnY,3410
+mcp_proxy_adapter/commands/dependency_manager.py,sha256=lmY79MBkh-JRIPsYxSkdrUE9XHi4XBCbucaEMT0w6do,7683
+mcp_proxy_adapter/commands/echo_command.py,sha256=R1oDNEAJSOIuODa4Nk3z4WJXhSxniNzaZtYHADlV310,2390
+mcp_proxy_adapter/commands/health_command.py,sha256=uo6iND710oSUHEZm6ueT0TsKXRJKFbxUiVeSK57SBlE,4575
+mcp_proxy_adapter/commands/help_command.py,sha256=PuanwvYmVs64DhB71gaI5rBRi_ozJ6x8afr18bRpTk4,13482
+mcp_proxy_adapter/commands/hooks.py,sha256=Gu5TDSgA9EBHexWMWze8wgT63i6-dMEEwG8edWbrX3U,10060
+mcp_proxy_adapter/commands/key_management_command.py,sha256=qin-iYXksIXOkZEfmJpclJSOyKaz9qRinj9uVa8hkdk,19339
+mcp_proxy_adapter/commands/load_command.py,sha256=2zwPOCSBck6mr5KehyyH8lPRAqYYGeUeIIJdbxMSoZk,5984
+mcp_proxy_adapter/commands/plugins_command.py,sha256=Te6YQH0ukJWIHAAEJE5DmdAilpjO1QMDa_PexhfQLH0,8531
+mcp_proxy_adapter/commands/protocol_management_command.py,sha256=XSrNPGagopM4SinrSmNFW12KLng7-Oc9q6NpiInJ-QI,8485
+mcp_proxy_adapter/commands/proxy_registration_command.py,sha256=yqPKgpv8oPP9mn1Blo-2VRVoWUpMcMJ29stqy2Di7hk,15394
+mcp_proxy_adapter/commands/reload_command.py,sha256=6yJduQlIgXhtDSH4Q8qmfR8wZW1RVC1WT1eBIpxzCNo,7507
+mcp_proxy_adapter/commands/result.py,sha256=9iFyoRRZ17q3d822XTMNyqnBvWypyoyV0NiHtM2bCd4,5604
+mcp_proxy_adapter/commands/role_test_command.py,sha256=Hr45vB3W8tg_GQ4FfKOEOxW10eEb-pApo2nOPjru61M,4281
+mcp_proxy_adapter/commands/roles_management_command.py,sha256=JSMkW9-Hq9ncltUvBjolQdvSeTa1FY2hoU0oD2mBon4,22471
+mcp_proxy_adapter/commands/security_command.py,sha256=zKTVtb8vL_DafRHtrLqC2Mhk_DjOQ-3YwhIUh8NXJfQ,18206
+mcp_proxy_adapter/commands/settings_command.py,sha256=hTBrFRABJDFYwnDf2ryfqoejUe06fM4XMOoiH0Exdyo,6407
+mcp_proxy_adapter/commands/ssl_setup_command.py,sha256=wCWF7VhAB21m1FF7uR7r1mG1uLu6bFkfTfpHINM7LGI,13101
+mcp_proxy_adapter/commands/token_management_command.py,sha256=7sl_fRUjWMRuP7NXoLjpLTB9wEg_aZU9dp5Ji9hbThA,18147
+mcp_proxy_adapter/commands/transport_management_command.py,sha256=yv2lqUqJliYGIbYW7t0HQTrt5Cu2Y02rUjVzdznLtPk,4692
+mcp_proxy_adapter/commands/unload_command.py,sha256=mhRZ23sJtTwUfWkjZzH8KDRpwxUX0kdu8LbAXAURRJc,5079
+mcp_proxy_adapter/core/__init__.py,sha256=Ch50cV5Nd8m-HO9rMnVModajjwDK-OdUy7hxISDFkAM,800
+mcp_proxy_adapter/core/app_factory.py,sha256=Xwyz40GNOWWa7ThArweawNBY4WI4bEI3_cj251mLHCM,17797
+mcp_proxy_adapter/core/app_runner.py,sha256=JPpx9rKmaHAVdFnHRl2rXycptQkTSQ13Er7Qf1KZIA4,10614
+mcp_proxy_adapter/core/auth_validator.py,sha256=lJxBVkoQWSk5CNtnPYMEJSsz4FhcXK-gB5QJ_OP9jEE,20937
+mcp_proxy_adapter/core/certificate_utils.py,sha256=7VOhjRcygCToYgPTUt_MgcNILdpRBRBNZSFpeS_QrfA,39541
+mcp_proxy_adapter/core/client.py,sha256=YxtaHvMoqKcjWJ-2mf2FH22wUGWUZjXMEKPqxypNOPE,21340
+mcp_proxy_adapter/core/client_manager.py,sha256=sKEhapMpogqb54WIWEpz2bMjrX3wvYooX-a844IfCTU,9164
+mcp_proxy_adapter/core/client_security.py,sha256=8isHpvv-7H85QzI8K3Pfyr_KdvpE2xYyIT4wqWrttNU,13575
+mcp_proxy_adapter/core/config_converter.py,sha256=FAA2zx-yRgqMgzg73o9Aq5CEEfodNCeaA8Yluto4wAs,16985
+mcp_proxy_adapter/core/config_validator.py,sha256=qDVmkRatuDeWylIPLjMq02Vpzff6DDTE_CstpzqGi7o,7773
+mcp_proxy_adapter/core/errors.py,sha256=s34OxiIR4NCJu_pYSigKXqrIvRjUUK2OWw0X4dpDjIA,5151
+mcp_proxy_adapter/core/logging.py,sha256=jQlFz52Xwapef6UD4p0acmaGFumD9XuexwW4frDN_ZM,9626
+mcp_proxy_adapter/core/mtls_asgi.py,sha256=X2lAj3wk3L85amRCp_-10sqvZa5wJf_diXhwrrQReSo,5311
+mcp_proxy_adapter/core/mtls_asgi_app.py,sha256=VeolP08TTaqYU5fGeaZexj6EBWBDugoVrEGXzJW4PuM,6406
+mcp_proxy_adapter/core/protocol_manager.py,sha256=a3-JiCWLDUejg0MAdfmi5xQ5TZrCMqLfV1tKVUiRe38,13174
+mcp_proxy_adapter/core/proxy_client.py,sha256=shP373Yelz7Fja22U6XnH0kT9XtPtWEFwOFlYFO97gw,22511
+mcp_proxy_adapter/core/proxy_registration.py,sha256=87ko1vw61nHJGo0-xrObXiyQhrYK2K6nKr8rXID-j8c,19424
+mcp_proxy_adapter/core/role_utils.py,sha256=wMoTVz3gF5fM7jozNMwsEwPkp1tui26M-t_KH1Oz8gs,12880
+mcp_proxy_adapter/core/security_adapter.py,sha256=wZ3OH1WzhUdpN8N8CrGJSFFVNi474DqdazIqQ1T8PN4,13343
+mcp_proxy_adapter/core/security_factory.py,sha256=4r7qvBq30XfosGD_b1ZHyNVLN8rOQ3NAKuaCOCEK8jA,8262
+mcp_proxy_adapter/core/security_integration.py,sha256=yAAgL9Y7-VUMPhOLbDpBT2rRHDmmUWv1xolBrxbX29o,13601
+mcp_proxy_adapter/core/server_adapter.py,sha256=8dhUlLxuYjaoNgMHieFCFgDRjxskP--Y5uoAhbN6RLw,9823
+mcp_proxy_adapter/core/server_engine.py,sha256=SFENSDrVMlBD--HgKSRVklhrtLKSRSZhs_3UHxFCGbg,9540
+mcp_proxy_adapter/core/settings.py,sha256=ZfUnmqD1tjAuaQo2VAF8evC1oHUit7gTu4WkTF0IMYI,10628
+mcp_proxy_adapter/core/ssl_utils.py,sha256=_2mhpuoiRpSbUBifnQvtuziQfBRrXQUKtB58ALWTaqU,8220
+mcp_proxy_adapter/core/transport_manager.py,sha256=ppcgjO-7Ulrk1ovlzlXVM89Iw4VOGA3awKgLf7FFAJ0,9518
+mcp_proxy_adapter/core/unified_config_adapter.py,sha256=cpN_VrliIFGDH3JsfRkTlFdQvLcmuMYYedq0QEzlb0Y,22857
+mcp_proxy_adapter/core/utils.py,sha256=ly8Ttg2v1OBukThJLxudRvmttU1hxJFLJUfat4b2dOI,3268
+mcp_proxy_adapter/examples/__init__.py,sha256=vmf512vnxGHNoHQVJOEoLQ3pFZYO2P7Owhf4ot_c7SE,449
+mcp_proxy_adapter/examples/create_certificates_simple.py,sha256=2KS-s3amvAqasvdh-cxY7ARuFAHVjtbtr_EJF2SKVQ0,23221
+mcp_proxy_adapter/examples/debug_request_state.py,sha256=x_H3NIlkmIS6lZimvEM6kCXxGdpgFw99Sdui8qa_qeU,4347
+mcp_proxy_adapter/examples/debug_role_chain.py,sha256=33l2Tk5mrcnwPFwqm2NTHcrWaJrXUU2wxW2I6Y4uIg4,8344
+mcp_proxy_adapter/examples/demo_client.py,sha256=inic-FP5qG8oQXUaCrtEhmhac_PDZ1pcxp-M1cxSzwA,10240
+mcp_proxy_adapter/examples/generate_all_certificates.py,sha256=rgcwqIkQ1eDfEIRFRXGIOz-jOSS1w0GPBRhYvMl6Vjc,16948
+mcp_proxy_adapter/examples/generate_certificates.py,sha256=KxsltDvO_qpN0MsRv6mCSog-gcEtI18ECyNzpNbKBVw,3672
+mcp_proxy_adapter/examples/generate_certificates_and_tokens.py,sha256=J0qHm_BMY8RYqfuwf7V7xKsHcsRJx8E7x-8JxmW5sPw,15988
+mcp_proxy_adapter/examples/generate_test_configs.py,sha256=RoasOwO1B6gFaP4b6PjFTKsLSX_saBDhrgNbarpTufI,7648
+mcp_proxy_adapter/examples/proxy_registration_example.py,sha256=g59_QG2D1CCqhIXEvgy2XmgXI3toLmLyH7hL3uHZwC8,12647
+mcp_proxy_adapter/examples/run_example.py,sha256=o8rcy9Xo0UuZG4MpKdex3pFWYdtAi6uW8dEBQE6Yzbw,2539
+mcp_proxy_adapter/examples/run_security_tests.py,sha256=xUzsOwKEblZrPFFc-DDfQnWfID9nqGsCvb5VnHtVsT0,10703
+mcp_proxy_adapter/examples/run_security_tests_fixed.py,sha256=fNQsbALf9548xJ0OGPKYx5Crzg1GbcL8CSh1x_oKu_A,10540
+mcp_proxy_adapter/examples/security_test_client.py,sha256=eBy6pZ5Dhdo-qi_7Fk-IWGHq7zAJA-om8RBuOep4XSs,28022
+mcp_proxy_adapter/examples/setup_test_environment.py,sha256=erLnM5X4ys4wRl3u0wrnPJsy2luUPMfqxoyk6OZGNCU,7953
+mcp_proxy_adapter/examples/test_config.py,sha256=1X9X8lNlWOcM1ZbIzteeMvLdgxnJEK_ev1BYTZiA9ws,6451
+mcp_proxy_adapter/examples/test_config_generator.py,sha256=SBKL0bv-kUwUUbwrFVbxuA_6pDvK2573Jxm9wPiyI8s,3927
+mcp_proxy_adapter/examples/test_examples.py,sha256=KH095FFEQDMKYZglclr5qy3cW__t3H8VX1l8dvCkQos,12132
+mcp_proxy_adapter/examples/universal_client.py,sha256=IIKGRa0__KoWVla3VnVl-RjkkG_nPpM8vglPm70pV9c,26948
+mcp_proxy_adapter/examples/basic_framework/__init__.py,sha256=XtgxpS3kKQFLDh4onP9XayNTDPzkaAbP0ExkTw9BLkk,184
+mcp_proxy_adapter/examples/basic_framework/main.py,sha256=cDmqeUN1lDBBwuwLjmnP3qIyofCZ3Jr5Ct7Im-qCsUU,1728
+mcp_proxy_adapter/examples/basic_framework/commands/__init__.py,sha256=_VQNLUEdsxUG-4yt9BZI_vtOxHAdGG0OUSsP6Wj-Vz4,76
+mcp_proxy_adapter/examples/basic_framework/hooks/__init__.py,sha256=IE_EIXMnkdXuakZn7wLD9kBFyfDF5lYi56ejgiBeb-A,70
+mcp_proxy_adapter/examples/commands/__init__.py,sha256=46FZSOABSeKPffw91JqIWL_UQD_RLL3nAR-ufgb2hr8,169
+mcp_proxy_adapter/examples/full_application/__init__.py,sha256=EYSFAgAt4yfcafTFrfdSw_VwlSh7ec4Yk2sn5Z-cLb8,299
+mcp_proxy_adapter/examples/full_application/main.py,sha256=Odw6pdjJkuJd5IhfwLDaRM11YH8Y1oQ_JmqPz_UIMGc,7355
+mcp_proxy_adapter/examples/full_application/proxy_endpoints.py,sha256=-cpb0nIjzp6OltFHoZqrtFvb4wJf1dgT4WvQ2dcY6Bo,6045
+mcp_proxy_adapter/examples/full_application/commands/__init__.py,sha256=yQHxVSFkAyFLUOdk42QOebUODPlQV9IbydPgF3UKsGM,217
+mcp_proxy_adapter/examples/full_application/commands/custom_echo_command.py,sha256=u9_XOkoHkiFC-tn9B-yGUXfQi9OL0EDxlVVKSERI1wA,3099
+mcp_proxy_adapter/examples/full_application/commands/dynamic_calculator_command.py,sha256=fRWtegpUUVt4wWOz3yE3spMG4h1DM_xbSxg_WqlnbF0,3491
+mcp_proxy_adapter/examples/full_application/hooks/__init__.py,sha256=ORG4cL8cSXEMmZ0CEPz75OVuwg54pdDm2GIBpP4dtcs,200
+mcp_proxy_adapter/examples/full_application/hooks/application_hooks.py,sha256=TYXuHI-KW_mH5r8mSKgNMJCr3moeEKrqC4Eex0U298k,3457
+mcp_proxy_adapter/examples/full_application/hooks/builtin_command_hooks.py,sha256=IaskSrckZS6bE3aGxSBL8aTj-iJTSI2ysfsFjhjncyM,2975
+mcp_proxy_adapter-6.2.1.dist-info/METADATA,sha256=XlCYkwOYXSpXiOawdUWc6TV6Bpu8jQDF2_2H-1tx3nE,22047
+mcp_proxy_adapter-6.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mcp_proxy_adapter-6.2.1.dist-info/top_level.txt,sha256=JZT7vPLBYrtroX-ij68JBhJYbjDdghcV-DFySRy-Nnw,18
+mcp_proxy_adapter-6.2.1.dist-info/RECORD,,

mcp_proxy_adapter/docs/EN/TROUBLESHOOTING.md

@@ -1,285 +0,0 @@
-# Troubleshooting Guide
-
-This guide addresses common issues with MCP Proxy Adapter Framework, particularly related to ProtocolMiddleware and SSL/TLS configuration.
-
-## Common Issues
-
-### Issue 1: ProtocolMiddleware blocks HTTPS requests
-
-**Problem:** ProtocolMiddleware is initialized with default settings and doesn't update when SSL configuration changes.
-
-**Symptoms:**
-```
-Protocol 'https' not allowed for request to /health
-INFO: 127.0.0.1:42038 - "GET /health HTTP/1.1" 403 Forbidden
-```
-
-**Root Cause:** ProtocolMiddleware was created as a global instance with default settings and didn't update when SSL was enabled.
-
-**Solution:** 
-1. **Use updated ProtocolManager** (Fixed in v1.1.0):
-   - ProtocolManager now dynamically updates based on SSL configuration
-   - Automatically allows HTTPS when SSL is enabled
-
-2. **Disable ProtocolMiddleware for HTTPS** (Temporary workaround):
-   ```json
-   {
-     "server": {"host": "127.0.0.1", "port": 10004},
-     "ssl": {"enabled": true, "cert_file": "./certs/server.crt", "key_file": "./certs/server.key"},
-     "security": {"enabled": true, "auth": {"enabled": true, "methods": ["api_key"]}},
-     "protocols": {"enabled": false}
-   }
-   ```
-
-### Issue 2: SSL Configuration Conflicts
-
-**Problem:** Framework reads SSL configuration from both `ssl` (legacy) and `security.ssl` sections, causing confusion.
-
-**Symptoms:**
-```
-🔍 Debug: SSL config at start of validation: enabled=False
-🔍 Debug: Root SSL section found: enabled=True
-🔍 Debug: _get_ssl_config: security.ssl key_file=None
-🔍 Debug: _get_ssl_config: legacy ssl key_file=./certs/server.key
-```
-
-**Solution:**
-1. **Use unified SSL configuration** (Recommended):
-   ```json
-   {
-     "security": {
-       "ssl": {
-         "enabled": true,
-         "cert_file": "./certs/server.crt",
-         "key_file": "./certs/server.key"
-       }
-     }
-   }
-   ```
-
-2. **Use legacy SSL configuration** (Backward compatible):
-   ```json
-   {
-     "ssl": {
-       "enabled": true,
-       "cert_file": "./certs/server.crt",
-       "key_file": "./certs/server.key"
-     }
-   }
-   ```
-
-### Issue 3: Security Framework Initialization Errors
-
-**Problem:** Security framework fails to initialize due to missing or null configuration values.
-
-**Symptoms:**
-```
-Failed to initialize security components: Failed to load roles configuration: argument should be a str or an os.PathLike object where __fspath__ returns a str, not 'NoneType'
-```
-
-**Solution:**
-1. **Provide roles file** (If using roles):
-   ```json
-   {
-     "security": {
-       "permissions": {
-         "enabled": true,
-         "roles_file": "./roles.json"
-       }
-     }
-   }
-   ```
-
-2. **Disable permissions** (If not using roles):
-   ```json
-   {
-     "security": {
-       "permissions": {
-         "enabled": false
-       }
-     }
-   }
-   ```
-
-3. **Use graceful fallback** (Fixed in v1.1.0):
-   - Security framework now continues without roles if roles_file is null
-   - Logs warning instead of crashing
-
-## Configuration Examples
-
-### HTTP Simple
-```json
-{
-  "server": {"host": "127.0.0.1", "port": 10001},
-  "ssl": {"enabled": false},
-  "security": {"enabled": false},
-  "protocols": {"enabled": true, "allowed_protocols": ["http"]}
-}
-```
-
-### HTTPS Simple
-```json
-{
-  "server": {"host": "127.0.0.1", "port": 10002},
-  "ssl": {"enabled": true, "cert_file": "./certs/server.crt", "key_file": "./certs/server.key"},
-  "security": {"enabled": false},
-  "protocols": {"enabled": true, "allowed_protocols": ["http", "https"]}
-}
-```
-
-### HTTPS with Token Auth
-```json
-{
-  "server": {"host": "127.0.0.1", "port": 10003},
-  "ssl": {"enabled": true, "cert_file": "./certs/server.crt", "key_file": "./certs/server.key"},
-  "security": {
-    "enabled": true,
-    "auth": {"enabled": true, "methods": ["api_key"]}
-  },
-  "protocols": {"enabled": true, "allowed_protocols": ["http", "https"]}
-}
-```
-
-### HTTPS without ProtocolMiddleware
-```json
-{
-  "server": {"host": "127.0.0.1", "port": 10004},
-  "ssl": {"enabled": true, "cert_file": "./certs/server.crt", "key_file": "./certs/server.key"},
-  "security": {
-    "enabled": true,
-    "auth": {"enabled": true, "methods": ["api_key"]}
-  },
-  "protocols": {"enabled": false}
-}
-```
-
-### mTLS Simple
-```json
-{
-  "server": {"host": "127.0.0.1", "port": 10005},
-  "ssl": {
-    "enabled": true,
-    "cert_file": "./certs/server.crt",
-    "key_file": "./certs/server.key",
-    "ca_cert": "./certs/ca.crt",
-    "verify_client": true
-  },
-  "security": {
-    "enabled": true,
-    "auth": {"enabled": true, "methods": ["certificate"]}
-  },
-  "protocols": {"enabled": true, "allowed_protocols": ["https", "mtls"]}
-}
-```
-
-## Testing Your Configuration
-
-### Test HTTP
-```bash
-curl http://127.0.0.1:10001/health
-```
-
-### Test HTTPS
-```bash
-curl -k https://127.0.0.1:10002/health
-```
-
-### Test HTTPS with Auth
-```bash
-curl -k -H "Authorization: Bearer your-api-key" https://127.0.0.1:10003/health
-```
-
-### Test mTLS
-```bash
-curl -k --cert ./certs/client.crt --key ./certs/client.key https://127.0.0.1:10005/health
-```
-
-## Debugging
-
-### Enable Debug Logging
-```json
-{
-  "logging": {
-    "level": "DEBUG",
-    "console_output": true
-  }
-}
-```
-
-### Check Protocol Manager Status
-```python
-from mcp_proxy_adapter.core.protocol_manager import get_protocol_manager
-from mcp_proxy_adapter.config import config
-
-pm = get_protocol_manager(config.get_all())
-print(f"Allowed protocols: {pm.get_allowed_protocols()}")
-print(f"Protocol info: {pm.get_protocol_info()}")
-```
-
-### Check SSL Configuration
-```python
-from mcp_proxy_adapter.config import config
-
-ssl_config = config.get("ssl", {})
-security_ssl = config.get("security", {}).get("ssl", {})
-print(f"Legacy SSL: {ssl_config}")
-print(f"Security SSL: {security_ssl}")
-```
-
-## Migration Guide
-
-### From Legacy to New Configuration
-
-**Old (Legacy):**
-```json
-{
-  "ssl": {"enabled": true, "cert_file": "./certs/server.crt", "key_file": "./certs/server.key"}
-}
-```
-
-**New (Recommended):**
-```json
-{
-  "security": {
-    "ssl": {"enabled": true, "cert_file": "./certs/server.crt", "key_file": "./certs/server.key"}
-  }
-}
-```
-
-### Adding Protocol Management
-
-**Without Protocol Management:**
-```json
-{
-  "protocols": {"enabled": false}
-}
-```
-
-**With Protocol Management:**
-```json
-{
-  "protocols": {
-    "enabled": true,
-    "allowed_protocols": ["http", "https"]
-  }
-}
-```
-
-## Best Practices
-
-1. **Use security.ssl instead of legacy ssl** for new configurations
-2. **Disable ProtocolMiddleware** if you don't need protocol validation
-3. **Provide roles_file** or disable permissions if using security framework
-4. **Test configurations** before deploying to production
-5. **Use debug logging** for troubleshooting
-6. **Keep certificates and keys secure** and properly configured
-
-## Support
-
-If you encounter issues not covered in this guide:
-
-1. Check the logs for detailed error messages
-2. Enable debug logging for more information
-3. Verify certificate files exist and are readable
-4. Test with simple configurations first
-5. Report issues with full configuration and error logs