Flux MCP Server

Установка

Работает в

• Claude Code
• Cursor
• GitHub Copilot
• SourceCraft
• Koda
• Coddy

Ручная установка

brew install controlplaneio-fluxcd/tap/flux-operator-mcp

Что делает

Flux MCP Server — MCP-сервер, который подключает ИИ-агента к кластеру Kubernetes с Flux CD и Flux Operator. Вместо ручных команд kubectl и flux агент вызывает инструменты сервера: смотрит версию и состояние установки Flux, читает ресурсы вместе с событиями и условиями готовности, берет логи подов и метрики, проходит по цепочке владельцев от пода до Kustomization, HelmRelease или источника в Git. Так он находит звено GitOps-конвейера, на котором встала выкатка. Сервер умеет и менять кластер: запускать повторную сверку ресурса, приостанавливать и возобновлять ее, применять манифест через server-side apply, патчить и удалять ресурсы, ставить экземпляр Flux по адресу манифеста. Перед применением агент может проверить правку инструментом `diff_kubernetes_manifest`, который показывает разницу и сам ничего не записывает. Для нескольких кластеров есть инструменты `get_kubeconfig_contexts` и `set_kubeconfig_context`: они переключают контекст сессии, не трогая файл kubeconfig. Поиск по документации Flux ведут `search_flux_docs` и `read_flux_doc`. Сервер запускается командой `flux-operator-mcp serve`. По умолчанию он работает через stdio, а с флагом `--transport http` отвечает по Streamable HTTP на пути /mcp. При подключении он передает агенту встроенные инструкции. Пошаговые правила разбора сбоев автор предлагает скопировать из файла docs/mcp/instructions.md в файл правил вашего ассистента.

Для кого. Для платформенных инженеров и девопсов, которые ведут кластеры на Flux CD и хотят поручать агенту в Claude, Cursor или GitHub Copilot разбор упавших выкаток, сравнение сред и рутинные операции Flux.

Пример запроса к агенту

HelmRelease podinfo в namespace apps не становится готовым. Найди причину по событиям и логам, покажи цепочку от пода до источника и ничего не меняй

MCP

Транспорт

stdio, http

Авторизация

не нужна

Ограничения

Сервер входит в проект Flux Operator и распространяется по лицензии AGPL-3.0.

Инструменты записи включены по умолчанию. Флаг `--read-only` отключает сверку, приостановку, возобновление, применение и удаление. Инструмент сравнения манифестов остается доступным, но Kubernetes проверяет его пробное применение как настоящее, поэтому нужны права `get` и `patch` на виды ресурсов манифеста. Учетной записи только для просмотра сервер вернет ошибки доступа по каждому объекту.

Значения секретов Kubernetes сервер по умолчанию маскирует. Автор предупреждает: если отключить маскирование флагом `--mask-secrets=false`, секреты уйдут ассистенту и, возможно, в обучающие данные его модели, поэтому так можно делать только в контролируемой среде с самостоятельно размещенной моделью.

Транспорт SSE удален, поддерживается только Streamable HTTP, а параметр `yaml_path` у инструмента сравнения есть лишь при локальном запуске через stdio. Путь к kubeconfig задается переменной KUBECONFIG, а флаг `--kube-as` ограничивает права сервера выбранной служебной учетной записью.

Как отключить. Удалите запись flux-operator-mcp из настроек MCP вашего ассистента и перезапустите его. Саму программу снимает команда `brew uninstall flux-operator-mcp`, если ставили через Homebrew. Если сервер развернут в кластере через ResourceSet, удалите этот ресурс.

Коротко о README

В репозитории проекта лежит исходный код сервера, Dockerfile, справка по быстрому старту и каталог документации с пятью страницами: установка, настройка транспорта и безопасности, советы по формулировке запросов, справочник инструментов и готовые инструкции для ассистента. Быстрый старт сводится к установке через Homebrew, добавлению записи в MCP-настройки и проверке двумя вопросами: какие контексты есть в kubeconfig и какая версия Flux работает в текущем кластере.