crossplane-mcp-server

An MCP server that exposes Crossplane resources to any MCP-compatible AI agent. Lets agents inspect, debug, and manage XRs, compositions, providers, and managed resources and more through natural language.

---

Prerequisites

Requirement	Details
Kubernetes cluster	with Crossplane installed
kubectl	configured with cluster access
helm	>= 3
MCP-compatible agent	kagent(tested), Claude, etc.

---

Installation

Via Helm (from this repo)

helm install crossplane-mcp-server ./charts/crossplane-mcp-server \
  --namespace crossplane-system \
  --create-namespace

Via manifest

kubectl apply -f manifest.yaml

Via binary

go build -o bin/server cmd/server/main.go

---

Configuration

Edit charts/crossplane-mcp-server/values.yaml:

image:
  repository: ghcr.io/<your-org>/crossplane-mcp-server
  tag: latest

replicaCount: 1

---

Available Tools

Tool	Description
get_xr_tree	Full resource tree of a composite resource
list_xrs	List all composite resources
list_xrds	List all composite resource definitions
describe_xrd	Describe a specific XRD
validate_xr	Validate a composite resource against its XRD
debug_xr	Debug a composite resource
debug_mr	Debug a managed resource
debug_composition	Debug a composition
debug_provider	Debug a Crossplane provider
explain_composition	Explain what a composition does in plain language
get_managed_resource	Get details of a managed resource
dependency_graph	Generate a dependency graph for resources
provider_health	Check provider health status
check_provider_config	Validate a provider config
events	Fetch Kubernetes events for a resource
condition	Get conditions of a resource
annotate_reconcile	Trigger reconciliation via annotation

---

Development

Requires Taskfile.

task --list       # see all available tasks
task build        # build the binary
task test         # run tests
task run          # run locally

Build the Docker image:

docker build -t crossplane-mcp-server .

---

Repository Structure

.
├── charts/crossplane-mcp-server/   # Helm chart
├── cmd/server/                     # Server entrypoint
├── internal/
│   ├── logging/                    # Structured logging
│   ├── metrics/                    # Metrics instrumentation
│   └── tools/                      # Tool registration and Kubernetes clients
├── tools/                          # MCP tool implementations
├── Dockerfile
├── manifest.yaml                   # Raw Kubernetes manifest
└── Taskfile.yml

---

Helm Chart Releases

Packaged charts are in docs/ and served as a Helm repo. To use:

helm repo add crossplane-mcp-server https://shilucloud.github.io/crossplane-mcp-server
helm repo update