MCPGateway
MCPGateway is the Schema for the mcpgateways API. It defines a gateway that routes MCP traffic to backend servers.
Spec
| Field | Description | Default | Validation |
|---|---|---|---|
apiVersion string | mcp-gateway.ohcs.io/v1alpha1 | ||
kind string | MCPGateway | ||
metadata ObjectMeta | Refer to Kubernetes API documentation for fields of metadata. | ||
spec MCPGatewaySpec | spec defines the desired state of MCPGateway. | Required | |
status MCPGatewayStatus | status defines the observed state of MCPGateway. |
MCPGatewaySpec
| Field | Description | Default | Validation |
|---|---|---|---|
domain string | domain is the base domain for MCP server endpoints (e.g., “mcp.example.com”). All MCPRemoteServer and MCPContainerServer resources referencing this gateway will be accessible under this domain. | MinLength: 1, Required | |
replicas integer | replicas is the number of gateway proxy replicas to run. | 1 | Minimum: 1 |
image string | image is the container image for the gateway proxy. If not specified, uses MCP_GATEWAY_IMAGE env var from operator, or defaults to latest. | ||
resources ResourceRequirements | resources defines compute resources for the gateway proxy containers. | ||
ingressClassName string | ingressClassName is the name of the IngressClass to use for the gateway Ingress. | ||
tls TLSConfig | tls configures TLS for the gateway. | ||
nodeSelector object (keys:string, values:string) | nodeSelector is a selector for nodes to run the gateway proxy on. | ||
tolerations Toleration array | tolerations are tolerations for the gateway proxy pods. | ||
affinity Affinity | affinity is the affinity configuration for the gateway proxy pods. | ||
authSecretRef LocalObjectReference | authSecretRef references a Secret containing the AUTH_TOKEN for gateway authentication. The Secret must have a key named “token”. |
MCPGatewayStatus
| Field | Description | Default | Validation |
|---|---|---|---|
phase string | phase represents the current phase of the MCPGateway. | ||
conditions Condition array | conditions represent the current state of the MCPGateway resource. | ||
activeServers integer | activeServers is the count of active MCP servers routing through this gateway. | ||
endpoint string | endpoint is the URL where the gateway is accessible (e.g., “https://mcp.example.com”). | ||
ready boolean | ready indicates whether the gateway is ready to accept traffic. | ||
deploymentName string | deploymentName is the name of the Deployment created for the gateway. | ||
serviceName string | serviceName is the name of the Service created for the gateway. | ||
ingressName string | ingressName is the name of the Ingress created for the gateway. | ||
configMapName string | configMapName is the name of the ConfigMap containing gateway routing configuration. |
Supporting Types
TLSConfig
TLSConfig defines TLS configuration for the gateway.
| Field | Description | Default | Validation |
|---|---|---|---|
enabled boolean | enabled specifies whether TLS is enabled. | true | |
secretName string | secretName is the name of the TLS secret containing tls.crt and tls.key. | ||
clusterIssuer string | clusterIssuer is the name of the cert-manager ClusterIssuer to use for certificate generation. |