# Flux MCP Server

AI-Powered GitOps.

The Flux MCP Server connects AI assistants directly to your Kubernetes clusters,
enabling seamless interaction through natural language for troubleshooting,
analysis, and operations.

## Capabilities

- **Instant Understanding** — Quickly understand your Flux installation status, resource configurations, and deployment histories across environments.
- **Environment Comparison** — Compare Flux configurations for applications and infrastructure between development, staging, and production.
- **Faster Incident Response** — Reduce mean time to resolution (MTTR) during incidents with contextual analysis and actionable remediation steps.
- **Root Cause Analysis** — Automatically correlate events, logs, and configuration changes to identify the source of failures in a GitOps pipeline.
- **Pipeline Management** — Trigger reconciliations, suspend/resume Flux resources, and manage your delivery pipelines with simple requests.
- **Visualization** — Generate diagrams that map out Flux dependencies, resource relationships, and delivery workflows across clusters.

## How It Works

```
AI Agent (Claude, Copilot, Gemini) <-- MCP Client --> Flux MCP (local or remote) <-- kubeconfig --> Kubernetes clusters
```

The Flux MCP Server integrates with AI assistants through the Model Context Protocol,
providing them with purpose-built tools to interact with your clusters. When you ask
a question or make a request, the AI uses these tools to gather information, analyze
configurations, and perform operations based on your instructions.

## Security Built-in

The Flux MCP Server is designed with security in mind, ensuring safe interaction
between AI assistants and your Kubernetes clusters.

- Provides a read-only mode for observation without affecting cluster state
- Masks sensitive information in Kubernetes Secret values
- Operates with your existing kubeconfig permissions
- Supports Kubernetes impersonation for limited access
- Access to the local file system is read-only and restricted to kubeconfig

## Documentation

- [Installation](https://fluxoperator.dev/docs/mcp/install.md)
- [Configuration](https://fluxoperator.dev/docs/mcp/config.md)
- [Prompting Guide](https://fluxoperator.dev/docs/mcp/prompting.md)
- [AI Instructions](https://fluxoperator.dev/docs/mcp/instructions.md)
- [Tools Reference](https://fluxoperator.dev/docs/mcp/tools.md)
- [Prompts Reference](https://fluxoperator.dev/docs/mcp/prompts.md)