solace-agent-mesh 1.4.11__py3-none-any.whl → 1.4.12__py3-none-any.whl

solace_agent_mesh/cli/__init__.py

@@ -1 +1 @@
-__version__ = "1.4.11"
+__version__ = "1.4.12"

solace_agent_mesh/common/services/identity_service.py

@@ -8,13 +8,14 @@ from typing import Any, Dict, List, Optional
 import importlib.metadata as metadata
 
 from solace_ai_connector.common.log import log
-from ...common.utils.in_memory_cache import InMemoryCache
+from ..utils.in_memory_cache import InMemoryCache
+from ..sac.sam_component_base import SamComponentBase
 
 
 class BaseIdentityService(ABC):
     """Abstract base class for all Identity Service providers."""
 
-    def __init__(self, config: Dict[str, Any]):
+    def __init__(self, config: Dict[str, Any], component: Optional[SamComponentBase] = None):
         """
         Initializes the service with its specific configuration block.
 
@@ -22,6 +23,7 @@ class BaseIdentityService(ABC):
             config: The dictionary of configuration parameters for this provider.
         """
         self.config = config
+        self.component = component
         self.log_identifier = f"[{self.__class__.__name__}]"
         self.cache_ttl = config.get("cache_ttl_seconds", 3600)
         self.cache = InMemoryCache() if self.cache_ttl > 0 else None
@@ -68,6 +70,7 @@ class BaseIdentityService(ABC):
 
 def create_identity_service(
     config: Optional[Dict[str, Any]],
+    component: Optional[SamComponentBase] = None,
 ) -> Optional[BaseIdentityService]:
     """
     Factory function to create an instance of an Identity Service provider
@@ -90,7 +93,7 @@ def create_identity_service(
     if provider_type == "local_file":
         from .providers.local_file_identity_service import LocalFileIdentityService
 
-        return LocalFileIdentityService(config)
+        return LocalFileIdentityService(config, component)
 
     else:
         try:
@@ -121,7 +124,7 @@ def create_identity_service(
                 )
 
             log.info(f"Successfully loaded identity provider plugin: {provider_type}")
-            return provider_class(config)
+            return provider_class(config, component)
         except (ImportError, AttributeError, TypeError, ValueError) as e:
             log.exception(
                 f"[IdentityFactory] Failed to load identity provider plugin '{provider_type}'. "

solace_agent_mesh/common/services/providers/local_file_identity_service.py

@@ -8,6 +8,8 @@ from typing import Any, Dict, List, Optional
 
 from solace_ai_connector.common.log import log
 from ..identity_service import BaseIdentityService
+from ...sac.sam_component_base import SamComponentBase
+
 
 
 class LocalFileIdentityService(BaseIdentityService):
@@ -28,8 +30,8 @@ class LocalFileIdentityService(BaseIdentityService):
     ]
     """
 
-    def __init__(self, config: Dict[str, Any]):
-        super().__init__(config)
+    def __init__(self, config: Dict[str, Any], component: Optional[SamComponentBase] = None):
+        super().__init__(config, component)
         self.file_path = self.config.get("file_path")
         if not self.file_path:
             raise ValueError("LocalFileIdentityService config requires 'file_path'.")

solace_agent_mesh/gateway/base/component.py

@@ -148,7 +148,7 @@ class BaseGatewayComponent(SamComponentBase):
 
         identity_service_config = self.get_config("identity_service")
         self.identity_service: Optional[BaseIdentityService] = create_identity_service(
-            identity_service_config
+            identity_service_config, self
         )
 
         self._config_resolver = MiddlewareRegistry.get_config_resolver()

