# Crossplane

Connects your coding assistant to a Crossplane control plane to inspect claims, packages, and compositions. Helps pinpoint root causes when infrastructure provisioning fails.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: ravibagri5
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ravibagri5/crossplane-mcp-server
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/crossplane

## What it does

The server queries Kubernetes resources using Crossplane categories like `managed`, `composite`, and `claim`. It follows `resourceRefs` to reconstruct complete dependency trees similar to running trace commands. When a claim fails, `crossplane_diagnose` reports the exact low-level issue instead of a generic top-level error.

Safety is enforced by default. The server operates in read-only mode, completely omitting mutation tools unless started with `--read-only=false`. Deletion operations are impossible in either mode, preventing accidental destruction of live infrastructure. It works across Crossplane v1 and v2 layouts.

You can inspect drift between observed and desired configurations using `crossplane_drift_detect`. To inspect stuck deletions, `crossplane_deleting_resources` spots blocking finalizers. The `crossplane_composition_render` tool evaluates function pipelines offline before committing changes to Kubernetes.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add crossplane -- docker run -i --rm ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5
```

### Codex

**Platform CLI**
```bash
codex mcp add crossplane -- docker run -i --rm ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "crossplane": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "crossplane": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add crossplane docker run -i --rm ghcr.io/ravibagri5/crossplane-mcp-server:0.1.5
```

## When to use it
- pinpoint root causes of failing claims and composite resources
- trace dependency graphs through `resourceRefs`
- detect infrastructure drift against observed cloud state
- test composition functions offline without touching the cluster

## Example prompts
- Why is the PostgreSQLInstance app-db failing to reconcile?
- Show the full resource tree for my storage claim
- Identify which finalizer is blocking the deletion of redis-cluster

## Similar
- [platform-engineering](https://affpapa.org/en/nevibecode/skills/platform-engineering.md) — skill · 322 installs
- [devops-engineer](https://affpapa.org/en/nevibecode/skills/devops-engineer.md) — skill · 11200 installs
- [k8s-manifest-generator](https://affpapa.org/en/nevibecode/skills/k8s-manifest-generator.md) — skill · 11166 installs
- [aws-containers](https://affpapa.org/en/nevibecode/skills/aws-containers.md) — skill · 9400 installs
- [gke-workload-security](https://affpapa.org/en/nevibecode/skills/gke-workload-security.md) — skill · 5000 installs
- [tempo](https://affpapa.org/en/nevibecode/skills/tempo.md) — skill · 4900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md