# kubernetes-mcp-server

Даёт агенту доступ к кластеру Kubernetes и OpenShift: поды, логи, Helm, Tekton. Пригодится, когда нужно смотреть и менять ресурсы прямо из чата.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 2180
- Автор: containers
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/containers/kubernetes-mcp-server
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/kubernetes-mcp-server

## Что делает

Сервер написан на Go и общается с API-сервером Kubernetes напрямую, а не через `kubectl` или `helm`. Поэтому внешние утилиты на машине не нужны: если ставить нативный бинарник, Node и Python тоже не понадобятся. Есть сборки под Linux, macOS и Windows, а ещё npm-пакет, Python-пакет и образ контейнера.

Что умеет: любые CRUD-операции с ресурсами Kubernetes и OpenShift, работа с подами (список, логи, `exec`, метрики, удаление, запуск образа), неймспейсы, события, проекты OpenShift. Отдельно идут Helm (установка, список, удаление релизов) и Tekton: запуск Pipeline и Task, перезапуск и отмена PipelineRun, логи через разрешение пода. Конфигурацию сервер подхватывает из `.kube/config` и следит за её изменениями. Можно работать сразу с несколькими кластерами из kubeconfig.

Настраивается аргументами командной строки, TOML-файлом и переменными окружения. Опционально включается трассировка и метрики OpenTelemetry со своими частотами сэмплирования, плюс эндпоинт `/stats`. Без доступа к кластеру сервер бесполезен — это первое, что нужно проверить перед установкой.

## Требования
- Нужно: Node.js (команды через npx)
- Работает с: Kubernetes

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add kubernetes-mcp-server -- npx -y kubernetes-mcp-server
```

### Codex

**Командой платформы**
```bash
codex mcp add kubernetes-mcp-server -- npx -y kubernetes-mcp-server
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kubernetes-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "kubernetes-mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "kubernetes-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "kubernetes-mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add kubernetes-mcp-server npx -y kubernetes-mcp-server
```

## Когда брать
- посмотреть логи пода, не переключаясь в терминал
- выполнить команду внутри контейнера через `exec`
- поставить или снести Helm-релиз из чата
- запустить Tekton Pipeline и забрать его логи
- проверить события в неймспейсе, когда что-то падает

## Примеры запросов агенту
- Покажи логи пода `api-7d9f` в неймспейсе `prod`
- Запусти Tekton Pipeline `build` в неймспейсе `ci`
- Сколько CPU и памяти едят поды в неймспейсе `staging`?

## Похожие
- [kubernetes-specialist](https://affpapa.org/nevibecode/skills/kubernetes-specialist.md) — скилл · 14100 установок
- [kubernetes-skill](https://affpapa.org/nevibecode/skills/kubernetes-skill.md) — скилл · 1400 установок
- [kubernetes](https://affpapa.org/nevibecode/skills/kubernetes.md) — скилл · 1000 установок
- [Kubernetes taste](https://affpapa.org/nevibecode/prompts/kubernetes-taste.md) — промпт · ★ 174597
- [openshift](https://affpapa.org/nevibecode/skills/openshift.md) — скилл · 349 установок
- [project-references](https://affpapa.org/nevibecode/skills/project-references.md) — скилл · 3900 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md