Kubernetes MCP
MCP Server Kubernetes
MCP-сервер для управления кластером Kubernetes через kubectl и Helm, с режимом без разрушающих операций
- 1 610 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Действует с правами текущего контекста kubectl
- Может удалять ресурсы, дренировать узлы и выполнять произвольные команды kubectl
- Логи могут содержать чувствительные данные
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-kubernetesОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Действует с правами текущего контекста kubectl
- Может удалять ресурсы, дренировать узлы и выполнять произвольные команды kubectl
- Логи могут содержать чувствительные данные
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к кластеру по текущему kubeconfig и дает агенту единый набор инструментов kubectl: get, describe, apply, create, patch, scale, rollout, logs, delete и управление контекстами. Поддерживаются установка и удаление Helm-чартов, port-forward, очистка проблемных подов и cordon или drain узлов. Промпт k8s-diagnose ведет агента по пошаговой диагностике подов. Секреты в выводе kubectl get secrets маскируются, трассировка через OpenTelemetry включается по желанию.
Для кого. DevOps-инженерам и разработчикам, которые работают с Kubernetes и хотят разбирать проблемы кластера вместе с агентом.
Подходит, если
- Нужно разобраться, почему под в CrashLoopBackOff
- Нужно применить манифест или обновить Helm-чарт по описанию
- Нужно быстро посмотреть логи и состояние ресурсов в нескольких неймспейсах
- Нужен доступ агента к кластеру только на чтение и изменение, без удаления
Не подходит, если
- Продакшн-кластер без ограничения прав и без режима без удаления
- Нужно добавлять кластеры в kubectx: это не планируется
Пример запроса к агенту
Посмотри, почему поды payments в неймспейсе prod перезапускаются, и предложи исправлениеMCP
- Транспорт
- stdio, sse
- Авторизация
- не нужна
Переменные окружения
ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS- Отключает удаление и другие разрушающие операции
ENABLE_TELEMETRY- Включает трассировку OpenTelemetry
OTEL_EXPORTER_OTLP_ENDPOINT- Адрес OTLP-коллектора для трассировки
Ограничения
Нужны установленный kubectl и рабочий kubeconfig, для Helm-операций Helm v3. Сервер действует с правами текущего контекста kubectl. Маскирование секретов не распространяется на логи. В режиме ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS отключаются удаление, очистка подов, управление узлами и kubectl_generic.
Как отключить. Удалите сервер командой claude mcp remove kubernetes или уберите блок kubernetes из конфигурации MCP. Чтобы ограничить действия, задайте ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS=true.
Частые вопросы
Откуда сервер берет доступ к кластеру?
По умолчанию из ~/.kube/config. Другие способы, включая переменные окружения и свои пути, описаны в ADVANCED_README.md.
Что остается доступным в режиме без разрушающих операций?
Чтение, apply, create, scale, patch, rollout, установка и обновление Helm-чартов, port-forward и управление контекстами.
Чем Kubernetes MCP отличается от запуска kubectl руками?
Сервер использует текущий kubeconfig и дает агенту единый набор инструментов kubectl: get, describe, apply, create, patch, scale, rollout, logs, delete, управление контекстами и работу с Helm. Есть режим без разрушающих операций.
Как подключить Kubernetes MCP к кластеру?
В Claude Code: claude mcp add kubernetes -- npx mcp-server-kubernetes. Сервер берет доступ из вашего kubeconfig. Включите режим без разрушающих операций, чтобы агент не мог удалять ресурсы. Риск высокий.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер на Go для Kubernetes и OpenShift: ресурсы, поды, логи, Helm и Tekton напрямую через API кластера
MCP-сервер для Kubernetes: агент читает состояние кластера, разбирает сбои подов и запускает операции через kubectl
MCP-сервер для Kubernetes на Go: чтение любых ресурсов кластера, логи подов, а в режиме записи apply и exec
Открытый интерфейс Kubernetes с встроенным MCP-сервером: агент осматривает кластер, разбирает поломки и выполняет операции с учетом RBAC
CLI и контроллер Kubernetes для разработки, сборки и выкатки серверов MCP. Для команд платформы, написан на Go
MCP-сервер и скиллы поверх сетевой обсервабилити Kubernetes: агент расследует инциденты и ищет трафик через eBPF-индекс кластера
Коротко о README
MCP Server Kubernetes подключается к кластеру и управляет им, загружая kubeconfig из нескольких источников по приоритету. README описывает установку в Claude Code, Codex, Claude Desktop, VS Code и Cursor, а также расширение mcpb для Claude Desktop. Перечислены инструменты kubectl и Helm, промпт диагностики, режим без разрушающих операций и интеграция с OpenTelemetry. Отдельно показана архитектура обработки запросов с транспортами stdio и SSE.