flux-topology

An MCP server that builds a dependency and topology graph of a FluxCD GitOps repository by static analysis.

When to use

• Debugging or exploring a FluxCD/Kubernetes GitOps repo
• Understanding blast radius before deleting or modifying an app
• Finding all references to a shared resource (Helm chart, image, config)
• Onboarding to an unfamiliar Flux repository
• Reviewing topology changes in a PR

Prerequisites

The flux-topology MCP server must be installed and configured. See the README for setup instructions.

How it works

The server analyzes YAML files under flux/ in the working directory. The topology cache (.fluxtop/) rebuilds automatically on every query — no manual refresh needed.