{solace_agent_mesh-1.4.11.dist-info → solace_agent_mesh-1.4.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: solace-agent-mesh
-Version: 1.4.11
+Version: 1.4.12
 Summary: Solace Agent Mesh is an open-source framework for building event-driven, multi-agent AI systems where specialized agents collaborate on complex tasks.
 Project-URL: Homepage, https://github.com/SolaceLabs/solace-agent-mesh
 Project-URL: Repository, https://github.com/SolaceLabs/solace-agent-mesh

{solace_agent_mesh-1.4.11.dist-info → solace_agent_mesh-1.4.12.dist-info}/RECORD

@@ -13,14 +13,14 @@ solace_agent_mesh/agent/adk/intelligent_mcp_callbacks.py,sha256=4h2riXiw6DqFi3VV
 solace_agent_mesh/agent/adk/invocation_monitor.py,sha256=_20-nQXVjGlAEyw9PLFTTvgti-WgqyNE58LPUELUWnA,11671
 solace_agent_mesh/agent/adk/mcp_content_processor.py,sha256=8s3ytZ8qrKZCUt_u8aE_EHH1_01yewPoekkllCuz9ME,23850
 solace_agent_mesh/agent/adk/runner.py,sha256=Sw4gg0LBrsEjqAOGl0D3Zdars7SGrlgDtlZ5w4HK2q8,13430
-solace_agent_mesh/agent/adk/services.py,sha256=tUyg9XsifsupUzMEHa4Q2Z7tABjhkEmtJ93l_38Lpis,13196
-solace_agent_mesh/agent/adk/setup.py,sha256=xBu1lCcBLf6OV0GpJuEM1znO1o-0rWgUNFf36PkmFas,42588
+solace_agent_mesh/agent/adk/services.py,sha256=50Uxai7soogVnj1gP1aDPQreazV01wjl7-dnIFBTkro,13884
+solace_agent_mesh/agent/adk/setup.py,sha256=p7zga_JgSZ6_9TuGaain2ORdXPMHWvhuM3vSDRvgeD8,42742
 solace_agent_mesh/agent/adk/stream_parser.py,sha256=3i5rFN7dDVgjLvK4GG0PKYmxgIdtqKABfM9oTCouSZ0,8278
 solace_agent_mesh/agent/adk/tool_wrapper.py,sha256=yzkXjE4QtdVtO5edB-c-R_qJgaex9rmCHIswW1ltfxY,6513
 solace_agent_mesh/agent/adk/artifacts/__init__.py,sha256=vAB8eqGwgPo3nx6YkT93Y7puYRMcqIKMAchBizvdw7Y,62
 solace_agent_mesh/agent/adk/artifacts/artifacts_llm.txt,sha256=UZVqU_AU8rqrnzQV6CZ_MzsYd7o9ihUcqF7J1xns9gU,6567
 solace_agent_mesh/agent/adk/artifacts/filesystem_artifact_service.py,sha256=Z5uL1Mvy5ywVX47EXTy_xW2ZLtugAu6GlFWkeJ4leko,13983
-solace_agent_mesh/agent/adk/artifacts/s3_artifact_service.py,sha256=QXtjlGSQb5dpnTPeSRxThi9379JO0CATvPZJcWKlVsk,15373
+solace_agent_mesh/agent/adk/artifacts/s3_artifact_service.py,sha256=5apgJsqZIJHM_i6UP8di6PiQyJhmlAQBcWpl3sTEVmY,15412
 solace_agent_mesh/agent/adk/models/lite_llm.py,sha256=Enia0uFs2epagavdaCWNnvMFIL7VxRuo0A6mYBQZGWQ,30325
 solace_agent_mesh/agent/adk/models/models_llm.txt,sha256=tpihTC3M1-WXduJgZerCGcJzNUfRSsbtol4VFhKyd6U,6119
 solace_agent_mesh/agent/protocol/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -88,10 +88,10 @@ solace_agent_mesh/common/sam_events/__init__.py,sha256=J83dwcSjizOxMp4er9kNXdpP-
 solace_agent_mesh/common/sam_events/event_service.py,sha256=9x4lrnl1-d3BnLduJC0m4qLzVDTJtK8wKh3t29Y-ioo,7599
 solace_agent_mesh/common/services/__init__.py,sha256=4m4Vnp-DgXSsj-JFcE5ONAwjyWNm8IuaIxF2a0hV0SA,114
 solace_agent_mesh/common/services/employee_service.py,sha256=sIxj0Nt7JRL52P8MzGv3XfCXlBoGRSPOGkq9moMvA4s,6269
-solace_agent_mesh/common/services/identity_service.py,sha256=wNK9qZsdvXCsoDTDsqFq7KLLpHvzf3ymRdtaYLcX3P8,4750
+solace_agent_mesh/common/services/identity_service.py,sha256=ZHpxHUjBWVgxkz7P0zaEKQvGTkDvJbmGMVJW6ZQfKJc,4949
 solace_agent_mesh/common/services/services_llm.txt,sha256=RsJO51zDpJS_Fah0UXvAg0LurA0PPMnSmjiuIiTcyzM,13936
 solace_agent_mesh/common/services/providers/__init__.py,sha256=UVRTEftrFu3XMFRmNLiXKAFRaDYoD-_As05cIOO0gqI,126
-solace_agent_mesh/common/services/providers/local_file_identity_service.py,sha256=v_G-2ASl7CbM-Fw6-NxYiUS0ODkN1XYW7cwmeqImIHU,4913
+solace_agent_mesh/common/services/providers/local_file_identity_service.py,sha256=JPmgGtxQVFOxXZ4a0kiOAeuYsAfwS-F30DWSqI1xs7U,5026
 solace_agent_mesh/common/services/providers/providers_llm.txt,sha256=UjxyEPSURBOQ2qYKS5JZJ6xvkqCxbalLZ19Jdsw_kQU,3221
 solace_agent_mesh/common/utils/__init__.py,sha256=V4B3mUhsqB_3YYdT_JZepEw32OHf4mhzMR7I8I3aV-8,129
 solace_agent_mesh/common/utils/artifact_utils.py,sha256=-FEd1PlspVQNC-iknNeAy6AToZSvuV5SbH71fK7l1X4,826
@@ -121,7 +121,7 @@ solace_agent_mesh/gateway/gateway_llm.txt,sha256=67m_yuRW0VJ4ddldGWwXLx0aiVqK5lZ
 solace_agent_mesh/gateway/base/__init__.py,sha256=lOpIGp8W2rFNpLxfpk3VKLA-dBqxwtMxMVlhbaCisJY,72
 solace_agent_mesh/gateway/base/app.py,sha256=mvECmVEjuIf51Zs_7I16tBxwp6RgFVl5qsmp9lNgXcA,11143
 solace_agent_mesh/gateway/base/base_llm.txt,sha256=51U3VfwzCfptYxcFIjmNE8Wt07cgFfH3VlEp2kaXBZU,11291
-solace_agent_mesh/gateway/base/component.py,sha256=chHk4h13XLhOOGjEBIu3b7Ksr_ALcoWw7TUBOj5kofE,55145
+solace_agent_mesh/gateway/base/component.py,sha256=gfSQbDiyikSu9_hLrdi7zInZHYR0j6jQe949GlKKLsE,55151
 solace_agent_mesh/gateway/base/task_context.py,sha256=sFRRHyvBij-xms1f_VFc8om8-xIpRZawIctWtdmi6QY,2446
 solace_agent_mesh/gateway/http_sse/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 solace_agent_mesh/gateway/http_sse/alembic.ini,sha256=jPWjnjnvk5tr691YUcCv-jo7ZApFEgqS01Iz70U93Mc,4650
@@ -191,7 +191,7 @@ solace_agent_mesh/gateway/http_sse/shared/response_utils.py,sha256=-_z86YA02965C
 solace_agent_mesh/gateway/http_sse/shared/timestamp_utils.py,sha256=o3pJKPR6DA8sbOgflnmcotFp4H-I-Hij3lA-7F-yUAM,2380
 solace_agent_mesh/gateway/http_sse/shared/types.py,sha256=ISN1jjxOOLcak_o-Gm0W7yVW2dWcVmiHQ2wXzttOwPg,1291
 solace_agent_mesh/gateway/http_sse/shared/utils.py,sha256=SAfrRjBc_bwrEVFafGbswBShky2GlzLhp_c7C47QG-w,493
-solace_agent_mesh/cli/__init__.py,sha256=E_3GCl6XTRrqUMJy7bs7bnXqi2aoli2GL8PC4NQJkSE,23
+solace_agent_mesh/cli/__init__.py,sha256=nGraM_ujqcNJ-Dyz-qi99_8ynLwzQU2N68yOSnVykOs,23
 solace_agent_mesh/cli/main.py,sha256=yFbF4ijz7P6nxj26d-mTC8BnK6NKVnfqPh3y4pDBZqo,831
 solace_agent_mesh/cli/utils.py,sha256=7zntmVuvWbaWEhViSF2uw484-79a5I1XTUt-0eGQWY4,8036
 solace_agent_mesh/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -259,11 +259,11 @@ solace_agent_mesh/templates/plugin_tools_template.py,sha256=GUVw556CtBYE6sHbpXnF
 solace_agent_mesh/templates/shared_config.yaml,sha256=85EEcZDzomstQNBnOR2yjYpnTEXGGNs1VGduvHFk-HE,3310
 solace_agent_mesh/templates/templates_llm.txt,sha256=T3h8CcIowTbyBedlfRk7FZww8_xGmnY5fEqGhhdI3JU,9234
 solace_agent_mesh/templates/webui.yaml,sha256=4cEkPXLRhpATVD3A0UuJuo5aG0ApEseiADGtY3-W5qw,1784
-solace_agent_mesh/assets/docs/404.html,sha256=SNlJybCkfE_MUm5fMa8Jzm5toP5ov1Jnbc-KLg2POhk,11750
-solace_agent_mesh/assets/docs/lunr-index-1759514789087.json,sha256=_7XSt_oqVzEQaIzHWntyBjSNKqONzIqSXeJpUBt5WLY,1202761
-solace_agent_mesh/assets/docs/lunr-index.json,sha256=_7XSt_oqVzEQaIzHWntyBjSNKqONzIqSXeJpUBt5WLY,1202761
-solace_agent_mesh/assets/docs/search-doc-1759514789087.json,sha256=gF68qGQaSdjN0R2QCSTDyN-1yQn1s6RUVm4ppZ3Sxpo,425790
-solace_agent_mesh/assets/docs/search-doc.json,sha256=gF68qGQaSdjN0R2QCSTDyN-1yQn1s6RUVm4ppZ3Sxpo,425790
+solace_agent_mesh/assets/docs/404.html,sha256=a4PAruBxXDr15u0QVsKxupj5oSd6bBgyrT2igjbsIGA,11750
+solace_agent_mesh/assets/docs/lunr-index-1759936913198.json,sha256=vn2H_DfgqiSOfkPRZ_t_S3zDjA0fUw-V-1vOUJd10Ac,1203687
+solace_agent_mesh/assets/docs/lunr-index.json,sha256=vn2H_DfgqiSOfkPRZ_t_S3zDjA0fUw-V-1vOUJd10Ac,1203687
+solace_agent_mesh/assets/docs/search-doc-1759936913198.json,sha256=iJgrs4XDo6p2XAG3Nido8FNCnGUy684KqcGVt_ivh6Y,426317
+solace_agent_mesh/assets/docs/search-doc.json,sha256=iJgrs4XDo6p2XAG3Nido8FNCnGUy684KqcGVt_ivh6Y,426317
 solace_agent_mesh/assets/docs/sitemap.xml,sha256=rQaMKdLMLb0GOc5KpWYBiiVN_4OZgH8iRuCL3K1uHpI,7190
 solace_agent_mesh/assets/docs/assets/css/styles.906a1503.css,sha256=gQj16ydMLPiq6y-t8Ovto65hsvPbQX6coyIFOja-2eY,83293
 solace_agent_mesh/assets/docs/assets/images/Solace_AI_Framework_With_Broker-85f0a306a9bcdd20b390b7a949f6d862.png,sha256=e6MbZpxlY1xJ8U01zQogm8vWgokQqDfhsyPyNxtuS00,447393
@@ -271,7 +271,7 @@ solace_agent_mesh/assets/docs/assets/images/sac-flows-80d5b603c6aafd33e87945680c
 solace_agent_mesh/assets/docs/assets/images/sac_parts_of_a_component-cb3d0424b1d0c17734c5435cca6b4082.png,sha256=Z7-TCXxDC2fd6iZ3Lkr-F3OHhqr6m_glnzVIcwUhv4k,12283
 solace_agent_mesh/assets/docs/assets/images/sam-enterprise-credentials-b269f095349473118b2b33bdfcc40122.png,sha256=pJb4UjHrgDm22w1beXrbE9l1ElMeK546-PwMNNoBPXM,594985
 solace_agent_mesh/assets/docs/assets/js/04989206.a248f00c.js,sha256=IdnIPYlOB5uhiZL6pwOD5q2LZc23gXp3cnIVVn0hkIE,10856
-solace_agent_mesh/assets/docs/assets/js/0e682baa.d054e1d8.js,sha256=Rd3y0MSJ_-wdERfPoHMkO2_2TSoz_RqzkyMCjuxJbXc,12573
+solace_agent_mesh/assets/docs/assets/js/0e682baa.d54b8668.js,sha256=AtsMEK_eij8riMq6jgg0DaRHmtbSbkmEiE_Ms7UsjbU,13221
 solace_agent_mesh/assets/docs/assets/js/1001.0182a8bd.js,sha256=wnldyGaqrut3ES6Q5UDpRGsaNwlX_JoL2FDB_f7_hBI,90563
 solace_agent_mesh/assets/docs/assets/js/1023fc19.8a8a9309.js,sha256=Ccrvfzh6h7Mw-fDTHDYgkdinADChMthSzis02V4wjnM,14601
 solace_agent_mesh/assets/docs/assets/js/1039.0bd46aa1.js,sha256=3gOxMCGWPNyBymsv8WkRfDuOlc7UZ1c9c794Q7gmNyQ,71713
@@ -363,49 +363,49 @@ solace_agent_mesh/assets/docs/assets/js/d6a81ee7.829198f1.js,sha256=6adqCXcWhOhK
 solace_agent_mesh/assets/docs/assets/js/f284c35a.ed8dd236.js,sha256=_zvWxe9mrWJrDNZHrkFtGWcd8dj6Q6_qQGCVJ8EZ0pM,22493
 solace_agent_mesh/assets/docs/assets/js/f897a61a.126663fe.js,sha256=hY5NvBKRQIFTHG_WQJ_B0ek3PAGTcq_zBSS0M7Gi7bM,17031
 solace_agent_mesh/assets/docs/assets/js/fbfa3e75.e144b16c.js,sha256=Li4QOuQnso5c1xJULcdtVFYVy3WeK5CRzYBVukX25s8,7312
-solace_agent_mesh/assets/docs/assets/js/main.dc155742.js,sha256=qLip9l2xV93k_Mwi62BMBWAWNAz1_PVgvXGJrURCYF8,484008
-solace_agent_mesh/assets/docs/assets/js/main.dc155742.js.LICENSE.txt,sha256=3Jia5o7yaxOtbxuy9khs-thK96m55yCiPaUA-IkWh0A,2069
-solace_agent_mesh/assets/docs/assets/js/runtime~main.0d2ff2b6.js,sha256=YM42hTqOpyOm0lVe1etdyRs0PSKqvJ5woNqamzwOx_U,6334
-solace_agent_mesh/assets/docs/docs/documentation/Enterprise/installation/index.html,sha256=MJYXTrJ3s71DmD7zkH7K8tO9Xb4LELUdLwdpzr0S_qk,34112
-solace_agent_mesh/assets/docs/docs/documentation/Enterprise/rbac-setup-guilde/index.html,sha256=7Y7KaVcoMyZtrjnI62q0EDdSLCoB9LpxezHcZveuqLc,84679
-solace_agent_mesh/assets/docs/docs/documentation/Enterprise/single-sign-on/index.html,sha256=PjzOqWa7k2Wsu9Jxmkwu-PBoTNRw-s4c3fQQc0OJnXk,70179
-solace_agent_mesh/assets/docs/docs/documentation/Migrations/A2A Upgrade To 0.3.0/a2a-gateway-upgrade-to-0.3.0/index.html,sha256=3TNuDJRJQ5I3XG-uO3lAyAYvyZDr5JF38LsvCVoHUGQ,85247
-solace_agent_mesh/assets/docs/docs/documentation/Migrations/A2A Upgrade To 0.3.0/a2a-technical-migration-map/index.html,sha256=24Al-pXPEbMkZumJjbqZDfdQdRpRK7BzuL9Fw-lSfSg,88082
-solace_agent_mesh/assets/docs/docs/documentation/concepts/agents/index.html,sha256=51PJRW1C0wNBmzXmbgwfnR_Mf2mLesieALntNN0H7g8,40163
-solace_agent_mesh/assets/docs/docs/documentation/concepts/architecture/index.html,sha256=Q2j53tqoYqbjfTDmnGYeqQx0Tu2sB9D1rPXScgXNCF4,33033
-solace_agent_mesh/assets/docs/docs/documentation/concepts/cli/index.html,sha256=iD_ttBYrTXC3hD9aMhjI0f3reyGlXo8N2Rj_e3PDK2c,52978
-solace_agent_mesh/assets/docs/docs/documentation/concepts/gateways/index.html,sha256=6I9U9QR2lkLb0Nc1vDhlmO3Mi1akMYf0MqhhdAhNFEs,30474
-solace_agent_mesh/assets/docs/docs/documentation/concepts/orchestrator/index.html,sha256=fo_cqOiKELmAyIJptpTAI-S_OoJ_w80VrQffHRyKM5k,24175
-solace_agent_mesh/assets/docs/docs/documentation/concepts/plugins/index.html,sha256=sblgaheIEURCewVqxHR7ZmjFqw18dkSUoaJKClLWLWY,40351
-solace_agent_mesh/assets/docs/docs/documentation/deployment/debugging/index.html,sha256=aHqkIWKZD9BRyh2lWjDYd4qoqcg_jplhuDaPDiHyRxc,45952
-solace_agent_mesh/assets/docs/docs/documentation/deployment/deploy/index.html,sha256=cfs8PmdB7F6gDr8oVndIeWt1eglA_8hG7anqJOLTsKQ,42859
-solace_agent_mesh/assets/docs/docs/documentation/deployment/observability/index.html,sha256=rMthnXF360wTNR1KASlE_ong1ftUoKFHarLtcW5NbaE,26411
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/component-overview/index.html,sha256=xP9ptDtPswbufe9sAny65RLbL3NUHgCCLl_3LX8CgRY,22065
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/configurations/index.html,sha256=yr1jT2MWcvP3xTfBpRf614rYDrUZHNBqzxotATFTJ-g,58707
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/configurations/litellm_models/index.html,sha256=tNs6eJr8BNpDz1pqdNEvz42VpmUtO0PJzmjflstr-Rk,38568
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/installation/index.html,sha256=0VZBuxFjsERc_IldXOPyCaXSpboTGNQ6a1IHTJuqk1I,32919
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/introduction/index.html,sha256=RztxzvriWa9rLNrnxX0QOXfDT2G93Fl21519CS2hNTk,30820
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/quick-start/index.html,sha256=VLtZeL5B8nUxickF3hKUtuC4udXreTq2i6zd9xlSbBY,42986
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/bedrock-agents/index.html,sha256=0wPreMY511W40rlUGL7cs_LPvjIYTDaLwo2hEmjhjWo,76108
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/custom-agent/index.html,sha256=zwFusX5cmWrM5N-UryKrxUs1kmgp4zJyIiCtIr5NCik,383717
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/event-mesh-gateway/index.html,sha256=EG2CJSS_Y4g8hKEwsufrdiMz2wfG9SxG5N6uslsOZV4,69566
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/mcp-integration/index.html,sha256=bXptK_yQWYbr5xxlMbuJ3PLJzmSfRw5C1gtYp-45-Ss,65370
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/mongodb-integration/index.html,sha256=MR3XS2lZ9QFXEtzb8S_kkFeEcCQQma4kVnpuCXv2h2U,87988
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/rag-integration/index.html,sha256=bIufvO66-vNkZs9OYMezAJclpPXo1ie0jmCEfinJRd0,80798
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/rest-gateway/index.html,sha256=g8-70OHma6FfKGG-C9Ep2nw1Knx6b8dGCop-Dx4L8Ac,47079
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/slack-integration/index.html,sha256=rX2Uz9qxO_9fX8kxw9n5ga7UHCuK8UhE4a83bM73jWQ,50308
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/sql-database/index.html,sha256=8WLM_aCTyYG3mUkYwH6k3MiD6yUlA0B7t3eXRm-puoc,69693
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/index.html,sha256=Oc_YBMVtmjpXcH-147tBbViHqLm145Xxrx_kN08I7LE,45168
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/artifact-management/index.html,sha256=igmMCuWuU7YPu6sFazhEDGL8mD5mX_xS_7VRLdOa_as,35138
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/audio-tools/index.html,sha256=XY2ojOVwFt6XDVknwnxa-eCmh2svubJPiGoHt_iwPm0,58575
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/data-analysis-tools/index.html,sha256=Gz-5HogSd434WJoXeXiZiCDpW45C72R2_DfvjAKOwg4,38124
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/embeds/index.html,sha256=UKbl_NlzIo06CyZmyOfGXXDzzRw09zaB6SLvm6iCr6Q,51022
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/create-agents/index.html,sha256=DTpCxk3O5istoZSV4eqybbWGXB9SVXUH5XFGl5jE8K4,163874
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/create-gateways/index.html,sha256=jiqk19Y_JH2s4mDY2t6661eeqIOUVHcfwOb2IGlMhCI,403273
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/creating-python-tools/index.html,sha256=AhIbvxYLU_nwIn2RfCGOgLm9mO-t413NLJpe1GOP90s,175980
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/creating-service-providers/index.html,sha256=UXGJSgQ0es5ZDwJBdM1ZEj-U55EQZwm7uY4ghHczw2U,60060
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/solace-ai-connector/index.html,sha256=jwzwuFcQbDUqEdaC6SIlhkAa4Ap0-GmE-F5TxMAwCzI,26175
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/structure/index.html,sha256=itmdXNFe5FH6T7nZNa-au2PMw6tYiy0f9EGz5nS33PY,30180
+solace_agent_mesh/assets/docs/assets/js/main.f67fc9f4.js,sha256=26PoWL-BVmoXzzKftE6ZL0YJaNLh-H6BEqAzUrriYKY,484008
+solace_agent_mesh/assets/docs/assets/js/main.f67fc9f4.js.LICENSE.txt,sha256=3Jia5o7yaxOtbxuy9khs-thK96m55yCiPaUA-IkWh0A,2069
+solace_agent_mesh/assets/docs/assets/js/runtime~main.40527046.js,sha256=eT1DkCNHunyytHBi13HfFARHl-3Ni47kpvXg2OyfbH4,6334
+solace_agent_mesh/assets/docs/docs/documentation/Enterprise/installation/index.html,sha256=UUP8KmStT9sk6kE-M_s3TN-M3w4BuXMH2hNGGDu4vQk,34112
+solace_agent_mesh/assets/docs/docs/documentation/Enterprise/rbac-setup-guilde/index.html,sha256=vxRqghdr3NivBAS24CdCIylnHc4bACFo6LOFKOnNx8U,84679
+solace_agent_mesh/assets/docs/docs/documentation/Enterprise/single-sign-on/index.html,sha256=yWOHdxkIzoGDjfHCUhNhs4w1cQnfplnyC7Rc1U6cCMQ,70179
+solace_agent_mesh/assets/docs/docs/documentation/Migrations/A2A Upgrade To 0.3.0/a2a-gateway-upgrade-to-0.3.0/index.html,sha256=PpPJyXhoPxf_w3lDv7OYp_7H2PnQY_pKoVJy0J2WBKc,85247
+solace_agent_mesh/assets/docs/docs/documentation/Migrations/A2A Upgrade To 0.3.0/a2a-technical-migration-map/index.html,sha256=0R3uKS5x21ON5RgXRUvEin5slfVVOVqs72ffQCWyrBo,88082
+solace_agent_mesh/assets/docs/docs/documentation/concepts/agents/index.html,sha256=tVpd9xkE6iyh4ybxpgewXVs-S7jyoqgp5nlq-8P2aiI,40163
+solace_agent_mesh/assets/docs/docs/documentation/concepts/architecture/index.html,sha256=SRlDBEQQJLCH07Xnosfvnn4nwCwV9aFG50ymsgHXsrc,33033
+solace_agent_mesh/assets/docs/docs/documentation/concepts/cli/index.html,sha256=ublL2Tj-EJv0VUDPznQt_R_mi-t0BLOnNk11TM1chHU,52978
+solace_agent_mesh/assets/docs/docs/documentation/concepts/gateways/index.html,sha256=dygcyoUOm5ii2OV1URvNdOPzox2uTK9LpUtZ7v2gIyI,30474
+solace_agent_mesh/assets/docs/docs/documentation/concepts/orchestrator/index.html,sha256=mifk6Yr0EKHc0Y4s_RdKBw1Ej64rfKYAVSyuY3i6p0w,24175
+solace_agent_mesh/assets/docs/docs/documentation/concepts/plugins/index.html,sha256=V1p2jBo9Y-BF-rdvp0wu0WcSD6zSYMuO3CcBH8NSPO0,40351
+solace_agent_mesh/assets/docs/docs/documentation/deployment/debugging/index.html,sha256=2XyivtnXQLweEYoB__6ZRVZKXQa9ZlRYyO34okVvDJI,45952
+solace_agent_mesh/assets/docs/docs/documentation/deployment/deploy/index.html,sha256=3M2xmVKae8iA_d7SmZ-6Sz84e3JBOlPFYlXZzelmSS4,42859
+solace_agent_mesh/assets/docs/docs/documentation/deployment/observability/index.html,sha256=7wMhFQYXqLzMQr-OJdHibVWQS7VQokdtd4VWM4StJf0,26411
+solace_agent_mesh/assets/docs/docs/documentation/getting-started/component-overview/index.html,sha256=_-7-oiwnHPcLmpIMHM9rGENOyRlVP1P_mUnvyAbfeZw,22065
+solace_agent_mesh/assets/docs/docs/documentation/getting-started/configurations/index.html,sha256=sRZVLu025BWyAEJ9VxuLRaSHjQimpOZAbwbKnq-DCAg,58707
+solace_agent_mesh/assets/docs/docs/documentation/getting-started/configurations/litellm_models/index.html,sha256=6BKxSjrveHNa_AKHbph7_BXURRs8sxzptsCrfma935o,38568
+solace_agent_mesh/assets/docs/docs/documentation/getting-started/installation/index.html,sha256=0vTCdEjPcGKSOQMJS1hTaG5PiCM2eUS-vcc4ATkepEA,32919
+solace_agent_mesh/assets/docs/docs/documentation/getting-started/introduction/index.html,sha256=8PfExZEstJvqTZfECeuAy574UHM1ObWTYSOmO0tzqGY,30820
+solace_agent_mesh/assets/docs/docs/documentation/getting-started/quick-start/index.html,sha256=F7eUfNG31tuKZsrDHxsxnSCYFNf_0jkOheJYbbCHNwM,42986
+solace_agent_mesh/assets/docs/docs/documentation/tutorials/bedrock-agents/index.html,sha256=l9RWUW-d7W8CdKTot2E33rknAz7A1JkysjCS7w3uKwg,76108
+solace_agent_mesh/assets/docs/docs/documentation/tutorials/custom-agent/index.html,sha256=MHEXCDF_V8RxZrwrdtghW4bu3Iy3VQkw0Wi7OVjKans,383717
+solace_agent_mesh/assets/docs/docs/documentation/tutorials/event-mesh-gateway/index.html,sha256=6iLTEZyfmadI8Zw7E7ab88rvJvnQlytQM5JDJxFr9_o,69566
+solace_agent_mesh/assets/docs/docs/documentation/tutorials/mcp-integration/index.html,sha256=X0PjouKNE3vUukOrY4KyO3RU3BsGuVP5qOn39IWa89I,68547
+solace_agent_mesh/assets/docs/docs/documentation/tutorials/mongodb-integration/index.html,sha256=ARNiUY7W6aLquc1GxC_lkCmn3e5ii9Az15jyH4pbl_A,87988
+solace_agent_mesh/assets/docs/docs/documentation/tutorials/rag-integration/index.html,sha256=rll4rrTMTQYXjo8Ka8EWtufz5OT1rjrn4rZDqWur6i0,80798
+solace_agent_mesh/assets/docs/docs/documentation/tutorials/rest-gateway/index.html,sha256=4ydmgABna-lppK0vd9wu0p7YcBER59dQao-MnNB2aCU,47079
+solace_agent_mesh/assets/docs/docs/documentation/tutorials/slack-integration/index.html,sha256=ds6gvRZghBQrrbnN-_IM9UCVl5ntBEDX8ZbmUeCWV78,50308
+solace_agent_mesh/assets/docs/docs/documentation/tutorials/sql-database/index.html,sha256=BaWsFKas6Du6fmT4uU1DAJyj54NtWNARjEPMPTGmpMM,69693
+solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/index.html,sha256=7y40mu_vHlVv6Bh8i0JaxoqzomMNH5QapHRoLWCGb5U,45168
+solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/artifact-management/index.html,sha256=GAzjNLd9DwSXgXtK4c_mlIvCAwi1RucBWsAKj_0UsAA,35138
+solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/audio-tools/index.html,sha256=0lAShEYlXjo1dk1N9T6ZbTxV053kq7VNeuaMzpyLn5E,58575
+solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/data-analysis-tools/index.html,sha256=_EnqMtgSKnpipGvB8PsDISf2dIQWtiHSVxjbpkW1E6M,38124
+solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/embeds/index.html,sha256=WvtMHU5wAPc7m-w67iXfrUT4sS_1CA95SFLmfRQP_mk,51022
+solace_agent_mesh/assets/docs/docs/documentation/user-guide/create-agents/index.html,sha256=1V4ZaJSv04XJNIdZKhD33E15rUWoSYwFMPFbvqY3bgY,163874
+solace_agent_mesh/assets/docs/docs/documentation/user-guide/create-gateways/index.html,sha256=04dkOQPyKEN-HfSxEX7kg-N-waVWM49zOTXWy10h_6Y,403273
+solace_agent_mesh/assets/docs/docs/documentation/user-guide/creating-python-tools/index.html,sha256=QBnnBK6tNGwGFwcFjGrSFlrkvxJ_baC0qoto_d5WFVc,175980
+solace_agent_mesh/assets/docs/docs/documentation/user-guide/creating-service-providers/index.html,sha256=J0MqQ9b5roYrg3clrXI6LDYeXa9KAydHHWzvAyfg0Kw,60060
+solace_agent_mesh/assets/docs/docs/documentation/user-guide/solace-ai-connector/index.html,sha256=lJ_A2MOU2ZpmPGNePXiGImM4wwEaVkEQReUNsGlo4tU,26175
+solace_agent_mesh/assets/docs/docs/documentation/user-guide/structure/index.html,sha256=fdP1C9-F1nSsIKpF9648iwW_B-8yr6Nf1axC6csokmo,30180
 solace_agent_mesh/assets/docs/img/Solace_AI_Framework_With_Broker.png,sha256=e6MbZpxlY1xJ8U01zQogm8vWgokQqDfhsyPyNxtuS00,447393
 solace_agent_mesh/assets/docs/img/logo.png,sha256=TdXZ2wnkSkaFrGO-5fy2WcmjGXaGzwE29dM83raxoTg,45439
 solace_agent_mesh/assets/docs/img/sac-flows.png,sha256=868GgNJGPxn2G6c1Md_0umhg3xuAo7t6HEx8hOKbUJY,21098
@@ -441,8 +441,8 @@ solace_agent_mesh/client/webui/frontend/static/assets/favicon-BLgzUch9.ico,sha25
 solace_agent_mesh/client/webui/frontend/static/assets/main-ChRwcV89.css,sha256=eWc7an60oiobwKiH4LOAhC77AAE50q95HRc3xh8CdB0,119934
 solace_agent_mesh/client/webui/frontend/static/assets/main-DnnE01OM.js,sha256=xvk3zsfmPgs5cVNe44mmZuSrVF87JMnQpGBUqTRY7Eg,424473
 solace_agent_mesh/client/webui/frontend/static/assets/vendor-CS5YMf8a.js,sha256=pySecfbg42jjmh23Z4dRsbST36DQM8SCo4X7_o7nhIs,340916
-solace_agent_mesh-1.4.11.dist-info/METADATA,sha256=wEDPWV1f4nPx3ZnZ52LwaVGJ6R0ik47W_ZRryN3MAcY,24926
-solace_agent_mesh-1.4.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-solace_agent_mesh-1.4.11.dist-info/entry_points.txt,sha256=5pLVH8d8bd4sxUwBh7VTni8gTTSzTqGfY14zgdQZm1I,106
-solace_agent_mesh-1.4.11.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-solace_agent_mesh-1.4.11.dist-info/RECORD,,
+solace_agent_mesh-1.4.12.dist-info/METADATA,sha256=xOwvpR7xlEKd0hGExVSChegzdpira49Wy43hQ5hcUKc,24926
+solace_agent_mesh-1.4.12.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+solace_agent_mesh-1.4.12.dist-info/entry_points.txt,sha256=5pLVH8d8bd4sxUwBh7VTni8gTTSzTqGfY14zgdQZm1I,106
+solace_agent_mesh-1.4.12.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+solace_agent_mesh-1.4.12.dist-info/RECORD,,

solace_agent_mesh/assets/docs/assets/js/0e682baa.d054e1d8.js

@@ -1 +0,0 @@
-"use strict";(self.webpackChunksolace_agenitc_mesh_docs=self.webpackChunksolace_agenitc_mesh_docs||[]).push([[1430],{7977:(e,n,t)=>{t.r(n),t.d(n,{assets:()=>l,contentTitle:()=>a,default:()=>h,frontMatter:()=>r,metadata:()=>o,toc:()=>c});const o=JSON.parse('{"id":"documentation/tutorials/mcp-integration","title":"MCP Integration","description":"This tutorial walks you through the process of integrating a Model Context Protocol (MCP) Server into Solace Agent Mesh.","source":"@site/docs/documentation/tutorials/mcp-integration.md","sourceDirName":"documentation/tutorials","slug":"/documentation/tutorials/mcp-integration","permalink":"/solace-agent-mesh/docs/documentation/tutorials/mcp-integration","draft":false,"unlisted":false,"editUrl":"https://github.com/SolaceLabs/solace-agent-mesh/edit/main/docs/docs/documentation/tutorials/mcp-integration.md","tags":[],"version":"current","sidebarPosition":10,"frontMatter":{"title":"MCP Integration","sidebar_position":10},"sidebar":"docSidebar","previous":{"title":"Build Your Own Agent","permalink":"/solace-agent-mesh/docs/documentation/tutorials/custom-agent"},"next":{"title":"REST Gateway","permalink":"/solace-agent-mesh/docs/documentation/tutorials/rest-gateway"}}');var s=t(4848),i=t(8453);const r={title:"MCP Integration",sidebar_position:10},a="MCP Integration",l={},c=[{value:"Setting Up the Environment",id:"setting-up-the-environment",level:2},{value:"Adding MCP Tools to an Agent",id:"adding-mcp-tools-to-an-agent",level:2},{value:"1. Stdio Connection (Local MCP Servers)",id:"1-stdio-connection-local-mcp-servers",level:3},{value:"2. SSE Connection (Remote MCP Servers)",id:"2-sse-connection-remote-mcp-servers",level:3},{value:"3. Docker Connection (Containerized MCP Servers)",id:"3-docker-connection-containerized-mcp-servers",level:3},{value:"Complete Example: Filesystem MCP Agent",id:"complete-example-filesystem-mcp-agent",level:2},{value:"Configuration Options",id:"configuration-options",level:2},{value:"Tool-Specific Configuration",id:"tool-specific-configuration",level:3},{value:"Environment Variables",id:"environment-variables",level:3},{value:"Running Your MCP-Enabled Agent",id:"running-your-mcp-enabled-agent",level:2},{value:"How MCP Integration Works",id:"how-mcp-integration-works",level:2},{value:"Testing Your MCP Integration",id:"testing-your-mcp-integration",level:2}];function d(e){const n={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",h3:"h3",header:"header",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,i.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(n.header,{children:(0,s.jsx)(n.h1,{id:"mcp-integration",children:"MCP Integration"})}),"\n",(0,s.jsx)(n.p,{children:"This tutorial walks you through the process of integrating a Model Context Protocol (MCP) Server into Solace Agent Mesh."}),"\n",(0,s.jsx)(n.admonition,{title:"Learn about agents",type:"info",children:(0,s.jsxs)(n.p,{children:["You should have an understanding of agents in Solace Agent Mesh. For more information, see ",(0,s.jsx)(n.a,{href:"/solace-agent-mesh/docs/documentation/concepts/agents",children:"Agents"}),"."]})}),"\n",(0,s.jsxs)(n.p,{children:["Solace Agent Mesh now provides ",(0,s.jsx)(n.strong,{children:"native MCP support"})," through the framework itself. No additional plugins are required - you can connect to MCP servers directly by configuring your agent YAML file with MCP tools."]}),"\n",(0,s.jsx)(n.p,{children:"MCP integration allows your agents to connect to external MCP servers and use their tools, resources, and prompts seamlessly within the A2A protocol ecosystem."}),"\n",(0,s.jsx)(n.h2,{id:"setting-up-the-environment",children:"Setting Up the Environment"}),"\n",(0,s.jsxs)(n.p,{children:["You must ",(0,s.jsx)(n.a,{href:"/solace-agent-mesh/docs/documentation/getting-started/installation",children:"install Solace Agent Mesh and Solace Agent Mesh CLI"}),", and then ",(0,s.jsx)(n.a,{href:"/solace-agent-mesh/docs/documentation/getting-started/quick-start",children:"create a new Solace Agent Mesh project"}),"."]}),"\n",(0,s.jsx)(n.p,{children:"For this tutorial using the filesystem MCP server, you also need Node.js and NPM installed."}),"\n",(0,s.jsx)(n.h2,{id:"adding-mcp-tools-to-an-agent",children:"Adding MCP Tools to an Agent"}),"\n",(0,s.jsx)(n.p,{children:"MCP integration is accomplished by adding MCP tools directly to your agent configuration. There are three main connection types supported:"}),"\n",(0,s.jsx)(n.h3,{id:"1-stdio-connection-local-mcp-servers",children:"1. Stdio Connection (Local MCP Servers)"}),"\n",(0,s.jsx)(n.p,{children:"This is the most common method for connecting to MCP servers that run as local processes:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-yaml",children:'tools:\n  - tool_type: mcp\n    connection_params:\n      type: stdio\n      command: "npx"\n      args:\n        - "-y"\n        - "@modelcontextprotocol/server-filesystem"\n        - "/tmp/samv2"\n'})}),"\n",(0,s.jsx)(n.h3,{id:"2-sse-connection-remote-mcp-servers",children:"2. SSE Connection (Remote MCP Servers)"}),"\n",(0,s.jsx)(n.p,{children:"For connecting to remote MCP servers using Server-Sent Events:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-yaml",children:'tools:\n  - tool_type: mcp\n    connection_params:\n      type: sse\n      url: "https://mcp.example.com/v1/sse"\n      headers:\n        Authorization: "Bearer ${MCP_AUTH_TOKEN}"\n'})}),"\n",(0,s.jsx)(n.h3,{id:"3-docker-connection-containerized-mcp-servers",children:"3. Docker Connection (Containerized MCP Servers)"}),"\n",(0,s.jsx)(n.p,{children:"For running MCP servers in Docker containers:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-yaml",children:'tools:\n  - tool_type: mcp\n    connection_params:\n      type: stdio\n      command: "docker"\n      args:\n        - "run"\n        - "-i"\n        - "--rm"\n        - "-e"\n        - "API_KEY"\n        - "mcp-server-image:latest"\n    environment_variables:\n      API_KEY: ${MY_API_KEY}\n'})}),"\n",(0,s.jsx)(n.h2,{id:"complete-example-filesystem-mcp-agent",children:"Complete Example: Filesystem MCP Agent"}),"\n",(0,s.jsx)(n.p,{children:"Here is a complete example of an agent that uses the filesystem MCP server:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-yaml",children:'# configs/agents/filesystem_agent.yaml\nlog:\n  stdout_log_level: INFO\n  log_file_level: DEBUG\n  log_file: filesystem_agent.log\n\n!include ../shared_config.yaml\n\napps:\n  - name: filesystem_mcp_agent_app\n    app_base_path: .\n    app_module: solace_agent_mesh.agent.sac.app\n    broker:\n      <<: *broker_connection\n\n    app_config:\n      namespace: ${NAMESPACE}\n      supports_streaming: true\n      agent_name: "FileSystemAgent"\n      display_name: "File System"\n      model: *general_model\n      \n      instruction: |\n        You can interact with the local filesystem using MCP tools.\n        Use the available tools to read, write, and manage files as requested.\n\n      tools:\n        - tool_type: mcp\n          connection_params:\n            type: stdio\n            command: "npx"\n            args:\n              - "-y"\n              - "@modelcontextprotocol/server-filesystem"\n              - "/tmp/samv2"\n        - tool_type: builtin-group\n          group_name: "artifact_management"\n\n      session_service: *default_session_service\n      artifact_service: *default_artifact_service\n\n      # Agent discovery and communication\n      agent_card:\n        description: "An agent that interacts with the local filesystem via MCP."\n        defaultInputModes: ["text"]\n        defaultOutputModes: ["text", "file"]\n        skills: []\n\n      agent_card_publishing: { interval_seconds: 10 }\n      agent_discovery: { enabled: true }\n      inter_agent_communication:\n        allow_list: ["*"]\n        request_timeout_seconds: 30\n'})}),"\n",(0,s.jsx)(n.h2,{id:"configuration-options",children:"Configuration Options"}),"\n",(0,s.jsx)(n.h3,{id:"tool-specific-configuration",children:"Tool-Specific Configuration"}),"\n",(0,s.jsx)(n.p,{children:"You can limit which tools from an MCP server are available by specifying a specific tool name:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-yaml",children:'tools:\n  - tool_type: mcp\n    tool_name: "read_file"  # Only expose the read_file tool\n    connection_params:\n      type: stdio\n      command: "npx"\n      args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp/samv2"]\n'})}),"\n",(0,s.jsx)(n.h3,{id:"environment-variables",children:"Environment Variables"}),"\n",(0,s.jsxs)(n.p,{children:["Pass environment variables to MCP servers using the ",(0,s.jsx)(n.code,{children:"environment_variables"})," block:"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-yaml",children:'tools:\n  - tool_type: mcp\n    connection_params:\n      type: stdio\n      command: "my-mcp-server"\n    environment_variables:\n      API_KEY: ${MY_API_KEY}\n      DEBUG_MODE: "true"\n      CONFIG_PATH: "/etc/myconfig"\n'})}),"\n",(0,s.jsx)(n.h2,{id:"running-your-mcp-enabled-agent",children:"Running Your MCP-Enabled Agent"}),"\n",(0,s.jsxs)(n.ol,{children:["\n",(0,s.jsxs)(n.li,{children:["\n",(0,s.jsxs)(n.p,{children:[(0,s.jsx)(n.strong,{children:"Create the working directory"})," (for filesystem example):"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-sh",children:'mkdir -p /tmp/samv2\necho "Hello MCP!" > /tmp/samv2/test.txt\n'})}),"\n"]}),"\n",(0,s.jsxs)(n.li,{children:["\n",(0,s.jsxs)(n.p,{children:[(0,s.jsx)(n.strong,{children:"Set required environment variables"}),":"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-sh",children:'export NAMESPACE="myorg/dev"\nexport SOLACE_BROKER_URL="ws://localhost:8008"\n# ... other Solace broker settings\n'})}),"\n"]}),"\n",(0,s.jsxs)(n.li,{children:["\n",(0,s.jsxs)(n.p,{children:[(0,s.jsx)(n.strong,{children:"Run the agent"}),":"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-sh",children:"sam run configs/agents/filesystem_agent.yaml\n"})}),"\n"]}),"\n"]}),"\n",(0,s.jsx)(n.h2,{id:"how-mcp-integration-works",children:"How MCP Integration Works"}),"\n",(0,s.jsx)(n.p,{children:"When your agent starts:"}),"\n",(0,s.jsxs)(n.ol,{children:["\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.strong,{children:"Connection"}),": The framework establishes a connection to the MCP server using the specified connection parameters"]}),"\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.strong,{children:"Discovery"}),": It queries the MCP server for available tools, resources, and prompts"]}),"\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.strong,{children:"Registration"}),": Available capabilities are registered as agent tools."]}),"\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.strong,{children:"Communication"}),": The agent can use these tools through the standard A2A protocol, with the framework handling MCP protocol translation"]}),"\n"]}),"\n",(0,s.jsx)(n.h2,{id:"testing-your-mcp-integration",children:"Testing Your MCP Integration"}),"\n",(0,s.jsx)(n.p,{children:"Once your MCP-enabled agent is running, you can test it through any gateway in your project (such as the Web UI gateway):"}),"\n",(0,s.jsxs)(n.ol,{children:["\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.strong,{children:"Access your gateway"})," (for example, Web UI at ",(0,s.jsx)(n.code,{children:"http://localhost:8000"}),")"]}),"\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.strong,{children:"Send a request"})," to test the MCP functionality:","\n",(0,s.jsxs)(n.ul,{children:["\n",(0,s.jsx)(n.li,{children:'"List the files in the directory"'}),"\n",(0,s.jsx)(n.li,{children:'"Create a simple text file with some content"'}),"\n",(0,s.jsx)(n.li,{children:'"Read the contents of test.txt"'}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,s.jsx)(n.p,{children:"The agent uses the MCP tools to interact with the filesystem and provide responses through the A2A protocol."})]})}function h(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,s.jsx)(n,{...e,children:(0,s.jsx)(d,{...e})}):d(e)}},8453:(e,n,t)=>{t.d(n,{R:()=>r,x:()=>a});var o=t(6540);const s={},i=o.createContext(s);function r(e){const n=o.useContext(i);return o.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function a(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:r(e.components),o.createElement(i.Provider,{value:n},e.children)}}}]);