MCP K8S Go — Kubernetes для агента
MCP K8S Go
MCP-сервер на Go: агент читает поды, логи и события кластера Kubernetes, меняет ресурсы и выполняет команды в подах
- 382 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Без флага `--readonly` агент создает и меняет ресурсы кластера и выполняет команды внутри подов
- Доступ идет с правами вашего kubeconfig, а секреты открываются при отключенном маскировании
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-k8s-goОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Без флага `--readonly` агент создает и меняет ресурсы кластера и выполняет команды внутри подов
- Доступ идет с правами вашего kubeconfig, а секреты открываются при отключенном маскировании
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP K8S Go подключается к кластерам Kubernetes по вашему kubeconfig и дает агенту набор инструментов, а также ресурсы и подсказки MCP. Сервер собран одним бинарным файлом на Go и ставится через npm, GitHub Releases, Docker или `go install`. Агент получает список контекстов kubeconfig и пространств имен, список узлов и подов, события кластера и логи подов. Универсальные инструменты умеют показывать, получать, создавать и изменять любые ресурсы Kubernetes. Для подов, сервисов и деплойментов добавлены собственные отображения. Отдельный инструмент выполняет команду внутри пода. Поведение ограничивается флагами запуска. `--allowed-contexts=dev,prod` оставляет агенту только перечисленные контексты, `--readonly` отключает все инструменты, которые пишут в кластер, а `--mask-secrets` по умолчанию скрывает значения секретов в ответах. Проверить сервер без клиента можно через MCP Inspector командой `npx @modelcontextprotocol/inspector npx @strowk/mcp-k8s`.
Для кого. Для DevOps-инженеров и разработчиков, которые отлаживают приложения в Kubernetes и хотят расспрашивать кластер из Claude Desktop или другого клиента MCP.
Подходит, если
- Под в пространстве имен kube-system падает, и нужно найти ошибки в его логах и событиях
- Нужно быстро понять, какие поды, сервисы и деплойменты есть в выбранном контексте
- Агенту надо применить небольшую правку ресурса в тестовом кластере с подтверждением
- Требуется выполнить диагностическую команду внутри пода без ручного «kubectl exec»
- Нужен безопасный просмотр кластера: запуск с `--readonly` и списком разрешенных контекстов
Не подходит, если
- Нужны метрики, дашборды и алерты: сервер читает ресурсы, события и логи, мониторинга в нем нет
- Кластер боевой, а запуск без `--readonly` и без списка разрешенных контекстов недопустим по правилам команды
- Нужна установка чартов Helm или управление релизами: таких инструментов в списке функций нет
- Нужен удаленный сервер с авторизацией для команды: этот работает локально и берет доступ из вашего kubeconfig
Пример запроса к агенту
Выбери контекст dev, найди в пространстве имен kube-system поды с перезапусками и покажи ошибки из их логов за последний час.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
KUBECONFIG- Путь к файлу kubeconfig, по умолчанию ~/.kube/config.
Ограничения
Сервер использует права вашего kubeconfig целиком: путь берется из переменной KUBECONFIG или из `~/.kube/config`. Все контексты доступны агенту, пока вы не ограничите их флагом `--allowed-contexts`. Без `--readonly` агент может создавать и менять ресурсы и выполнять команды в подах, поэтому для боевых кластеров стоит начинать с режима только чтения.
Маскирование секретов включено по умолчанию, но его отключает флаг `--mask-secrets=false`. В Docker конфигурацию монтируют внутрь контейнера, а в Git Bash на Windows путь к `.kube/config` нужно записывать в виде `//c/Users/<имя>/.kube/config`.
Способы установки через Smithery и mcp-get настраивают Claude Desktop автоматически, остальные требуют ручной правки конфигурации. Последний коммит сделан в декабре 2025 года. Доступность установки из России при подготовке карточки не проверялась.
Как отключить. Удалите блок mcp_k8s из `claude_desktop_config.json` или другого файла конфигурации клиента и перезапустите клиент. Если ставили через npm, добавьте `npm uninstall -g @strowk/mcp-k8s`.
Частые вопросы
Как подключить MCP K8S Go к Claude Desktop?
Выполните `npm install -g @strowk/mcp-k8s`, затем добавьте в `claude_desktop_config.json` сервер с командой `mcp-k8s`. Либо пропишите команду `npx` с аргументом `@strowk/mcp-k8s`. Через Smithery и mcp-get настройка происходит автоматически.
Как запретить агенту менять кластер?
Добавьте флаг `--readonly`: он отключает любой инструмент, который пишет в кластер. Дополнительно флаг `--allowed-contexts=dev,prod` ограничивает список контекстов kubeconfig.
Видит ли агент значения секретов Kubernetes?
По умолчанию нет: маскирование включено флагом `--mask-secrets` со значением true. Отключается оно явно, записью `--mask-secrets=false`.
Как запустить MCP K8S Go в Docker?
Используйте образ `mcpk8s/server:latest` и смонтируйте конфигурацию: `docker run -i -v ~/.kube/config:/home/nonroot/.kube/config --rm mcpk8s/server:latest`. Образы опубликованы для linux/amd64 и linux/arm64 начиная с релиза 0.3.1-beta.2.
Чем MCP K8S Go отличается от других серверов Kubernetes?
Он написан на Go и поставляется готовым бинарным файлом, а не пакетом, который собирают на месте. Из особенностей: ресурсы и подсказки MCP для контекстов и пространств имен, режим только чтения и фильтр разрешенных контекстов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер на Go для Kubernetes и OpenShift: ресурсы, поды, логи, Helm и Tekton напрямую через API кластера
MCP-сервер для Kubernetes на Go: чтение любых ресурсов кластера, логи подов, а в режиме записи apply и exec
MCP-сервер для Kubernetes: агент читает состояние кластера, разбирает сбои подов и запускает операции через kubectl
MCP-сервер K8M дает агенту доступ к ресурсам Kubernetes, журналам подов и операциям с несколькими кластерами из диалога.
CLI и контроллер Kubernetes для разработки, сборки и выкатки серверов MCP. Для команд платформы, написан на Go
Kubernetes MCP
MCP Server Kubernetes
MCP-сервер для управления кластером Kubernetes через kubectl и Helm, с режимом без разрушающих операций
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP K8S Go — Kubernetes для агента (эта карточка) | нет | не нужна | 382 | |
| Kubernetes MCP Server | нет | не нужна | 2 228 | Go-сервер для Kubernetes и OpenShift, который работает напрямую через API кластера и умеет Helm и Tekton |
| Kubernetes MCP | нет | не нужна | 1 610 | управляет кластером через kubectl и Helm и имеет режим без разрушающих операций |
| kubectl-mcp-server | нет | не нужна | 968 | читает состояние кластера, разбирает сбои подов и запускает операции через kubectl |
Коротко о README
README открывается списком функций с пометками, что из них инструмент, подсказка или ресурс MCP. Дальше показаны просмотр через Inspector, демонстрация в Claude Desktop и шесть способов установки в таблице с требованиями. Завершают переменная KUBECONFIG и флаги командной строки с примером конфигурации.