Kubernetes MCP

containers/kubernetes-mcp-server· Проверено 12.11.2026· 2,2 тыс.на GitHub

Даёт агенту доступ к кластеру Kubernetes или OpenShift из kubeconfig: смотреть поды, логи и события, применять манифесты, менять число реплик, ставить Helm-чарты. Работает с правами вашего kubeconfig.

2 реализации:

Сервер на Go, который ходит в API кластера напрямую: kubectl и helm ставить не нужно, есть OpenShift, несколько кластеров сразу и наборы инструментов для Helm, Tekton, KubeVirt, Istio и Prometheus.

Как подключить

Что сделать до подключения

Доступ к кластеру Kubernetes и kubeconfig, по умолчанию ~/.kube/config

npm с командой npx; вместо него подойдут uvx или готовый бинарник для Linux, macOS и Windows со страницы Releases

KUBECONFIG

по желанию: путь к отдельному kubeconfig, например с ServiceAccount только на чтение

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio kubernetes \
  -- npx -y kubernetes-mcp-server@latest

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.kubernetes]
command = "npx"
args = ["-y", "kubernetes-mcp-server@latest"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubernetes-mcp-server@latest"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "kubernetes": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "kubernetes-mcp-server@latest"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubernetes-mcp-server@latest"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubernetes-mcp-server@latest"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "kubernetes": {
        "type": "local",
        "command": ["npx", "-y", "kubernetes-mcp-server@latest"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubernetes-mcp-server@latest"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubernetes-mcp-server@latest"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

namespaces_listпоказывает пространства имён

events_listпоказывает события кластера

pods_listпоказывает поды

pods_getоткрывает под по имени

pods_logчитает логи пода

pods_topпоказывает CPU и память подов

pods_execвыполняет команду в поде

pods_runзапускает под из образа

pods_deleteудаляет под

nodes_topпоказывает нагрузку на узлы

nodes_logчитает логи узла

resources_listпоказывает ресурсы любого типа

resources_getоткрывает ресурс

resources_create_or_updateприменяет манифест

resources_deleteудаляет ресурс

resources_scaleменяет число реплик

configuration_contexts_listпоказывает контексты kubeconfig

projects_listпоказывает проекты OpenShift

helm_installставит Helm-чарт

helm_listпоказывает релизы Helm

Показано 20 из 78.

Сервер на Node.js поверх kubectl и helm: нужен установленный kubectl, зато есть произвольная команда kubectl, проброс портов, обслуживание узлов и режим без удалений.

Как подключить

Что сделать до подключения

kubectl в PATH и kubeconfig с настроенными контекстами; проверьте командой kubectl get pods

Helm v3 в PATH, если нужны чарты

ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS

по желанию: true убирает удаление, exec в под, обслуживание узлов и произвольные команды kubectl

KUBECONFIG_PATH

по желанию: путь к другому kubeconfig; контекст и пространство имён меняются через K8S_CONTEXT и K8S_NAMESPACE

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mcp-server-kubernetes \
  -- npx mcp-server-kubernetes

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-server-kubernetes]
command = "npx"
args = ["mcp-server-kubernetes"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-server-kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-server-kubernetes": {
      "type": "stdio",
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-server-kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-server-kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-server-kubernetes": {
        "type": "local",
        "command": ["npx", "mcp-server-kubernetes"]
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-server-kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-server-kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }
  }
}

Инструменты сервера

kubectl_getполучает и показывает ресурсы

kubectl_describeописывает ресурс

kubectl_logsчитает логи

kubectl_applyприменяет YAML-манифест

kubectl_createсоздаёт ресурс

kubectl_patchменяет поля ресурса

kubectl_deleteудаляет ресурс

kubectl_scaleменяет число реплик

kubectl_rolloutуправляет выкаткой деплоймента

kubectl_contextпереключает контекст kubectl

kubectl_genericвыполняет любую команду kubectl

explain_resourceобъясняет поля ресурса

