Red Hat Knowledge Base MCP Server

A Model Context Protocol (MCP) server for searching the Red Hat Knowledge Base (Hydra API).

Built with Quarkus MCP Server.

Transport Modes

This server supports two MCP transport modes:

Mode	Description	Use Case
stdio	Standard input/output communication	Default for VS Code, Cursor, Windsurf
SSE	Server-Sent Events over HTTP	Standalone server, web integrations, multiple clients

Table of Contents

• Transport Modes
• Requirements
• Installation
• Configuration
• Tools
• Examples
• Development
• Related Projects

---

Requirements

• Java 21+ - Download
• Red Hat API Token - Generate here

---

Installation

npx

npx -y mcp-redhat-kb@latest

MCP Client Configuration

Add to your MCP client configuration (VS Code, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "redhat-kb": {
      "command": "npx",
      "args": ["-y", "mcp-redhat-kb@latest"],
      "env": {
        "REDHAT_TOKEN": "your-token-here"
      }
    }
  }
}

VS Code

code --add-mcp '{"name":"redhat-kb","command":"npx","args":["-y","mcp-redhat-kb@latest"],"env":{"REDHAT_TOKEN":"your-token-here"}}'

Cursor

Add to mcp.json:

{
  "mcpServers": {
    "redhat-kb": {
      "command": "npx",
      "args": ["-y", "mcp-redhat-kb@latest"],
      "env": {
        "REDHAT_TOKEN": "your-token-here"
      }
    }
  }
}

Windsurf

Add to MCP configuration:

{
  "mcpServers": {
    "redhat-kb": {
      "command": "npx",
      "args": ["-y", "mcp-redhat-kb@latest"],
      "env": {
        "REDHAT_TOKEN": "your-token-here"
      }
    }
  }
}

Goose CLI

Add to config.yaml:

extensions:
  redhat-kb:
    command: npx
    args:
      - -y
      - mcp-redhat-kb@latest
    env:
      REDHAT_TOKEN: your-token-here

Docker

docker run -e REDHAT_TOKEN="your-token" ghcr.io/jeanlopezxyz/mcp-redhat-kb:latest

SSE Mode

Run as standalone server:

REDHAT_TOKEN="your-token" npx mcp-redhat-kb --port 9081

Endpoint: http://localhost:9081/mcp/sse

---

Configuration

Command Line Options

Option	Description
--port <PORT>	Start in SSE mode on specified port
--help	Show help message
--version	Show version

Environment Variables

Variable	Description	Required
REDHAT_TOKEN	Red Hat API offline token	Yes

---

Tools

This server provides 5 tools for searching Red Hat Knowledge Base:

Search

searchKnowledgeBase

Search Red Hat Knowledge Base for solutions and articles. Use error messages or technical keywords.

Parameter	Type	Required	Description
query	string	Yes	Search keywords
maxResults	integer	No	Max results 1-50 (default: 10)
product	string	No	Filter: OpenShift, RHEL
documentType	string	No	Type: Solution, Documentation, Article

getSolution

Get full content of a Knowledge Base article. Use article ID from search results.

Parameter	Type	Required	Description
solutionId	string	Yes	Article ID (numeric)

---

Troubleshooting

troubleshootError

Search for solutions to an error message. Optimized for troubleshooting.

Parameter	Type	Required	Description
errorMessage	string	Yes	Error message to search
product	string	No	Product (default: OpenShift)

findSolutionForAlert

Find KB solutions for a Prometheus/OpenShift alert name.

Parameter	Type	Required	Description
alertName	string	Yes	Alert name (e.g., KubePodCrashLooping)
product	string	No	Product (default: OpenShift)

searchDocumentation

Search Red Hat documentation for how-to guides and best practices.

Parameter	Type	Required	Description
topic	string	Yes	Topic to search
product	string	No	Product (default: OpenShift)

---

Example Prompts

Use natural language to search the Knowledge Base:

"Search knowledge base for CrashLoopBackOff"
"Find solutions for etcd timeout errors"
"Search KB for oauth authentication error in OpenShift"
"Get the full solution for article 7129807"
"Find documentation about OpenShift networking"
"Search for RHEL storage issues"

---

Development

Run in dev mode

export REDHAT_TOKEN="your-token"
./mvnw quarkus:dev

Build

./mvnw package -DskipTests

Test with MCP Inspector

# stdio mode
REDHAT_TOKEN="your-token" npx @modelcontextprotocol/inspector npx mcp-redhat-kb

# SSE mode
REDHAT_TOKEN="your-token" npx mcp-redhat-kb --port 9081
# Then connect inspector to http://localhost:9081/mcp/sse

---

Kubernetes / OpenShift Deployment

Container Image

The container image is available on GitHub Container Registry:

ghcr.io/jeanlopezxyz/mcp-redhat-kb:latest

Helm Chart

Deploy using the included Helm chart:

# Create secret with Red Hat token
kubectl create secret generic mcp-redhat-kb-secrets \
  --namespace mcp-servers \
  --from-literal=REDHAT_TOKEN=your-token-here

# Deploy with Helm
helm upgrade --install mcp-redhat-kb ./charts/mcp-redhat-kb \
  --namespace mcp-servers \
  --create-namespace \
  --set openshift=true \
  --set redhat.existingSecret=mcp-redhat-kb-secrets

Helm Values

Parameter	Description	Default
image.registry	Container registry	ghcr.io
image.repository	Image repository	jeanlopezxyz/mcp-redhat-kb
image.version	Image tag	latest
openshift	Enable OpenShift Routes	false
service.port	Service port	8080
redhat.existingSecret	Name of existing secret with REDHAT_TOKEN	""
redhat.token	Red Hat API token (if not using existingSecret)	""

Example with inline token (not recommended for production)

helm upgrade --install mcp-redhat-kb ./charts/mcp-redhat-kb \
  --namespace mcp-servers \
  --set openshift=true \
  --set redhat.token=your-token-here

---

Related Projects

• mcp-redhat-cases - MCP Server for Red Hat Support Cases

---

License

MIT - Free to use, modify, and distribute.