kubeview — MCP-сервер для Claude Code: что делает и как установить
Подключает AI-ассистента к Kubernetes через песочницу TypeScript. Экономит контекстное окно: фильтрует логи и события внутри кластера до отправки ответа.
claude mcp add --env KUBECONFIG=<KUBECONFIG> --env MCP_TRANSPORT=<MCP_TRANSPORT> --env MCP_MODE=<MCP_MODE> --env MCP_CODE_MODE_DISABLED_TOOLS=<MCP_CODE_MODE_DISABLED_TOOLS> --env MCP_ARGO_TOOLS=<MCP_ARGO_TOOLS> --transport stdio kubeview -- npx -y kubeview-mcpЧто делает kubeview
Kubeview запускает режим выполнения кода вместо десятков отдельных инструментов. Агент выполняет скрипты через run_code, опрашивает API Kubernetes и сверяет манифесты Helm на лету. Сырые логи не забивают контекст модели. Промежуточные данные остаются в локальной песочнице.
Сервер публикует всего два инструмента: run_code и kube_pod_exec. Запуск команд внутри контейнеров требует подтверждения с таймаутом на 10 минут. Сетевой проброс kube_port_forward внутри песочницы закрыт. Без Node.js версии 22 или новее и настроенного KUBECONFIG сервер не запустится.
Какие задачи решает
- собрать логи с проблемных подов без перегрузки контекста модели
- сопоставить сбои в кластере с событиями и релизами Helm
- проверить состояние воркфлоу Argo Workflows и приложений Argo CD
- выполнить отладку контейнера через защищённый вызов с подтверждением
Примеры запросов агенту
- Проверь поды со статусом CrashLoopBackOff в пространстве payments и найди причину падения
- Сравни текущий релиз Helm в кластере с конфигурацией пода и покажи расхождения
- Выполни run_code, чтобы получить последние события кластера и отфильтровать предупреждения
Как установить kubeview
Командой платформы
claude mcp add --env KUBECONFIG=<KUBECONFIG> --env MCP_TRANSPORT=<MCP_TRANSPORT> --env MCP_MODE=<MCP_MODE> --env MCP_CODE_MODE_DISABLED_TOOLS=<MCP_CODE_MODE_DISABLED_TOOLS> --env MCP_ARGO_TOOLS=<MCP_ARGO_TOOLS> --transport stdio kubeview -- npx -y kubeview-mcpВместо <…> подставьте свои значения. Ещё 19 переменных окружения — в README сервера
Командой платформы
codex mcp add kubeview --env KUBECONFIG=<KUBECONFIG> --env MCP_TRANSPORT=<MCP_TRANSPORT> --env MCP_MODE=<MCP_MODE> --env MCP_CODE_MODE_DISABLED_TOOLS=<MCP_CODE_MODE_DISABLED_TOOLS> --env MCP_ARGO_TOOLS=<MCP_ARGO_TOOLS> -- npx -y kubeview-mcpВместо <…> подставьте свои значения. Ещё 19 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"kubeview": {
"command": "npx",
"args": [
"-y",
"kubeview-mcp"
],
"env": {
"KUBECONFIG": "<KUBECONFIG>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"MCP_MODE": "<MCP_MODE>",
"MCP_CODE_MODE_DISABLED_TOOLS": "<MCP_CODE_MODE_DISABLED_TOOLS>",
"MCP_ARGO_TOOLS": "<MCP_ARGO_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 19 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"kubeview": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"kubeview-mcp"
],
"env": {
"KUBECONFIG": "<KUBECONFIG>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"MCP_MODE": "<MCP_MODE>",
"MCP_CODE_MODE_DISABLED_TOOLS": "<MCP_CODE_MODE_DISABLED_TOOLS>",
"MCP_ARGO_TOOLS": "<MCP_ARGO_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 19 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e KUBECONFIG=<KUBECONFIG> -e MCP_TRANSPORT=<MCP_TRANSPORT> -e MCP_MODE=<MCP_MODE> -e MCP_CODE_MODE_DISABLED_TOOLS=<MCP_CODE_MODE_DISABLED_TOOLS> -e MCP_ARGO_TOOLS=<MCP_ARGO_TOOLS> kubeview npx -y kubeview-mcpВместо <…> подставьте свои значения. Ещё 19 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о kubeview
Как установить kubeview в Claude Code?
Выполните команду claude mcp add kubeview -e MCP_APPROVAL_STATE_SECRET=<MCP_APPROVAL_STATE_SECRET> -- npx -y kubeview-mcp.
Что делает kubeview?
Он предоставляет агенту среду TypeScript для пакетной диагностики кластера. Запросы к API и сопоставление данных происходят внутри песочницы, поэтому в чат попадает только финальный отчёт.
Что требуется для запуска kubeview?
Понадобится среда Node.js версии 22 или выше. Также нужен доступ к кластеру через переменную KUBECONFIG или сервисный аккаунт.
