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

solace_agent_mesh/cli/__init__.py

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

solace_agent_mesh/cli/commands/add_cmd/agent_cmd.py

@@ -95,7 +95,7 @@ def _write_agent_yaml_from_data(
                 custom_artifact_lines.append(f'base_path: "{base_path_val}"')
             elif type_val == "s3":
                 custom_artifact_lines.append("bucket_name: ${S3_BUCKET_NAME}")
-                custom_artifact_lines.append("endpoint_url: ${S3_ENDPOINT_URL:-}")
+                custom_artifact_lines.append("endpoint_url: ${S3_ENDPOINT_URL}")
                 custom_artifact_lines.append("region: ${S3_REGION}")
             custom_artifact_lines.append(f"artifact_scope: {scope_val}")
             artifact_service_block = "\n" + "\n".join(

solace_agent_mesh/cli/commands/init_cmd/orchestrator_step.py

@@ -320,7 +320,7 @@ def create_orchestrator_config(
             artifact_base_path_line = f'base_path: "{artifact_base_path}"'
         elif artifact_type == "s3":
             s3_config_lines = ["bucket_name: ${S3_BUCKET_NAME}"]
-            s3_config_lines.append("endpoint_url: ${S3_ENDPOINT_URL:-}")
+            s3_config_lines.append("endpoint_url: ${S3_ENDPOINT_URL}")
             s3_config_lines.append("region: ${S3_REGION}")
             artifact_base_path_line = "\n      ".join(s3_config_lines)
 

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.10.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.10
+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.10.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=lYhzyMr99nO6RaZxhmvpN_nocmJHcw5nb5c2Jo_gWcY,13173
-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=6CyKDOuQJ4b0vibAFlOHq2bDQoQglqX0NDxWUXAhqUs,15178
+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=WCR-6aXXvi4kHlaMAYnHT-VzLSifo-1Btos9idb9SM8,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
@@ -200,7 +200,7 @@ solace_agent_mesh/cli/commands/eval_cmd.py,sha256=o1HuXKodwh_XH7AFPuXlRDMP0A75uQ
 solace_agent_mesh/cli/commands/run_cmd.py,sha256=vgR6UDaZ_f7H95cr5_8XCh0ifGp2z0E9CZaaJ2xR5lM,7437
 solace_agent_mesh/cli/commands/add_cmd/__init__.py,sha256=IGTXUx_AcoinYlzlZtQsjiCYbe76ZiLqxAcGc6-uoDE,280
 solace_agent_mesh/cli/commands/add_cmd/add_cmd_llm.txt,sha256=x-UE5buoIEE_oUJ3opOzW8U33S3XUKCRNKWxNXNVk-c,10212
-solace_agent_mesh/cli/commands/add_cmd/agent_cmd.py,sha256=J4Th6KKGOpvXA0zg9StbV6I1OrYLy1Sy0mezoMMQca8,29953
+solace_agent_mesh/cli/commands/add_cmd/agent_cmd.py,sha256=TUsbHfA7pgCNrXn941szSDh8pWtDYKs1JX6RbF7gVoA,29951
 solace_agent_mesh/cli/commands/add_cmd/gateway_cmd.py,sha256=kV7XOo2CvYWPQ6AL8cLDm-2GACbLAUlQc2c9fNzybEY,12840
 solace_agent_mesh/cli/commands/add_cmd/web_add_agent_step.py,sha256=niutiDp5neHtgEEtWKcK9TGLJHga87y46rrjVHdjkFU,3702
 solace_agent_mesh/cli/commands/add_cmd/web_add_gateway_step.py,sha256=Gk6Mw54l_M9QJKBa0IkHOkKJmuTsb4HQkIUTyVN-tqE,4326
@@ -210,7 +210,7 @@ solace_agent_mesh/cli/commands/init_cmd/database_step.py,sha256=sO52x4weVPpwyICn
 solace_agent_mesh/cli/commands/init_cmd/directory_step.py,sha256=3uPZybhDh84vtXqFfck4__6Dbi9LdqXqs0nRjP3VApY,862
 solace_agent_mesh/cli/commands/init_cmd/env_step.py,sha256=D3AnwnfJwH-QWQbbE6O-Mv0xuuepJ840wbeD5f7d6JA,7340
 solace_agent_mesh/cli/commands/init_cmd/init_cmd_llm.txt,sha256=mCUzKbriK0FSdsRvBANLac50x8t39gT0D3jS-4Zirjc,13226
-solace_agent_mesh/cli/commands/init_cmd/orchestrator_step.py,sha256=ZHqz2qjNosJ3WnzHm5eDLSoC1xjh10AjrEfZ1wUcAYY,20014
+solace_agent_mesh/cli/commands/init_cmd/orchestrator_step.py,sha256=Gm8yLGEE2J4jyCCgWOoVJncmx9U8qE1xyfOBlRET7AA,20012
 solace_agent_mesh/cli/commands/init_cmd/project_files_step.py,sha256=bOh7yYuaXIIs0q3-nd1nSVc6P6g6EHoDJjFDlKZVnf4,1352
 solace_agent_mesh/cli/commands/init_cmd/web_init_step.py,sha256=YoHEiEMZf_ZPG1qvLMJads_ET6IYEKJCCCees5_tqbY,4197
 solace_agent_mesh/cli/commands/init_cmd/webui_gateway_step.py,sha256=MIAu-tbbfDIcTrU7ZEVkvI91UdrX4QcY17JHCdzIH0c,8820
@@ -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=yiyQLi78zF-r07QWu6CNMSwA81B00xe_bXULwCaDLXE,11750
-solace_agent_mesh/assets/docs/lunr-index-1759415743783.json,sha256=FDhm_Alk7iI9xm74AzbMprlNG_yP8Qz6jgQ70y8GE7c,1202036
-solace_agent_mesh/assets/docs/lunr-index.json,sha256=FDhm_Alk7iI9xm74AzbMprlNG_yP8Qz6jgQ70y8GE7c,1202036
-solace_agent_mesh/assets/docs/search-doc-1759415743783.json,sha256=XxlH-uBaFNz9q2uYm4Hnrcqb9T1qkgABMzi-gqrBcwk,425790
-solace_agent_mesh/assets/docs/search-doc.json,sha256=XxlH-uBaFNz9q2uYm4Hnrcqb9T1qkgABMzi-gqrBcwk,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.cead6719.js,sha256=QdcJSqdfZrxXdJVpJ1pmhydmLezWc1ohr0Ohc_XLgUY,484008
-solace_agent_mesh/assets/docs/assets/js/main.cead6719.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=2cGXuGZ7BNrexXFWkkV0SaiMk5Vegoz0KS6yiS0tCk4,34112
-solace_agent_mesh/assets/docs/docs/documentation/Enterprise/rbac-setup-guilde/index.html,sha256=hgYww7KK_8d4Mox817IHqi5pfek6JOp4xB9jI2_4b-4,84679
-solace_agent_mesh/assets/docs/docs/documentation/Enterprise/single-sign-on/index.html,sha256=D-RlsyE9f7GOBcBqC0t_Bpx1cBUmrjeK9grQKywc7HI,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=Kaz-R4-C4gtiA2IGpqZpvdXxXQapL9AABHORaHz9Aas,85247
-solace_agent_mesh/assets/docs/docs/documentation/Migrations/A2A Upgrade To 0.3.0/a2a-technical-migration-map/index.html,sha256=bWuRkDlRdug2MYrLhpptyD9IqEdF-s8A65SVGN-l2Rs,88082
-solace_agent_mesh/assets/docs/docs/documentation/concepts/agents/index.html,sha256=0AKsq6OroVzD-cp_ahgfrVq6Os11xfqm-bZGeozB020,40163
-solace_agent_mesh/assets/docs/docs/documentation/concepts/architecture/index.html,sha256=32p5rD1KnuFHZM-bFVcAM9hrf_j3a6H2QQ5MyjBujnY,33033
-solace_agent_mesh/assets/docs/docs/documentation/concepts/cli/index.html,sha256=QN2yQhNoC2I3IIWaUbqKNjnzGMMSRYx9WQJak3LCgOc,52978
-solace_agent_mesh/assets/docs/docs/documentation/concepts/gateways/index.html,sha256=wKQyAIzCR_uZyYShN6h25lpWavQALYH_XaEr_1gxSJc,30474
-solace_agent_mesh/assets/docs/docs/documentation/concepts/orchestrator/index.html,sha256=n9pH-QSLOQKg1yDCkffOglOmeepcWxMV0VHRixdlhSc,24175
-solace_agent_mesh/assets/docs/docs/documentation/concepts/plugins/index.html,sha256=_n-SZ7ndox_YnsKaxDrjLGfsU-FyRv3J0X6Nu_Mqjv4,40351
-solace_agent_mesh/assets/docs/docs/documentation/deployment/debugging/index.html,sha256=g5SKNCzkYFpMMmu0FsL6AN1KJexNifk3P9d_XK2Zi0E,45952
-solace_agent_mesh/assets/docs/docs/documentation/deployment/deploy/index.html,sha256=AA4hC93Kfd-ul45nXts5FhyZ8X7q5QGVLF1Vj3j1kPs,42859
-solace_agent_mesh/assets/docs/docs/documentation/deployment/observability/index.html,sha256=zLDBiemjiFuuajDqqEOh04BgcbY3yiZc64Wz-5oGp5U,26411
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/component-overview/index.html,sha256=GVDGLQmfYu4Nk8MRMuJ1YrcuBDTjLNehyPA-8w3lrrI,22065
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/configurations/index.html,sha256=ag4GSDKc035BJOfNhcNq7_3wsRoiV56TFv3g33RLNyU,58707
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/configurations/litellm_models/index.html,sha256=PC3SzBqKiyS907Nhkq4DulB100ny_ALeqBOwyo9oPGU,38568
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/installation/index.html,sha256=mqdTlKwTcJavjga528C1KJu1zF_bLf4xQlecel_pHz8,32919
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/introduction/index.html,sha256=rFxZCBAnVOkqOpXAcO0AOIycNga2eWY4FJ2vcT6iVM8,30820
-solace_agent_mesh/assets/docs/docs/documentation/getting-started/quick-start/index.html,sha256=GD4SUUM79iCvR6u0zk53f4j7PGUjFckEFIJUnMgJmyk,42986
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/bedrock-agents/index.html,sha256=cVOHEPPTox47GYTAic7bqwo-K_xsioL-eL4wjXtB1Fg,76108
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/custom-agent/index.html,sha256=YHHokZyz7y8rsf1yBEOtR2gv5HQ1S83a2nmn3txtJYI,383717
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/event-mesh-gateway/index.html,sha256=DsHQisSLz9t8fzBjlHsvrkVt9hmSKlWptkCyLFDLvHs,69566
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/mcp-integration/index.html,sha256=MJCm0V89LuBNTNADQXWRxMGjRXU6r205sJYAO-OG58w,65370
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/mongodb-integration/index.html,sha256=tjoUA8ehUeCEyd_FQpJFgNOrfbWOE0zMdiIawgZbu_o,87988
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/rag-integration/index.html,sha256=8cgRarqcWnB9yh9E56p7YNAoScmPyl3DlAgVRNnsMRY,80798
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/rest-gateway/index.html,sha256=FoNxYJiZSa4F8Bqe8doroTxyL6QC86UYxsIy6vIhXT0,47079
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/slack-integration/index.html,sha256=IF0u9DP9Biu2OnYFKWSfCDi8JvahMcnPVyhXEHO9UkU,50308
-solace_agent_mesh/assets/docs/docs/documentation/tutorials/sql-database/index.html,sha256=2UKIGSs_8nlPP0DErjUEfIj9kdY2IMrDwer6Gp4X9B4,69693
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/index.html,sha256=Dmx5Zv7YLwfreSWMWUr0VXrccfpP2t41RtCaWReyIPk,45168
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/artifact-management/index.html,sha256=Hh5uavUUumIUsoi1gIuWHuczwR-bm9u8TtiMSVU9v5w,35138
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/audio-tools/index.html,sha256=fAp-zzWO_gmO1Z-m40IMsnx3TKW7r_19fxlHblSmNp4,58575
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/data-analysis-tools/index.html,sha256=fPDwDCmSKC6o5yKy3d3Z6vtJlpl1d5rsHhaIPu6rfzk,38124
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/builtin-tools/embeds/index.html,sha256=KRsR8JO7U_VBLWK_jSWiod_aM93SEWuPWRnNPuK0jRw,51022
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/create-agents/index.html,sha256=5sibflJbBRQnWARvzVu4TnG55CO32Mk0hxPktsOmx1k,163874
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/create-gateways/index.html,sha256=nFxafs77_C2pMD4qcRWi_eB4c1jcTxfDXreOpBqibck,403273
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/creating-python-tools/index.html,sha256=_HauyC6q9hT9ans3x5hMILoAZgUoxTNARB_7KwceOuA,175980
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/creating-service-providers/index.html,sha256=8tcksA8f9LsnTLKcWBHpz-BFQhJg7msyJQaKSvoOwU0,60060
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/solace-ai-connector/index.html,sha256=wFcOwXp0ebtDWBiG8OH7KU_078SVNTy9i4ohhOQ6gWI,26175
-solace_agent_mesh/assets/docs/docs/documentation/user-guide/structure/index.html,sha256=Zfs56L8LsNmBE5ceec6luk4BwQLCqnDAUA-aprTAzqs,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.10.dist-info/METADATA,sha256=mN2jczWRYsNXO-Pt57Gh0iXgu9WGz0TxL3uqqPJgi7c,24926
-solace_agent_mesh-1.4.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-solace_agent_mesh-1.4.10.dist-info/entry_points.txt,sha256=5pLVH8d8bd4sxUwBh7VTni8gTTSzTqGfY14zgdQZm1I,106
-solace_agent_mesh-1.4.10.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-solace_agent_mesh-1.4.10.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)}}}]);