kubectl-mcp-server
MCP-сервер для Kubernetes: агент читает состояние кластера, разбирает сбои подов и запускает операции через kubectl
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Выполняет реальные операции kubectl над кластером, включая изменяющие
- Область действий равна правам в kubeconfig
- Ошибка агента может затронуть боевой кластер
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kubectl-mcp-serverОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio kubernetes -- npx -y kubectl-mcp-serverИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubectl-mcp-server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubectl-mcp-server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Выполните в терминале
code --add-mcp '{"name":"kubernetes","type":"stdio","command":"npx","args":["-y","kubectl-mcp-server"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"kubernetes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"kubectl-mcp-server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add kubernetes -- npx -y kubectl-mcp-serverИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.kubernetes]
command = "npx"
args = ["-y", "kubectl-mcp-server"]Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubectl-mcp-server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubectl-mcp-server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubectl-mcp-server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubectl-mcp-server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"kubernetes": {
"type": "local",
"command": [
"npx",
"-y",
"kubectl-mcp-server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubectl-mcp-server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubectl-mcp-server"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавь в конфигурацию MCP клиента сервер kubernetes с командой npx и аргументами -y kubectl-mcp-server. Убедись, что kubeconfig указывает на нужный кластер и контекст.
Другие способы из описания автора
npx -y kubectl-mcp-serverЗапуск без установки в систему. Нужен Node.js.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает Kubernetes к агенту через существующий kubeconfig. Агент видит поды, деплойменты и неймспейсы, объясняет, почему падает под, разбирает проблемы сети и создает или масштабирует ресурсы. Ставится через npx, pip или docker и подходит для Claude Desktop, Cursor, Windsurf и других MCP-клиентов. Поддерживает транспорт stdio для локальной работы и sse для запуска как сетевого сервиса. В репозитории также лежат наборы навыков по темам Kubernetes для агентов, которые их читают.
Для кого. Для devops-инженеров и разработчиков, которые обслуживают кластеры Kubernetes и хотят вести их из агента.
Подходит, если
- Нужно быстро разобраться, почему падает под или деплоймент
- Нужно посмотреть состояние кластера без ручного набора команд kubectl
- Нужно создать или отмасштабировать ресурс из диалога с агентом
Не подходит, если
- Нет доступа к кластеру или прав в kubeconfig
- Не хотите давать агенту права на изменение боевого кластера
- Нужны гарантии, что агент не выполнит опасную операцию без подтверждения
Пример запроса к агенту
Покажи все поды в неймспейсе kube-system и объясни, почему падает nginx-deploymentОграничения
Работает с тем кластером и правами, что заданы в kubeconfig, поэтому область действий равна правам этого контекста. Для pip-установки нужен Python 3.9 и новее, для npx нужен Node.js. Сервер выполняет реальные операции kubectl, включая изменяющие, так что риск ошибки лежит на пользователе.
Как отключить. Удалите запись kubernetes из конфигурации MCP клиента. При установке через pip или npm удалите пакет kubectl-mcp-server.
MCP
- Транспорт
- stdio, sse
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| KUBECONFIG | Путь к файлу kubeconfig, если нужен не тот, что задан в окружении по умолчанию |
Проверка безопасности
- Выполняет реальные операции kubectl над кластером, включая изменяющие
- Область действий равна правам в kubeconfig
- Ошибка агента может затронуть боевой кластер
Коротко о README
README предлагает быстрый старт через npx, а также установку через pip и образы docker с Docker Hub и GHCR. Описаны конфигурации для Claude Desktop, Cursor, Windsurf и запуск через python -m kubectl_mcp_tool.mcp_server с указанием KUBECONFIG. Есть примеры запросов на диагностику, деплой и работу с сетью, а также CLI-команды info, tools и call. Проект отмечен в ландшафте CNCF, лицензия MIT.
Частые вопросы
Как поставить без установки в систему?
Запускайте через npx -y kubectl-mcp-server, тогда пакет не устанавливается глобально. Есть также pip и образ docker.
Откуда сервер берет доступ к кластеру?
Из вашего kubeconfig. Через переменную KUBECONFIG можно указать конкретный путь к файлу.
Похожие
MCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента
Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента
Agent Skills для продуктов Google
Agent Skills for Google products and technologies
Официальная коллекция скиллов Google для работы с Google Cloud, BigQuery, GKE, рекламой и аналитикой из агента
MCP-серверы для AWS
Open source MCP servers for AWS
Официальный набор MCP-серверов AWS: документация, IaC, контейнеры, serverless, базы данных, стоимость и мониторинг