AliangBoard MCP
Панель Kubernetes с MCP-сервером: Claude Code читает логи подов, правит ресурсы и откатывает релизы в подключенных кластерах.
- 113 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент через MCP читает логи, меняет и удаляет ресурсы, выполняет команды в контейнерах и откатывает релизы.
- Том панели хранит учетные данные кластеров и ключи API.
Установка
- Работает в
Ручная установка
claude mcp add --transport http aliangboard {HOST}/mcp --header "Authorization: Bearer <YOUR_API_KEY>"Сначала разверните панель: `kubectl apply -f https://raw.githubusercontent.com/aliang-one/aliangboard/main/deployment.yaml` или образ `ghcr.io/aliang-one/aliangboard:latest`. Ключ создают в панели.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент через MCP читает логи, меняет и удаляет ресурсы, выполняет команды в контейнерах и откатывает релизы.
- Том панели хранит учетные данные кластеров и ключи API.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AliangBoard — веб-панель для Kubernetes с поддержкой нескольких кластеров: ресурсы, exec, port-forward, внедрение debug-контейнера. В панель встроен MCP-сервер (`POST /mcp`, Streamable HTTP, авторизация ключом API), и внешний клиент получает те же инструменты, что и встроенный рабочий стол агента. Чтение выполняется без подтверждения: логи подов, список и YAML ресурсов, события, проверка прав `can-i`, история раскатки. Масштабирование и перезапуск требуют подтверждения человека, а exec, чтение файлов контейнера, применение и удаление ресурсов, смена образа, kubectl debug и откат к ревизии относятся к административным операциям. Встроенному агенту можно подключить любую модель с OpenAI-совместимым протоколом, включая локальные vLLM и Ollama.
Для кого. Администраторам Kubernetes и платформенным командам, которые хотят спрашивать агента о состоянии кластера и разбирать сбои словами.
Подходит, если
- Под падает в цикле, и агент читает его логи и события вместо ручных вызовов `kubectl`.
- После неудачной выкладки нужен откат к конкретной ревизии с подтверждением.
- Несколько кластеров переключаются в одной панели без смены контекстов.
- Сервер-инвентарь с SSH-доступом отдают агенту для диагностики.
Не подходит, если
- Есть только `kubectl` и нужен легкий MCP без своей панели и базы.
- Панель нельзя закрыть TLS-терминацией на входе.
- Кластер продакшена недоступен для записи агентом.
Пример запроса к агенту
Покажи логи пода api за последний час, найди причину перезапусков и предложи откат, но ничего не применяй без моего подтверждения.MCP
- Транспорт
- http
- Авторизация
- ключ необязателен
Переменные окружения
LLM_BASE_URL- Адрес OpenAI-совместимого API для встроенного агента.
LLM_MODEL- Модель встроенного агента.
ADMIN_PASSWORDсекрет- Пароль администратора при первом запуске. Смените значение по умолчанию.
Ограничения
Панель нужно развернуть самим: Kubernetes через `deployment.yaml` или Docker, для запуска из исходников требуется Node.js 25 или новее. Администратор по умолчанию `admin` с паролем `admin`: смените данные до выхода в сеть. Ключи API, учетные данные кластеров и журнал аудита лежат в томе SQLite, поэтому храните его как секрет. Не давайте токен `cluster-admin`: заведите отдельный ServiceAccount с нужными правами. Публичный доступ закрывайте TLS на Ingress или обратном прокси.
Как отключить. Удалите MCP-подключение командой `claude mcp remove aliangboard`. Панель снимает `kubectl delete ns aliangboard`, но вместе с пространством имен пропадут и данные тома.
Частые вопросы
Как подключить AliangBoard к Claude Code?
Выполните `claude mcp add --transport http aliangboard {HOST}/mcp --header "Authorization: Bearer <YOUR_API_KEY>"`, где `{HOST}` адрес панели. Ключ создают в самой панели.
Агент может менять кластер без моего ведома?
Нет, для записи встроенный агент просит подтверждения человека. Для внешних клиентов политика одобрения сервера действует по принципу запрета: при значении `always` команда по ключу не выполняется, потому что одобрить ее некому.
Какие модели подходят встроенному агенту?
Любые с OpenAI-совместимым протоколом: OpenAI, DeepSeek, Qwen, GLM, а также локальные vLLM и Ollama. Адрес, ключ и модель задают в настройках LLM.
Как быстро развернуть панель?
Выполните `kubectl apply -f https://raw.githubusercontent.com/aliang-one/aliangboard/main/deployment.yaml`. Манифест создает пространство имен `aliangboard` с томом на 1 ГБ и открывает NodePort.
Какие права дать ServiceAccount?
Минимально нужные для вашей работы, например `pods/portforward` с `get` и `create` для проброса портов. Токен `cluster-admin` с долгим сроком не используйте.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Kubernetes: агент читает состояние кластера, разбирает сбои подов и запускает операции через kubectl
AI-помощник для Kubernetes: переводит запросы на естественном языке в операции kubectl и работает как MCP-сервер
MCP-сервер K8M дает агенту доступ к ресурсам Kubernetes, журналам подов и операциям с несколькими кластерами из диалога.
ACK MCP Server
alibabacloud-ack-mcp-server
Официальный MCP-сервер Alibaba Cloud для кластеров ACK: kubectl, метрики Prometheus, журналы SLS и диагностика.
Открытый интерфейс Kubernetes с встроенным MCP-сервером: агент осматривает кластер, разбирает поломки и выполняет операции с учетом RBAC
MCP-сервер на Go для Kubernetes и OpenShift: ресурсы, поды, логи, Helm и Tekton напрямую через API кластера
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| AliangBoard (эта карточка) | нет | ключ необязателен | 113 | |
| Kubernetes MCP Server | нет | не нужна | 2 228 | дает агенту инструменты Kubernetes напрямую; AliangBoard добавляет веб-панель, аудит и подтверждения записи человеком |
| Kubernetes MCP | нет | не нужна | 1 610 | работает через локальный `kubectl`; AliangBoard держит учетные данные кластеров на сервере панели |
Коротко о README
Репозиторий содержит панель Kubernetes на Vue 3 и Node, манифест развертывания и образ Docker для linux/amd64 и arm64. Есть публичное демо с общим доступом.