list_api_resourcesпоказывает типы ресурсов API

exec_in_podвыполняет команду в поде

port_forwardпробрасывает порт пода или сервиса

install_helm_chartставит Helm-чарт

upgrade_helm_chartобновляет Helm-чарт

uninstall_helm_chartудаляет Helm-чарт

cleanup_podsчистит упавшие и завершённые поды

node_managementвыводит узел на обслуживание

Что попросить агента

«Покажи все пространства имён в моём кластере»Агент вызовет namespaces_list, у Flux159 — kubectl_get

«Почему под <имя> в <namespace> перезапускается?»Агент посмотрит под через pods_get, логи через pods_log и события через events_list; у Flux159 — kubectl_describe и kubectl_logs

«Какие поды в <namespace> съедают больше всего памяти?»Агент вызовет pods_top

«Увеличь <deployment> в <namespace> до 3 реплик»Агент вызовет resources_scale, у Flux159 — kubectl_scale

«Поставь чарт <chart> в <namespace>»Агент вызовет helm_install, если включён набор helm; у Flux159 — install_helm_chart

Для каких задач

Разобрать, почему под падает, по событиям, логам и описанию

Показать потребление CPU и памяти подами и узлами

Применить манифест или поменять число реплик деплоймента

Поставить, обновить или удалить Helm-чарт

Выполнить команду внутри контейнера

Работать с несколькими кластерами из одного kubeconfig

Ограничения

Агент получает права учётной записи из kubeconfig; режимы только чтения сервер соблюдает сам, а границу доступа задаёт RBAC кластера

У containers режим read_only оставляет чтение любых объектов, к которым есть доступ, включая Secrets

У containers по умолчанию включены только наборы core и config; Helm, Tekton, KubeVirt и наблюдаемость включаются в TOML-параметре toolsets

Flux159 маскирует секреты только в выводе kubectl get secrets, в логах данные не скрываются

Если не работает

containers не принимает флаг --read-only

Флаги настроек из командной строки убраны. Запишите read_only = true в TOML-файл и передайте путь флагом --config.

Flux159 не может подключиться к кластеру

Выполните в терминале kubectl get pods: если команда падает с ошибкой учётных данных, сначала почините kubeconfig.

На большом кластере Flux159 падает с ошибкой spawnSync ENOBFUS

Увеличьте буфер переменной SPAWN_MAX_BUFFER в env, например 5242880 для 5 МБ.

Установка Helm-чарта через Flux159 упирается в ошибку авторизации

Используйте helm_template_apply: установка через шаблон обходит проблемы с авторизацией.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Kubernetes MCP Server	containers	2,2 тыс.	локально	не нужен	78	12 ноября 2026
MCP Server Kubernetes	Flux159	1,6 тыс.	локально	не нужен	20	10 ноября 2026

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

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

У containers запишите read_only = true в TOML-файл и передайте его флагом --config. У Flux159 задайте ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS=true: удаление и exec пропадут, а apply, create, scale и Helm останутся.

Чем отличаются два сервера?

containers написан на Go и работает с API кластера напрямую, без kubectl и helm, и поддерживает OpenShift. Flux159 вызывает kubectl и helm, поэтому они должны стоять в PATH, зато в нём есть произвольная команда kubectl и проброс портов.

Как работать с несколькими кластерами?

containers видит все контексты из kubeconfig, и у инструментов появляется аргумент context. У Flux159 контекст переключает kubectl_context или переменная K8S_CONTEXT.

Как включить Helm и другие наборы в containers?

Перечислите наборы в TOML, например toolsets = ["core", "config", "helm"]. Доступны ещё kcp, kiali, kubevirt, netobserv, tekton и наборы observability для Loki, Prometheus, OpenTelemetry Collector и Tempo.

Работает ли сервер из России?

Оба сервера запускаются на вашем компьютере и ходят в кластер с правами из kubeconfig, ключи и зарубежные аккаунты не нужны.

Kubernetes MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

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

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