kubectl-mcp-server

MCP-сервер для Kubernetes: агент читает состояние кластера, разбирает сбои подов и запускает операции через kubectl

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Почему такой уровень

  • Выполняет реальные операции kubectl над кластером, включая изменяющие
  • Область действий равна правам в kubeconfig
  • Ошибка агента может затронуть боевой кластер
Все причины и проверки

rohitg00/kubectl-mcp-server

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/kubectl-mcp-server

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio kubernetes -- npx -y kubectl-mcp-server

Или добавьте в файл .mcp.json, в проекте

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

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

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

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Выполните в терминале

code --add-mcp '{"name":"kubernetes","type":"stdio","command":"npx","args":["-y","kubectl-mcp-server"]}'

Или добавьте в файл .vscode/mcp.json, в проекте

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

Если файл уже есть, добавьте сервер внутрь ключа servers.

Выполните в терминале

codex mcp add kubernetes -- npx -y kubectl-mcp-server

Или добавьте в файл ~/.codex/config.toml, для всех проектов

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

Если файл уже есть, допишите блок в конец.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

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

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

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

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

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

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Добавьте в файл .roo/mcp.json, в проекте

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

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "kubernetes": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Добавьте в файл .codeassistant/mcp.json, в проекте

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

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 14f9c13.

Текст для агента

Добавь в конфигурацию MCP клиента сервер kubernetes с командой npx и аргументами -y kubectl-mcp-server. Убедись, что kubeconfig указывает на нужный кластер и контекст.

Другие способы из описания автора
npx -y kubectl-mcp-server

Запуск без установки в систему. Нужен Node.js.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер подключает Kubernetes к агенту через существующий kubeconfig. Агент видит поды, деплойменты и неймспейсы, объясняет, почему падает под, разбирает проблемы сети и создает или масштабирует ресурсы. Ставится через npx, pip или docker и подходит для Claude Desktop, Cursor, Windsurf и других MCP-клиентов. Поддерживает транспорт stdio для локальной работы и sse для запуска как сетевого сервиса. В репозитории также лежат наборы навыков по темам Kubernetes для агентов, которые их читают.

Для кого. Для devops-инженеров и разработчиков, которые обслуживают кластеры Kubernetes и хотят вести их из агента.

Подходит, если

  • Нужно быстро разобраться, почему падает под или деплоймент
  • Нужно посмотреть состояние кластера без ручного набора команд kubectl
  • Нужно создать или отмасштабировать ресурс из диалога с агентом

Не подходит, если

  • Нет доступа к кластеру или прав в kubeconfig
  • Не хотите давать агенту права на изменение боевого кластера
  • Нужны гарантии, что агент не выполнит опасную операцию без подтверждения

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

Покажи все поды в неймспейсе kube-system и объясни, почему падает nginx-deployment

Ограничения

Работает с тем кластером и правами, что заданы в kubeconfig, поэтому область действий равна правам этого контекста. Для pip-установки нужен Python 3.9 и новее, для npx нужен Node.js. Сервер выполняет реальные операции kubectl, включая изменяющие, так что риск ошибки лежит на пользователе.

Как отключить. Удалите запись kubernetes из конфигурации MCP клиента. При установке через pip или npm удалите пакет kubectl-mcp-server.

MCP

Транспорт
stdio, sse
Авторизация
не нужна
Переменные окружения
Переменные окружения
KUBECONFIG
Путь к файлу kubeconfig, если нужен не тот, что задан в окружении по умолчанию

Проверка безопасности

  • Выполняет реальные операции kubectl над кластером, включая изменяющие
  • Область действий равна правам в kubeconfig
  • Ошибка агента может затронуть боевой кластер

Коротко о README

README предлагает быстрый старт через npx, а также установку через pip и образы docker с Docker Hub и GHCR. Описаны конфигурации для Claude Desktop, Cursor, Windsurf и запуск через python -m kubectl_mcp_tool.mcp_server с указанием KUBECONFIG. Есть примеры запросов на диагностику, деплой и работу с сетью, а также CLI-команды info, tools и call. Проект отмечен в ландшафте CNCF, лицензия MIT.

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

Как поставить без установки в систему?

Запускайте через npx -y kubectl-mcp-server, тогда пакет не устанавливается глобально. Есть также pip и образ docker.

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

Из вашего kubeconfig. Через переменную KUBECONFIG можно указать конкретный путь к файлу.

Выбор редакции

MCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента

MCP-серверСредний рискБез VPN80,7 тыс.Звезды репозитория
Выбор редакции

Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента

MCP-серверВысокий риск33,3 тыс.Звезды репозитория

Agent Skills для продуктов Google

Agent Skills for Google products and technologies

Выбор редакции

Официальная коллекция скиллов Google для работы с Google Cloud, BigQuery, GKE, рекламой и аналитикой из агента

СкиллВысокий риск20,5 тыс.Звезды репозитория

MCP-серверы для AWS

Open source MCP servers for AWS

Официальный

Официальный набор MCP-серверов AWS: документация, IaC, контейнеры, serverless, базы данных, стоимость и мониторинг

MCP-серверВысокий риск9,7 тыс.Звезды репозитория
Foxx AIkubectl-mcp-server

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.