mcp-server-kubernetes

mcp-server-kubernetes — MCP-сервер сообщества (автор — Flux159). Операции в кластере Kubernetes: поды, развёртывания и сервисы. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
Flux159
Лицензия
MIT
Транспорт
stdio, streamable_http
Авторизация
other
ОС
Не указана
Языки
typescript

Уровень риска: high

Действует с правами kubeconfig: удаляет ресурсы, выводит узлы из работы, ставит и удаляет чарты. Включайте `ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS=true` и отдельный kubeconfig с минимальными правами RBAC.

Настройка клиентов

codex
{
    "code": "codex mcp add kubernetes -- npx mcp-server-kubernetes",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

MCP Server Kubernetes подключает ИИ-ассистента к кластеру Kubernetes и даёт им управлять. Сервер работает через kubectl и Helm, берёт kubeconfig из ~/.kube/config или других источников и автоматически подключается к текущему контексту.

  • Ресурсы: получение и описание (kubectl_get, kubectl_describe), создание, применение YAML (kubectl_apply), правка полей (kubectl_patch), удаление (kubectl_delete).
  • Логи и справка: логи подов (kubectl_logs), объяснение ресурсов (explain_resource), список API-ресурсов.
  • Контексты: переключение между кластерами через kubectl_context.
  • Масштабирование и доступ: kubectl_scale, проброс портов к подам и сервисам (port_forward).
  • Helm: установка, обновление и удаление чартов, в том числе через шаблоны (helm_template_apply).
  • Обслуживание: очистка проблемных подов (Evicted, CrashLoopBackOff, ImagePullBackOff и других) через cleanup_pods, cordon, drain и uncordon узлов (node_management).
  • Диагностика: промпт k8s-diagnose для поиска неисправностей.

Есть щадящий режим без разрушительных операций, маскирование секретов в выводе kubectl get secrets и необязательная телеметрия OpenTelemetry.

Кому подойдёт

  • DevOps-инженеру и SRE: разбор упавших подов, чтение логов и диагностика из чата с ассистентом.
  • Разработчику, который работает с локальным кластером (minikube, Rancher Desktop) и не хочет запоминать команды kubectl.
  • Командам с Helm: установка и обновление чартов с нужными значениями.

Другие варианты — в категории облака и DevOps.

Установка

Понадобятся kubectl в PATH, рабочий kubeconfig с контекстами и доступ к кластеру. Для операций с чартами нужен Helm v3. Проверьте доступ командой kubectl get pods.

Сервер запускается через npx:

npx mcp-server-kubernetes

Для Claude Desktop есть расширение mcpb в каталоге расширений и на странице релизов.

Подключение к клиентам

Команды и конфиги приведены дословно из README. Общий порядок — в инструкции как подключить MCP.

claude mcp add kubernetes -- npx mcp-server-kubernetes

Проверка

Попросите ассистента вывести список подов в текущем пространстве имён. Он вызовет kubectl_get. Если приходит ошибка доступа, проверьте kubectl get pods в терминале и текущий контекст.

Примеры задач

Найди поды в состоянии CrashLoopBackOff и покажи последние строки их логов.
Масштабируй deployment web до трёх реплик и проверь, что все поды запустились.
Установи чарт ingress-nginx в пространство имён ingress с моими значениями.

Риски

Сервер действует с правами вашего kubeconfig: может удалять ресурсы и пространства имён, выводить узлы из работы (drain), ставить и удалять чарты. Ошибочная команда в рабочем кластере приведёт к простою.

Как снизить риски: запускайте с ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS=true — так отключаются удаление подов, deployment и пространств имён, а чтение, создание и обновление остаются. Используйте отдельный kubeconfig с минимальными правами RBAC и не подключайте рабочий кластер без необходимости. Маскирование секретов не распространяется на логи. Лицензия — MIT.

Частые вопросы

Как запретить удаление ресурсов?

Задайте ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS=true. Разрушительные операции будут отключены, чтение, создание и обновление останутся.

Откуда сервер берёт доступ к кластеру?

По умолчанию из ~/.kube/config и текущего контекста kubectl. Другие способы описаны в расширенной документации проекта.

Нужен ли Helm?

Только для операций с чартами. Без Helm остальные инструменты работают.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • kubectl_get
  • kubectl_describe
  • kubectl_logs
  • explain_resource
  • kubectl_apply
  • kubectl_patch
  • kubectl_scale
  • kubectl_delete
  • cleanup_pods
  • node_management

Похожие MCP-серверы

Scrapling MCP Server

Веб-скрапинг Scrapling: скрытные HTTP-запросы, настоящие браузеры и CSS-селекторы.

Риск: medium Лицензия: BSD-3-Clause ★ 104 215

World Monitor

Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.

Риск: medium Лицензия: AGPL-3.0 ★ 90 905

mcp

Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Netdata

Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Источники