flux-topology

Ein MCP-Server, der durch statische Analyse einen Abhängigkeits- und Topologiegraphen eines Kubernetes/FluxCD-GitOps-Repositories erstellt, sodass KI-Agenten Service-Beziehungen ohne Cluster-Zugriff nachvollziehen können.

Installation

pip install flux-topology

Related MCP server: Axon Pro

MCP konfigurieren

Füge Folgendes zu deiner opencode.json hinzu:

{
  "mcp": {
    "flux-topology": {
      "type": "local",
      "command": ["flux-topology", "mcp"],
      "enabled": true
    }
  }
}

Der Server liest aus flux/ im Arbeitsverzeichnis. Führe opencode vom Stammverzeichnis deines GitOps-Repositories aus.

Agent-Skill

Die mitgelieferte Agent-Skill bringt KI-Agenten bei, wann und wie sie die MCP-Tools verwenden. Installiere sie von skills.sh:

npx skills add seppaleinen/flux-topology-mcp

Das gibt deinem Agenten einen Workflow: beginne mit fluxtop_map für eine Übersicht, gehe mit fluxtop_app_card in die Tiefe, prüfe den Blast-Radius mit fluxtop_trace und finde gemeinsame Referenzen mit fluxtop_find_refs.

Tools

CLI

# Build the topology cache (.fluxtop/)
flux-topology build

# Run the MCP server (for AI agents)
flux-topology mcp

So funktioniert es

1. Ermittelt Apps, indem es flux/ durchläuft und Ownership-Signale findet (HelmReleases, Kustomizations, Deployments, Services)

2. Extrahiert Workloads, Services, Ingress-Hosts und Referenzen pro App

3. Bestimmt Kanten zwischen Apps aus Querverweisen

4. Speichert alles in .fluxtop/ zwischen — wird nur neu erstellt, wenn sich Quelldateien ändern

Kein Cluster-Zugriff erforderlich. Reine statische Analyse von YAML-Dateien.

Entwicklung

git clone https://github.com/seppaleinen/flux-topology-mcp.git
cd flux-topology-mcp
pip install -e ".[dev]"
pytest

Lizenz

MIT