flux-topology

Un servidor MCP que construye un grafo de dependencias y topología de un repositorio GitOps de Kubernetes/FluxCD mediante análisis estático, para que los agentes de IA puedan razonar sobre las relaciones entre servicios sin acceso al clúster.

Instalación

pip install flux-topology

Related MCP server: Axon Pro

Configurar MCP

Añade esto a tu opencode.json:

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

El servidor lee desde flux/ en el directorio de trabajo. Ejecuta opencode desde la raíz de tu repositorio GitOps.

Skill de agente

El skill de agente incluido enseña a los agentes de IA cuándo y cómo usar las herramientas MCP. Instálalo desde skills.sh:

npx skills add seppaleinen/flux-topology-mcp

Esto le da a tu agente un flujo de trabajo: empieza con fluxtop_map para una visión general, profundiza con fluxtop_app_card, comprueba el radio de explosión con fluxtop_trace y encuentra referencias compartidas con fluxtop_find_refs.

Herramientas

CLI

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

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

Cómo funciona

1. Descubre apps recorriendo flux/ y encontrando señales de propiedad (HelmReleases, Kustomizations, Deployments, Services)

2. Extrae workloads, servicios, hosts de ingress y referencias por app

3. Resuelve aristas entre apps a partir de referencias cruzadas

4. Almacena en caché todo en .fluxtop/ — se reconstruye solo cuando cambian los archivos fuente

No se requiere acceso al clúster. Análisis puramente estático de archivos YAML.

Desarrollo

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

Licencia

MIT