kubernetes-mcp-server

kubernetes-mcp-server — MCP-сервер сообщества (автор — containers). Сервер для Kubernetes и OpenShift. Ставится через npx или через uvx. Лицензия Apache-2.0.

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

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

Разработчик
containers
Лицензия
Apache-2.0
Транспорт
stdio, streamable_http
Авторизация
other
ОС
Не указана
Языки
go

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

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

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

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

Что умеет

Kubernetes MCP Server (containers/kubernetes-mcp-server) — MCP-сервер для Kubernetes и OpenShift. Это не обёртка над kubectl или helm: сервер написан на Go и обращается к API Kubernetes напрямую, поэтому внешние утилиты устанавливать не нужно. Распространяется как один бинарный файл для Linux, macOS и Windows, а также как пакеты npm и Python и образ контейнера.

  • Конфигурация: просмотр и управление текущим .kube/config или конфигурацией внутри кластера, автоматическое отслеживание её изменений.
  • Любые ресурсы: создание, обновление, получение, список и удаление любых ресурсов Kubernetes и OpenShift.
  • Поды: список, получение, удаление, логи, метрики потребления (top), выполнение команд внутри пода (exec), запуск образа в поде.
  • Пространства имён, события, проекты OpenShift: просмотр.
  • Helm: установка чарта, список релизов, удаление релиза.
  • Tekton: запуск пайплайнов и задач, перезапуск, отмена, диагностика и логи PipelineRun и TaskRun.
  • Несколько кластеров: работа сразу с несколькими кластерами из kubeconfig.
  • Наблюдаемость: необязательная трассировка и метрики OpenTelemetry, эндпоинт /stats.

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

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

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

Установка

Нужен доступ к кластеру Kubernetes. Сервер запускается через npx, uvx или готовый бинарник из релизов:

npx kubernetes-mcp-server@latest --help
uvx kubernetes-mcp-server@latest --help

Настройки задаются в TOML-файле (--config), например режим только для чтения и запрет доступа к секретам:

log_level = 2
read_only = true
toolsets = ["core", "config", "helm", "kubevirt"]

# Reject Secret requests made by this server's Kubernetes client
[[denied_resources]]
group = ""
version = "v1"
kind = "Secret"

Для Claude Code в репозитории есть отдельная инструкция, а для рабочей установки — руководство по отдельному ServiceAccount с доступом только на чтение.

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

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

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

Проверка

Попросите ассистента вывести поды во всех пространствах имён. Если появляется ошибка доступа, проверьте текущий контекст kubeconfig и права учётной записи.

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

Покажи события с предупреждениями в пространстве имён production за последний час.
Почему под api не запускается? Посмотри его логи и события.
Установи Helm-чарт redis в пространство имён cache.

Риски

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

Как снизить риски: включите read_only = true и запретите чтение секретов через denied_resources. README подчёркивает, что это лишь вспомогательные ограничения, а настоящий контроль доступа — RBAC для учётной записи, под которой работает сервер. Используйте отдельный ServiceAccount с минимальными правами. Лицензия — Apache-2.0.

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

Нужны ли kubectl и Helm?

Нет. Сервер работает с API Kubernetes напрямую, внешние утилиты не нужны.

Поддерживается ли OpenShift?

Да, включая список проектов OpenShift.

Как включить режим только для чтения?

Задайте read_only = true в TOML-конфиге и ограничьте права учётной записи через RBAC.

Основы протокола — на странице что такое 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

Источники