errata-mcp

mabanas1/errata-mcp

3.2

If you are the rightful owner of errata-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server template provides a foundational setup for deploying and running MCP servers using containerization technologies like Podman or Docker.

Errata Tool MCP Server

FastMCP server for Red Hat Errata Tool integration with AI assistants.

Quick Start

# Build and run
./build-container.sh build
./build-container.sh run-sse

# Get interactive shell with working Kerberos
./build-container.sh interactive
kinit your_username@IPA.REDHAT.COM

# Test functions
python -c "from mcp_server import list_products; print(list_products())"
python -c "from mcp_server import get_advisory_info; print(get_advisory_info('149143'))"

Available Functions

  • list_products() - List available products (RHEL, RHIVOS, etc.)
  • list_states() - List advisory states (QE, SHIPPED_LIVE, etc.)
  • list_advisories(product, state, limit) - List advisories ⚠️ Limited access
  • get_advisory_info(advisory_id) - Get advisory details ⚠️ Requires auth

MCP Client Configuration

Add to your MCP client config (e.g., ~/.cursor/mcp.json):

{
  "mcpServers": {
    "errata-tool": {
      "command": "podman",
      "args": ["run", "-d", "--rm", "--name", "errata-mcp-sse", "-p", "8000:8000", 
               "-v", "/etc/krb5.conf:/etc/krb5.conf:ro", "--network", "host", 
               "localhost/errata-mcp:latest"],
      "transport": { "type": "sse", "url": "http://localhost:8000" }
    }
  }
}

Authentication

For advisory access, run inside container:

kinit your_username@IPA.REDHAT.COM

Troubleshooting

IssueFix
"Pigeon crap. Did it forget to run kinit?"Run kinit inside container
Container won't startCheck: podman --version, ./build-container.sh logs
SSE connection failsVerify: curl http://localhost:8000/sse/
Products/States work but advisories don'tRun kinit for authentication

Commands

./build-container.sh build       # Build image
./build-container.sh run-sse     # Run SSE server (port 8000)
./build-container.sh run-stdio   # Run stdio mode (for MCP clients)
./build-container.sh interactive # Open bash shell with working Kerberos
./build-container.sh shell       # Get shell in running container
./build-container.sh logs        # View logs
./build-container.sh stop        # Stop containers
./build-container.sh clean       # Remove all