mcp-redhat-kb by jeanlopezxyz - MCP Server

Red Hat Knowledge Base MCP Server

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

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

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

- Free to use, modify, and distribute.