mcp-server-kubernetes

MCP-сервер Kubernetes

Сервер MCP, который может подключаться к кластеру Kubernetes и управлять им.

https://github.com/user-attachments/assets/f25f8f4e-4d04-479b-9ae0-5dac452dd2ed

Использование с Claude Desktop

Сервер автоматически подключится к вашему текущему контексту kubectl. Убедитесь, что у вас есть:

1. kubectl установлен и находится в вашем PATH
2. Действительный файл kubeconfig с настроенными контекстами
3. Доступ к кластеру Kubernetes, настроенному для kubectl (например, minikube, Rancher Desktop, GKE и т. д.)
4. Helm v3 установлен и находится в PATH (Tiller не требуется). Необязательно, если вы не планируете использовать Helm.

Вы можете проверить свое подключение, попросив Клода составить список ваших модулей или создать тестовое развертывание.

Если у вас возникли ошибки, откройте стандартный терминал и запустите kubectl get pods чтобы проверить, сможете ли вы подключиться к своему кластеру без проблем с учетными данными.

Использование с mcp-chat

mcp-chat — это CLI-чат-клиент для серверов MCP. Вы можете использовать его для взаимодействия с сервером Kubernetes.

Либо передайте ему существующий файл конфигурации Claude Desktop, указанный выше (Linux должен передать правильный путь к config):

Мак:

Окна:

Функции

• [x] Подключиться к кластеру Kubernetes
• [x] Список всех модулей, служб, развертываний
• [x] Список, описание узлов
• [x] Создать, описать, удалить модуль
• [x] Список всех пространств имен, создание пространства имен
• [x] Создание пользовательских конфигураций модулей и развертывания, обновление реплик развертывания
• [x] Создать, описать, удалить, обновить услугу
• [x] Создать, получить, обновить, удалить ConfigMap
• [x] Получение журналов из модуля для отладки (поддерживает модули, развертывания, задания и селекторы меток)
• [x] Поддержка Helm v3 для установки диаграмм
  • Установить диаграммы с пользовательскими значениями
  • Удаление релизов
  • Обновите существующие версии
  • Поддержка пространств имен
  • Поддержка спецификации версии
  • Поддержка пользовательских репозиториев
• [x] kubectl Explain и поддержка kubectl API-ресурсов
• [x] Получить события Kubernetes из кластера
• [x] Переадресация порта на модуль или службу
• [x] Создание, перечисление и описание cronjobs
• [x] Неразрушающий режим для доступа к кластерам только для чтения и создания/обновления

Местное развитие

Убедитесь, что у вас установлен bun . Клонируйте репозиторий и установите зависимости:

Рабочий процесс разработки

1. Запустить сервер в режиме разработки (отслеживает изменения файлов):

2. Запуск модульных тестов:

3. Создайте проект:

4. Локальное тестирование с инспектором

5. Локальное тестирование с помощью Claude Desktop

6. Локальное тестирование с mcp-chat

Внося вклад

Подробности смотрите в файле CONTRIBUTING.md .

Передовой

Дополнительные расширенные функции

Более подробную информацию, например, об использовании транспорта SSE и неразрушающем режиме с ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS , см. в файле ADVANCED_README.md .

Архитектура

Более подробный обзор архитектуры, созданный Девином, можно найти по этой ссылке DeepWiki .

В этом разделе описывается высокоуровневая архитектура сервера MCP Kubernetes.

Запрос потока

Приведенная ниже диаграмма последовательности иллюстрирует, как запросы проходят через систему:

Публикация нового релиза

Перейдите на страницу релизов , нажмите «Черновик нового релиза», нажмите «Выбрать тег» и создайте новый тег, введя новый номер версии, используя формат semver «v{major}.{minor}.{patch}». Затем напишите название релиза «Выпуск v{major}.{minor}.{patch}» и описание/журнал изменений, если необходимо, и нажмите «Опубликовать релиз».

Это создаст новый тег, который запустит новую сборку релиза через рабочий процесс cd.yml. После успешного выполнения новый релиз будет опубликован в npm . Обратите внимание, что нет необходимости вручную обновлять версию package.json, поскольку рабочий процесс автоматически обновит номер версии в файле package.json и отправит коммит в main.

Не планируется

Аутентификация/добавление кластеров в kubectx.