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:

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

Environment Variables

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.

getSolution

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

Troubleshooting

troubleshootError

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

findSolutionForAlert

Find KB solutions for a Prometheus/OpenShift alert name.

searchDocumentation

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

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

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.