Kubernetes·containers

Kubernetes MCP — подключение и инструкция

Kubernetes MCP позволяет агенту исследовать кластер, workloads и другие ресурсы Kubernetes или OpenShift через разрешения своей учётной записи.

РазработкаЛокальноAPI-ключ

Что умеет этот сервер

01

Kubernetes MCP позволяет агенту исследовать кластер, workloads и другие ресурсы Kubernetes или OpenShift через разрешения своей учётной записи.

02

Проект containers предоставляет исполняемый сервер, варианты npx/uvx и TOML-конфигурацию.

03

Прочитай namespaces и состояние pod в одном namespace.

Задача для знакомства

Через Kubernetes MCP проверь context и состояние pod в тестовом namespace. Ресурсы и Secret не меняй и не читай.

Уточнить результат

Всегда проверяй context и namespace. Успешное соединение с API не доказывает, что выбран staging, а не production.

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

Выберите подходящий способ

Подключить Kubernetes MCP

Выбери npx kubernetes-mcp-server@latest либо релизный бинарник. Настрой актуальный TOML по docs/configuration.md: тестовый kubeconfig/context, read_only=true и нужные toolsets. Не переносите старые CLI-флаги из другой версии без проверки.

Что понадобится

  • Доступ к тестовому кластеру и kubeconfig либо другая поддерживаемая identity. Для npx нужен Node.js/npm, для uvx — uv.
  1. 01

    Подготовь окружение

    Доступ к тестовому кластеру и kubeconfig либо другая поддерживаемая identity. Для npx нужен Node.js/npm, для uvx — uv.

  2. 02

    Установи и настрой

    Выбери npx kubernetes-mcp-server@latest либо релизный бинарник. Настрой актуальный TOML по docs/configuration.md: тестовый kubeconfig/context, read_only=true и нужные toolsets. Не переносите старые CLI-флаги из другой версии без проверки.

  3. 03

    Открой новую сессию

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

Проверка доступных параметров установленной версии

npx kubernetes-mcp-server@latest --help

Первый запрос — пример для чата агента

Через Kubernetes MCP проверь context и состояние pod в тестовом namespace. Ресурсы и Secret не меняй и не читай.

Как проверить

Всегда проверяй context и namespace. Успешное соединение с API не доказывает, что выбран staging, а не production.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет Kubernetes

Kubernetes MCP позволяет агенту исследовать кластер, workloads и другие ресурсы Kubernetes или OpenShift через разрешения своей учётной записи.

Проект containers предоставляет исполняемый сервер, варианты npx/uvx и TOML-конфигурацию. read_only и denied_resources — дополнительные ограничения, а не замена Kubernetes RBAC.

Что подготовить перед подключением

Доступ к тестовому кластеру и kubeconfig либо другая поддерживаемая identity. Для npx нужен Node.js/npm, для uvx — uv.

Как установить и подключить

Выбери npx kubernetes-mcp-server@latest либо релизный бинарник. Настрой актуальный TOML по docs/configuration.md: тестовый kubeconfig/context, read_only=true и нужные toolsets. Не переносите старые CLI-флаги из другой версии без проверки.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Прочитай namespaces и состояние pod в одном namespace. Для диагностики сопоставь events, logs и состояние deployment, прежде чем предлагать rollout или правку манифестов.

Как проверить результат и решить проблемы

Всегда проверяй context и namespace. Успешное соединение с API не доказывает, что выбран staging, а не production.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Изменяющие tools зависят от RBAC. Read-only-ограничения являются best-effort; для чтения Secret и административных операций нужны отдельные разрешения.

Исходники и документация

Репозиторий: containers/kubernetes-mcp-server. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о Kubernetes

Kubernetes MCP позволяет агенту исследовать кластер, workloads и другие ресурсы Kubernetes или OpenShift через разрешения своей учётной записи.
Вернуться в библиотеку