flux-topology

MCP-сервер, который строит граф зависимостей и топологии GitOps-репозитория Kubernetes/FluxCD с помощью статического анализа, чтобы ИИ-агенты могли рассуждать о связях между сервисами без доступа к кластеру.

Установка

pip install flux-topology

Related MCP server: Axon Pro

Настройка MCP

Добавьте в ваш opencode.json:

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

Сервер читает данные из flux/ в рабочем каталоге. Запустите opencode из корня вашего GitOps-репозитория.

Навык агента

Встроенный навык агента обучает ИИ-агентов, когда и как использовать MCP-инструменты. Установите его через skills.sh:

npx skills add seppaleinen/flux-topology-mcp

Это даёт вашему агенту рабочий процесс: начните с fluxtop_map для обзора, детализируйте с помощью fluxtop_app_card, проверьте радиус поражения с помощью fluxtop_trace и найдите общие ссылки с помощью fluxtop_find_refs.

Инструменты

CLI

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

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

Как это работает

1. Обнаруживает приложения, обходя flux/ и находя сигналы владения (HelmReleases, Kustomizations, Deployments, Services)

2. Извлекает рабочие нагрузки, сервисы, ingress-хосты и ссылки для каждого приложения

3. Определяет связи между приложениями по перекрёстным ссылкам

4. Кэширует всё в .fluxtop/ — пересоздаётся только при изменении исходных файлов

Доступ к кластеру не требуется. Чистый статический анализ YAML-файлов.

Разработка

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

Лицензия

MIT