FluxCD MCP Server

Created By
Stefan Prodana year ago
AI-Assisted GitOps for Kubernetes clusters managed by Flux CD
Overview

The Flux MCP Server connects AI assistants to Kubernetes clusters manged by Flux Operator, enabling seamless interaction through natural language. It serves as a bridge between AI tools and GitOps pipelines, allowing you to analyze deployment across environments, troubleshoot issues, and perform operations using conversational prompts.

Using AI assistants with the Flux MCP Server, you can:

  • Debug GitOps pipelines end-to-end from Flux resources to application logs
  • Get intelligent root cause analysis for failed deployments
  • Compare Flux configurations and Kubernetes resources between clusters
  • Visualize Flux dependencies with diagrams generated from the cluster state
  • Instruct Flux to perform operations using conversational prompts

Quickstart

Install the Flux MCP Server using Homebrew:

brew install controlplaneio-fluxcd/tap/flux-operator-mcp

For other installation options, refer to the installation guide.

Add the following configuration to your AI assistant's MCP settings:

{
  "flux-operator-mcp":{
    "command":"flux-operator-mcp",
    "args":[
      "serve",
      "--read-only=false"
    ],
    "env":{
      "KUBECONFIG":"/path/to/.kube/config"
    }
  }
}

Replace /path/to/.kube/config with the absolute path to your kubeconfig file, you can find it with: echo $HOME/.kube/config.

Copy the AI rules from instructions.md and place them into the appropriate file for your assistant.

Restart the AI assistant app and test the MCP Server with the following prompts:

  • "Which cluster contexts are available in my kubeconfig?"
  • "What version of Flux is running in my current cluster?"

For more information on how to use the MCP Server with Claude, Cursor, GitHub Copilot, and other assistants, please refer to the documentation website.

Documentation

License

The MCP Server is open-source and part of the Flux Operator project licensed under the AGPL-3.0.

Server Config

{
  "mcpServers": {
    "flux-operator-mcp": {
      "command": "flux-operator-mcp",
      "args": [
        "serve",
        "--read-only=false"
      ],
      "env": {
        "KUBECONFIG": "/path/to/.kube/config"
      }
    }
  }
}
Project Info
Created At
a year ago
Updated At
a year ago
Author Name
Stefan Prodan
Star
-
Language
-
License
-
Category

Recommend Servers

View All
Voyei

3 hours ago
AI Work Market — USDC settlement rails for AI labor on Base Mainnet)
@Dario (DME)

AI Work Market is a USDC escrow protocol on Base Mainnet, designed for autonomous AI agents to find work, post jobs, and settle payments without humans in the loop. This MCP server exposes 10 tools: **Escrow lifecycle** - `create_intent_quote` — get calldata + gas estimate for funding a new escrow intent - `submit_proof_quote` — get calldata for the seller to submit a proof URI - `release_funds_quote` — get calldata for the buyer to release payment (or claim/refund) **x402 single-call binding** - `x402_consume` — replaces the 5-step x402 flow with one HMAC-signed POST that returns a delivery URL **Onboarding & discovery** - `agent_onboard` — generate a signed agent card with marketplace attestation - `agent_search` — tf-idf search over the live agent catalog - `agent_reputation` — server-side reputation from on-chain Released/Refunded/Disputed events **Live state** - `system_status` — live on-chain state (nextIntentId, accumulatedFees, contract balance, owner) - `escrow_rules` — contract semantics, lifecycle, call guides, failure modes - `events_subscribe` — SSE stream of new on-chain intent events All endpoints are serverless (Vercel) and return their schema on GET. No browser, no wallet UI required for an agent to integrate. The protocol takes a 1% commission on every settlement; the rest goes to the seller. The full AgentCard is at `/.well-known/agent-card.json` (A2A-compatible). The OpenAPI 3.0.3 spec is at `/.well-known/openapi.json` with `components.securitySchemes` (none, hmacX402). `robots.txt` allows GPTBot, ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, Applebot-Extended, CCBot, Amazonbot.

13 hours ago