kubefwd — MCP-сервер для Claude Code: что делает и как установить
Перенаправляет сервисы Kubernetes на локальную машину с отдельными IP-адресами и записями в /etc/hosts. Пригодится для отладки без правки сетевых адресов.
Открыть на GitHubЧто делает kubefwd
Утилита находит сервисы в выбранном пространстве имён Kubernetes и пробрасывает их на рабочий компьютер. Каждому сервису достаётся персональный адрес из диапазона 127.x.x.x, а имена служб попадают в /etc/hosts. Поэтому локальные приложения обращаются к базам данных и микросервисам по тем же сетевым адресам, что и внутри кластера.
Внутри есть интерактивный терминальный интерфейс для мониторинга сетевого трафика и просмотра логов контейнеров. При перезапуске подов соединение восстанавливается автоматически. Для управления предусмотрены REST API и протокол MCP, через который к кластеру подключаются AI-ассистенты.
Для запуска обязательны настроенный kubectl с доступом к кластеру и права суперпользователя. Без sudo программа не сможет выделить сетевые интерфейсы и изменить системный файл /etc/hosts.
Какие задачи решает
- Пробрасывать сервисы пространства имён Kubernetes одной командой
- Устранять конфликты портов через выделение разных IP-адресов 127.x.x.x
- Обращаться к сервисам кластера по их штатным доменным именам
- Восстанавливать сетевые туннели при перезапуске подов
- Отслеживать сетевой трафик и читать логи контейнеров в TUI
Примеры запросов агенту
- Запусти kubefwd для сервисов в пространстве имён default с интерфейсом TUI
- Пробрось сервисы из неймспейсов default и staging через kubefwd
- Подключи kubefwd с фильтром по метке app=api и флагом REST API
Как установить kubefwd
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о kubefwd
Как установить kubefwd?
Утилиту ставят через пакетный менеджер: brew install kubefwd на macOS или winget install txn2.kubefwd на Windows. Для Linux доступны готовые пакеты в релизах репозитория.
Что делает kubefwd?
Программа массово пробрасывает сервисы Kubernetes на локальный компьютер разработчика. Она назначает каждому сервису свой IP-адрес 127.x.x.x и прописывает имена служб в /etc/hosts.
Какие системные требования нужны для запуска kubefwd?
Понадобится настроенный kubectl с правами доступа к кластеру. Также требуются права sudo, так как утилита создаёт сетевые псевдонимы и правит системный файл хостов.
