From b856e22b8cec265d4412a42e804a1f087bd43126 Mon Sep 17 00:00:00 2001 From: Roi Glinik Date: Wed, 21 May 2025 09:43:49 +0300 Subject: [PATCH 1/4] basic docs of how to set up remote mcp server --- docs/configuration/holmesgpt/index.rst | 8 ++++ .../holmesgpt/remote_mcp_servers.rst | 41 +++++++++++++++++++ 2 files changed, 49 insertions(+) create mode 100644 docs/configuration/holmesgpt/remote_mcp_servers.rst diff --git a/docs/configuration/holmesgpt/index.rst b/docs/configuration/holmesgpt/index.rst index 31afdfbd8..d53234e3f 100644 --- a/docs/configuration/holmesgpt/index.rst +++ b/docs/configuration/holmesgpt/index.rst @@ -10,6 +10,7 @@ AI Analysis builtin_toolsets permissions custom_toolsets + remote_mcp_servers Why use HolmesGPT? ^^^^^^^^^^^^^^^^^^^ @@ -371,3 +372,10 @@ Custom toolsets Custom toolsets are created through your Helm values file and you can find instructions to :doc:`write your own toolsets here `. + +Remote MCP servers +------------------- + +Remote MCP server connections are configured through your Helm values file. +For detailed instructions, refer to the :doc:`Connecting to Remote MCP Servers ` guide. + diff --git a/docs/configuration/holmesgpt/remote_mcp_servers.rst b/docs/configuration/holmesgpt/remote_mcp_servers.rst new file mode 100644 index 000000000..994ebdaf0 --- /dev/null +++ b/docs/configuration/holmesgpt/remote_mcp_servers.rst @@ -0,0 +1,41 @@ +Remote MCP Servers +===================== + +HolmesGPT can integrate with remote MCP servers using SSE mode. +This capability enables HolmesGPT to access external data sources and tools in real time. +This guide provides step-by-step instructions for configuring HolmesGPT to connect with remote MCP servers over SSE. + +Example : MCP server configuration +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. md-tab-set:: + + .. md-tab-item:: Robusta Helm Chart + + **Helm Values:** + + .. code-block:: yaml + + holmes: + toolsets: + mcp_server_1: + # human-readable description of the mcp server (this is not seen by the AI model - its just for users) + description: "Remote mcp server" + url: "http://example.com:8000/sse" + + mcp_server_2: + description: "MCP server that runs in my cluster" + url: "http://asdasdasd" + config: + headers: + key: "{{ env.my_mcp_server_key }}" # You can use holmes environment variables as headers for the MCP server requests. + + Update your Helm values with the provided YAML configuration, then apply the changes with Helm upgrade: + + .. code-block:: bash + + helm upgrade robusta robusta/robusta --values=generated_values.yaml --set clusterName= + + + + From 2fe4a2de4b633c44b6c909463327bd6b7daf401e Mon Sep 17 00:00:00 2001 From: Roi Glinik Date: Sun, 25 May 2025 11:45:35 +0300 Subject: [PATCH 2/4] add tech preview --- docs/configuration/holmesgpt/index.rst | 4 ++-- docs/configuration/holmesgpt/remote_mcp_servers.rst | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/configuration/holmesgpt/index.rst b/docs/configuration/holmesgpt/index.rst index d53234e3f..eeb562f76 100644 --- a/docs/configuration/holmesgpt/index.rst +++ b/docs/configuration/holmesgpt/index.rst @@ -373,8 +373,8 @@ Custom toolsets Custom toolsets are created through your Helm values file and you can find instructions to :doc:`write your own toolsets here `. -Remote MCP servers -------------------- +Remote MCP servers ⚠️ **Tech Preview** +----------------------------------------- Remote MCP server connections are configured through your Helm values file. For detailed instructions, refer to the :doc:`Connecting to Remote MCP Servers ` guide. diff --git a/docs/configuration/holmesgpt/remote_mcp_servers.rst b/docs/configuration/holmesgpt/remote_mcp_servers.rst index 994ebdaf0..f3fea8601 100644 --- a/docs/configuration/holmesgpt/remote_mcp_servers.rst +++ b/docs/configuration/holmesgpt/remote_mcp_servers.rst @@ -1,12 +1,12 @@ -Remote MCP Servers -===================== +Remote MCP Servers ⚠️ **Tech Preview** +========================================= HolmesGPT can integrate with remote MCP servers using SSE mode. This capability enables HolmesGPT to access external data sources and tools in real time. This guide provides step-by-step instructions for configuring HolmesGPT to connect with remote MCP servers over SSE. Example : MCP server configuration -^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. md-tab-set:: From a4b3f6dc482821b0cc451cd0363499a3e7d1e006 Mon Sep 17 00:00:00 2001 From: Roi Glinik Date: Mon, 26 May 2025 16:28:17 +0300 Subject: [PATCH 3/4] update docs to mcp_servers config --- docs/configuration/holmesgpt/index.rst | 8 ++++++-- docs/configuration/holmesgpt/remote_mcp_servers.rst | 11 ++++++++--- 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/docs/configuration/holmesgpt/index.rst b/docs/configuration/holmesgpt/index.rst index eeb562f76..2e54cb807 100644 --- a/docs/configuration/holmesgpt/index.rst +++ b/docs/configuration/holmesgpt/index.rst @@ -373,8 +373,12 @@ Custom toolsets Custom toolsets are created through your Helm values file and you can find instructions to :doc:`write your own toolsets here `. -Remote MCP servers ⚠️ **Tech Preview** ------------------------------------------ +Remote MCP servers +--------------------- + +.. warning:: + + Remote MCP servers are in **Tech Preview** stage. Remote MCP server connections are configured through your Helm values file. For detailed instructions, refer to the :doc:`Connecting to Remote MCP Servers ` guide. diff --git a/docs/configuration/holmesgpt/remote_mcp_servers.rst b/docs/configuration/holmesgpt/remote_mcp_servers.rst index f3fea8601..bed342e9b 100644 --- a/docs/configuration/holmesgpt/remote_mcp_servers.rst +++ b/docs/configuration/holmesgpt/remote_mcp_servers.rst @@ -1,5 +1,10 @@ -Remote MCP Servers ⚠️ **Tech Preview** -========================================= +Remote MCP Servers +==================== + +.. warning:: + + Remote MCP servers are in **Tech Preview** stage. + HolmesGPT can integrate with remote MCP servers using SSE mode. This capability enables HolmesGPT to access external data sources and tools in real time. @@ -17,7 +22,7 @@ Example : MCP server configuration .. code-block:: yaml holmes: - toolsets: + mcp_servers: mcp_server_1: # human-readable description of the mcp server (this is not seen by the AI model - its just for users) description: "Remote mcp server" From dc4b80dd091bf918e38d4bad865d23de9f3d11bc Mon Sep 17 00:00:00 2001 From: Roi Glinik Date: Tue, 27 May 2025 16:05:50 +0300 Subject: [PATCH 4/4] fix url --- docs/configuration/holmesgpt/remote_mcp_servers.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/holmesgpt/remote_mcp_servers.rst b/docs/configuration/holmesgpt/remote_mcp_servers.rst index bed342e9b..12f0dc15e 100644 --- a/docs/configuration/holmesgpt/remote_mcp_servers.rst +++ b/docs/configuration/holmesgpt/remote_mcp_servers.rst @@ -30,7 +30,7 @@ Example : MCP server configuration mcp_server_2: description: "MCP server that runs in my cluster" - url: "http://asdasdasd" + url: "http://..svc.cluster.local:" config: headers: key: "{{ env.my_mcp_server_key }}" # You can use holmes environment variables as headers for the MCP server requests.