kuadrant

Kuadrant MCP Server is a specialized MCP server that generates Kuadrant policy manifests to drive Gateway/API-related resources for Kubernetes via the Kuadrant ecosystem. It provides a set of tools (via the MCP client integration) to create Gateway manifests, HTTPRoute resources, DNS policies, TLS policies, rate limiting (including token-based rate limits), and authentication policies. You can pair this MCP server with an MCP client like Claude to generate and deploy policies in a single workflow, and optionally combine it with the mcp-server-kubernetes integration for applying those resources to a cluster. The included Tools section lists commands you can invoke to produce the various Kuadrant resource manifests, such as create_gateway, create_httproute, create_dnspolicy, create_tlspolicy, create_ratelimitpolicy, create_tokenratelimitpolicy, and create_authpolicy, along with guidance on how to specify rate limits (using limit and window).

To get started, add the Kuadrant MCP server to your environment, verify it’s available, and start using Claude to generate manifests. The Quick Start section in the README demonstrates adding the server and validating the setup, and the MCP Client Configuration example shows how to configure Claude to target the Docker-based Kuadrant MCP server. Once active, you can issue prompts to generate the appropriate Kuadrant resources and, if desired, deploy them with the Kubernetes integration workflow.

Prerequisites:

• Docker installed and running (recommended for this server).
• Internet access to pull the Kuadrant MCP Server image (ghcr.io/kuadrant/kuadrant-mcp-server:latest).
• Optional: Go toolchain if you want to build locally from source.

Install methods:

1. Using Docker (recommended):

# Pull the latest Kuadrant MCP Server image
docker pull ghcr.io/kuadrant/kuadrant-mcp-server:latest

# Run the MCP server (stdio transport by default)
docker run -i --rm ghcr.io/kuadrant/kuquadrant-mcp-server:latest

2. From source (Go):

# Install Go (if not already installed)
# Then clone and build
git clone https://github.com/kuadrant/kuadrant-mcp-server
cd kuadrant-mcp-server

# Build the binary
go build -o kuadrant-mcp-server

# Run locally
./kuadrant-mcp-server

3. Go install (if you have module proxy access):

go install github.com/kuadrant/kuadrant-mcp-server@latest

Notes:

• When running with Docker, you can append transport options (stdio is default) as needed, for example to use SSE or HTTP transports if the image ships with those capabilities.
• If you use Claude or another MCP client, ensure the client configuration points to the correct server endpoint and that authentication/permissions are aligned with your environment.

Tips and common considerations:

• The Kuadrant MCP Server generates manifests for Gateway, HTTPRoute, DNSPolicy, TLSPolicy, RateLimitPolicy, TokenRateLimitPolicy, and AuthPolicy resources. Familiarize yourself with the Kuadrant API references referenced in the Resources section of the README for precise fields and capabilities.
• When configuring rate limits, use the standard fields per policy (e.g., { "limit": 100, "window": "60s" }). The examples in the README illustrate typical usage.
• If you plan to deploy through Kubernetes, pair the Kuadrant MCP Server with mcp-server-kubernetes as shown in the Kubernetes Integration section to automate policy generation and deployment.
• Ensure environment variables required by your deployment are set, such as network addresses, ports, and any authentication endpoints if you integrate with external identity providers.
• If you encounter issues pulling the image from GHCR, verify Docker daemon permissions and your network egress to ghcr.io; consider using a registry mirror or proxy in restricted environments.