jeanlopezxyz/mcp-redhat-kb
If you are the rightful owner of mcp-redhat-kb and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
The Red Hat Knowledge Base MCP Server is a tool designed to facilitate the search and retrieval of information from the Red Hat Knowledge Base using the Model Context Protocol.
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 Claude Desktop, Claude Code, Cursor, VS Code |
| SSE | Server-Sent Events over HTTP | Standalone server, web integrations, multiple clients |
Table of Contents
Requirements
- Java 21+ - Download
- Red Hat API Token - Generate here
Installation
Quick Install (Claude Code CLI)
claude mcp add redhat-kb -e REDHAT_TOKEN="your-token-here" -- npx -y mcp-redhat-kb@latest
Claude Code
Add to ~/.claude/settings.json:
{
"mcpServers": {
"redhat-kb": {
"command": "npx",
"args": ["-y", "mcp-redhat-kb@latest"],
"env": {
"REDHAT_TOKEN": "your-token-here"
}
}
}
}
Claude Desktop
Add to claude_desktop_config.json:
{
"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 2 tools for searching Red Hat Knowledge Base:
searchKnowledgeBase
Search Red Hat Knowledge Base for articles and solutions.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search keywords (use error messages for best results) |
maxResults | integer | No | Maximum results to return (default: 10) |
product | string | No | Product filter (e.g.: OpenShift, RHEL) |
documentType | string | No | Type: Solution, Documentation, Article |
Returns: List of matching articles with ID, title, URL, and summary.
Examples:
- Search for error:
searchKnowledgeBase query='CrashLoopBackOff openshift' - Filter by type:
searchKnowledgeBase query='etcd timeout' documentType='Solution' - Filter by product:
searchKnowledgeBase query='authentication error' product='OpenShift'
getSolution
Get the full content of a solution or article from the Red Hat Knowledge Base.
| Parameter | Type | Required | Description |
|---|---|---|---|
solutionId | string | Yes | Solution ID from search results (e.g.: 7129807) |
Returns: Full article content including environment, issue, root cause, diagnostic steps, and resolution.
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
Related Projects
- mcp-redhat-cases - MCP Server for Red Hat Support Cases
License
- Free to use, modify, and distribute.