kubectl-mcp-server

kubectl-mcp-server — MCP-сервер сообщества (автор — rohitg00). Работа с кластерами Kubernetes на естественном языке через kubectl. Ставится через npx или через pip. Лицензия MIT.

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

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

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

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

Действует с правами kubeconfig: удаляет ресурсы, управляет Helm, drain узлов. Используйте --read-only или --confirm-destructive.

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

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kubectl-mcp-server\"]\n    }\n  }\n}",
    "file": "~/.cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

kubectl-mcp-server позволяет управлять инфраструктурой Kubernetes на естественном языке через ИИ-ассистента. Можно разбирать падения подов, искать лишний расход ресурсов, разворачивать приложения, проверять безопасность и управлять чартами Helm. Проект входит в CNCF Landscape.

По умолчанию сервер регистрирует наборы core и helm — 26 инструментов, чтобы не перегружать контекст модели. Все наборы вместе дают 209 инструментов.

  • core (18) — общие операции kubectl для любых ресурсов, включая CRD: kubectl_get, kubectl_describe, kubectl_logs, kubectl_top, kubectl_explain и другие.
  • helm (8) — жизненный цикл релизов: список, статус, история, установка, обновление, удаление, откат.
  • Дополнительные наборы подключаются через --toolsets:
    • diagnostics — сеть, DNS, здоровье узлов и подов;
    • security — аудит RBAC, безопасность подов и секретов;
    • cost — подбор ресурсов и анализ затрат;
    • multicluster, crds, ops;
    • gitops (Flux, Argo CD), certs (cert-manager), policy (Kyverno, Gatekeeper), backup (Velero);
    • keda, cilium, rollouts, capi, kubevirt, istio, kind, vind.

Есть 14 готовых промптов: разбор проблем, развёртывание, аудит безопасности, оптимизация затрат, план восстановления и реагирование на инциденты. Ресурсы kubeconfig://, cluster:// и manifest:// дают обзор контекстов, узлов и YAML-манифестов. В манифестах секретов данные скрыты. Каждый инструмент принимает параметр контекста, поэтому можно работать с несколькими кластерами.

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

  • DevOps и SRE: диагностика инцидентов и рутинные операции без поиска команд kubectl.
  • Разработчикам: развернуть сервис и посмотреть логи из чата с ассистентом.
  • Командам безопасности и FinOps: аудит RBAC и поиск ресурсов, которые простаивают.

Похожие серверы — в категории облака и DevOps.

Установка

Без установки: npx -y kubectl-mcp-server (нужен Node.js 18+). Через Python: pip install kubectl-mcp-server или uvx --from kubectl-mcp-server kubectl-mcp (нужен Python 3.10+). Есть Docker-образ, в который kubeconfig монтируется только для чтения. Нужны настроенный kubectl и доступ к кластеру. Проверить установку можно командами kubectl cluster-info и kubectl-mcp-server info, а список инструментов выводит kubectl-mcp-server tools.

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

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

~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubectl-mcp-server"]
    }
  }
}

В README есть также конфиги для Claude Code, GitHub Copilot в VS Code, Goose, Gemini CLI и Roo Code / Kilo Code и вариант запуска через Python с KUBECONFIG. После настройки перезапустите ассистента.

Проверка

Спросите: «Покажи поды в namespace kube-system» — сработает kubectl_get.

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

Почему падает под в namespace payments? Посмотри логи и события.
Покажи, какие поды запрашивают больше ресурсов, чем используют.

Риски

Сервер действует с правами вашего kubeconfig: может удалять ресурсы, удалять и откатывать релизы Helm, сливать трафик с узлов (drain), запускать резервное копирование и восстановление. Наборы kind и vind запускают docker и vcluster на хосте. Меры защиты по README:

  • --read-only (MCP_SAFETY_MODE=read-only) скрывает и блокирует все изменяющие инструменты;
  • --confirm-destructive (MCP_SAFETY_MODE=confirm) просит подтверждение перед каждым разрушительным вызовом;
  • сервер скрывает значения секретов и защищает от подстановки флагов.

Для продакшен-кластеров начните с режима только для чтения и сервисного аккаунта с минимальными правами RBAC. HTTP-режим в контейнере без OAuth не запустится, пока вы явно не зададите MCP_ALLOW_UNAUTHENTICATED=true. Включайте это только на localhost. Логи и манифесты — недоверенные данные для агента.

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

Как запретить изменения в кластере?

Запустите сервер с --read-only или задайте MCP_SAFETY_MODE=read-only.

Как включить больше инструментов?

Через --toolsets, например --toolsets default,diagnostics,certs, или --toolsets all для всех 209.

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

Похожие 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

Источники