flux-topology
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-topologyRelated 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-mcpEsto 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
Herramienta | Descripción |
| Vista de nivel superior: dominios, apps hub por número de aristas, avisos |
| Radio de explosión BFS desde cualquier app con aristas tipadas |
| Búsqueda Regex de referencias en todas las apps |
| Ficha completa de una app: workloads, servicios, aristas |
| Comprueba si la caché de topología está actualizada |
CLI
# Build the topology cache (.fluxtop/)
flux-topology build
# Run the MCP server (for AI agents)
flux-topology mcpCómo funciona
Descubre apps recorriendo
flux/y encontrando señales de propiedad (HelmReleases, Kustomizations, Deployments, Services)Extrae workloads, servicios, hosts de ingress y referencias por app
Resuelve aristas entre apps a partir de referencias cruzadas
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]"
pytestLicencia
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Codebase intelligence for AI agents — dead code, blast radius, ownership.
Code intelligence platform for AI agents. 20 tools for architecture, security & impact analysis.
AI Agent with Architectural Memory. Impact analysis (free), tests and code from the graph (pro).
Fail-closed policy guardrails for AI agents running kubectl, terraform, helm, and argocd.
Related MCP Servers
- AlicenseAqualityCmaintenanceProvides AI coding agents with durable architecture memory for repositories by generating structured project maps of responsibilities, relationships, and risks.63 npmMIT
- AlicenseBqualityDmaintenanceTransforms codebases into structural knowledge graphs for AI agents and developers, providing precise architectural awareness and dependency mapping.1530MIT
- AlicenseAqualityDmaintenanceEnables AI agents to map cross-repository dependencies, detect breaking changes in API contracts, and assess impact across services.10MIT
- AlicenseNot gradedqualityBmaintenanceProvides a dependency graph of any local repository with tools for change impact, transitive dependents, health audits, and more, enabling AI coding agents to see structure and refactor safely.4MIT