Skip to content

OCPBUGS-90079: Updated the MCP Server examples with multiple fixes #113895

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
dfitzmau wants to merge 1 commit into
base: main
Choose a base branch
from
+39 −13
Open

OCPBUGS-90079: Updated the MCP Server examples with multiple fixes #113895

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions modules/ai-app-mcp-server-configure-gateway.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ spec:
- group: gateway.networking.k8s.io
kind: Gateway
name: mcp-gateway
namespace: gateway-system
namespace: gateway-namespace
sectionName: mcp
hostnames:
- ${MCP_SERVER_HOST}
Expand Down Expand Up @@ -63,7 +63,7 @@ metadata:
name: my-mcp-server-reg
namespace: openshift-mcp-server
spec:
toolPrefix: "openshift_"
prefix: "openshift_"
targetRef:
group: "gateway.networking.k8s.io"
kind: "HTTPRoute"
Expand Down Expand Up @@ -108,14 +108,14 @@ $ oc describe mcpsr my-mcp-server-reg -n openshift-mcp-server
+
[source,terminal]
----
$ oc logs -n mcp-system deployment/mcp-gateway-controller
$ oc logs -n gateway-namespace deployment/mcp-gateway-controller
----

. Check the broker logs for tool discovery by running the following command:
+
[source,terminal]
----
$ oc logs -n mcp-system deployment/mcp-gateway-broker-router
$ oc logs -n gateway-namespace deployment/mcp-gateway
----

. Verify that your MCP server tools are available through the MCP gateway:
Expand Down
25 changes: 25 additions & 0 deletions modules/ai-app-mcp-server-install-helm.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,34 @@ To install the Model Context Protocol (MCP) server for Red Hat {product-title} f
.Prerequisites

* Access to OpenShift console with admin rights.
* Helm CLI is installed.
* {oc-first} is installed.

.Procedure

. Add the Red Hat OpenShift Helm chart repository to you local client by entering the following command:
+
[source,terminal]
----
$ helm repo add openshift-helm-charts https://charts.openshift.io/
----
+
A confirmation message indicates that the repository `openshift-helm-charts` has been successfully added to the client.

. Update your local Helm chart registry to retrieve the latest version information and metadata for the MCP server chart:
+
[source,terminal]
----
$ helm repo update
----
+
The following output indicates a successful update of the `openshift-helm-charts` repository:
+
[source,terminal]
----
Successfully got an update from the "openshift-helm-charts" repository
----

. Install the MCP server for Red Hat {product-title} Helm chart by running one of the following commands:
+
* For read-only access (recommended for most use cases):
Expand Down
6 changes: 3 additions & 3 deletions modules/ai-app-mcp-server-setup-authentication.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,13 +44,13 @@ apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
name: mcp-gateway-oauth-metadata
namespace: mcp-system
namespace: gateway-namespace
spec:
parentRefs:
- group: gateway.networking.k8s.io
kind: Gateway
name: mcp-gateway
namespace: gateway-system
namespace: gateway-namespace
sectionName: mcp
hostnames:
- ${MCP_GATEWAY_HOST}
Expand Down Expand Up @@ -115,7 +115,7 @@ apiVersion: kuadrant.io/v1
kind: AuthPolicy
metadata:
name: mcp-auth-policy
namespace: mcp-system
namespace: gateway-namespace
spec:
targetRef:
group: gateway.networking.k8s.io
Expand Down
13 changes: 7 additions & 6 deletions modules/ai-app-mcp-server-verify-deployment.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@ To install the Model Context Protocol (MCP) server for Red Hat {product-title} f

.Prerequisites

* Access to OpenShift console with admin rights.
* Access to {product-title} console with admin rights.

* The MCP server Helm chart is installed.
* MCP-compatible client connected.
* MCP gateway is installed.
Expand All @@ -22,12 +23,12 @@ To install the Model Context Protocol (MCP) server for Red Hat {product-title} f
+
[source,terminal]
----
$ oc get pods -n mcp-system -l "app.kubernetes.io/instance=mcp-gateway"
$ oc get pods -n gateway-namespace -l "app.kubernetes.io/name=mcp-gateway"
----
+
[NOTE]
====
This example uses the namespace "mcp-system" for installing the gateway. If you install the gateway in a different namespace than "mcp-system", use that namespace instead throughout the procedure.
This example uses the namespace "gateway-namespace" for installing the gateway. If you install the gateway in a different namespace than "gateway-namespace", use that namespace instead throughout the procedure.
====
+
.Example
Expand All @@ -48,15 +49,15 @@ $ oc get mcpgatewayextension -A
+
[source,terminal]
----
NAMESPACE NAME READY AGE
mcp-system mcp-gateway 105s
NAMESPACE NAME READY AGE
gateway-namespace mcp-gateway 105s
----

. Verify the broker-router deployment by running the following command:
+
[source,terminal]
----
$ oc logs -n mcp-system deployment/mcp-gateway-broker-router
$ oc logs -n gateway-namespace deployment/mcp-gateway
----

. Verify EnvoyFilter was created in the gateway namespace by running the following command:
Expand Down