# Netra

Netra помогает исследовать сетевые сбои в Linux и Kubernetes: показывает причины сброса соединений и позволяет запускать ограниченные по времени блокировки.

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

## Что делает

Netra связывает ИИ-агента с наблюдением за сетью на базе eBPF. Сервер предоставляет 190 инструментов: с их помощью агент может разбирать причины сбросов соединений, исследовать сетевой путь и перегрузки, а также работать с захватом пакетов. Сбор содержимого пакетов не ведётся.

Для экстренного контроля Netra поддерживает блокировки с ограниченным сроком действия: по окончании срока они возвращаются в режим наблюдения. Изменяющие действия закрыты за переменной `NETRA_MCP_ALLOW_MUTATIONS`. Это важно учитывать при настройке: без разрешения переменной агент не сможет выполнять такие действия. Netra работает без смены CNI; интеграции с Cilium и Hubble необязательны.

Для подключения в Claude Code команда запускает Docker-образ MCP-сервера и передаёт адрес Netra, API-ключ и параметры доступа через переменные окружения. Нужны `NETRA_URL`, `NETRA_API_KEY`, `NETRA_MCP_ALLOW_MUTATIONS` и `NETRA_MCP_ACTOR`.

## Требования
- Нужно: Docker
- Переменные окружения: `NETRA_URL`, `NETRA_API_KEY`, `NETRA_MCP_ALLOW_MUTATIONS`, `NETRA_MCP_ACTOR` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env NETRA_URL=<NETRA_URL> --env NETRA_API_KEY=<NETRA_API_KEY> --env NETRA_MCP_ALLOW_MUTATIONS=<NETRA_MCP_ALLOW_MUTATIONS> --env NETRA_MCP_ACTOR=<NETRA_MCP_ACTOR> --transport stdio netra -- docker run -i --rm -e NETRA_URL -e NETRA_API_KEY -e NETRA_MCP_ALLOW_MUTATIONS -e NETRA_MCP_ACTOR ghcr.io/zyvorai/netra-mcp:0.32.0
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add netra --env NETRA_URL=<NETRA_URL> --env NETRA_API_KEY=<NETRA_API_KEY> --env NETRA_MCP_ALLOW_MUTATIONS=<NETRA_MCP_ALLOW_MUTATIONS> --env NETRA_MCP_ACTOR=<NETRA_MCP_ACTOR> -- docker run -i --rm -e NETRA_URL -e NETRA_API_KEY -e NETRA_MCP_ALLOW_MUTATIONS -e NETRA_MCP_ACTOR ghcr.io/zyvorai/netra-mcp:0.32.0
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "netra": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "NETRA_URL",
                "-e",
                "NETRA_API_KEY",
                "-e",
                "NETRA_MCP_ALLOW_MUTATIONS",
                "-e",
                "NETRA_MCP_ACTOR",
                "ghcr.io/zyvorai/netra-mcp:0.32.0"
            ],
            "env": {
                "NETRA_URL": "<NETRA_URL>",
                "NETRA_API_KEY": "<NETRA_API_KEY>",
                "NETRA_MCP_ALLOW_MUTATIONS": "<NETRA_MCP_ALLOW_MUTATIONS>",
                "NETRA_MCP_ACTOR": "<NETRA_MCP_ACTOR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "netra": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "NETRA_URL",
                "-e",
                "NETRA_API_KEY",
                "-e",
                "NETRA_MCP_ALLOW_MUTATIONS",
                "-e",
                "NETRA_MCP_ACTOR",
                "ghcr.io/zyvorai/netra-mcp:0.32.0"
            ],
            "env": {
                "NETRA_URL": "<NETRA_URL>",
                "NETRA_API_KEY": "<NETRA_API_KEY>",
                "NETRA_MCP_ALLOW_MUTATIONS": "<NETRA_MCP_ALLOW_MUTATIONS>",
                "NETRA_MCP_ACTOR": "<NETRA_MCP_ACTOR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e NETRA_URL=<NETRA_URL> -e NETRA_API_KEY=<NETRA_API_KEY> -e NETRA_MCP_ALLOW_MUTATIONS=<NETRA_MCP_ALLOW_MUTATIONS> -e NETRA_MCP_ACTOR=<NETRA_MCP_ACTOR> netra docker run -i --rm -e NETRA_URL -e NETRA_API_KEY -e NETRA_MCP_ALLOW_MUTATIONS -e NETRA_MCP_ACTOR ghcr.io/zyvorai/netra-mcp:0.32.0
```
Вместо <…> подставьте свои значения

## Когда брать
- найти причину сброса сетевого соединения
- разобрать перегрузку на сетевом пути Linux
- запустить захват пакетов на выбранном узле
- временно ограничить нежелательный сетевой трафик

## Примеры запросов агенту
- Разбери причины сбросов соединений в этом кластере.
- Исследуй сетевой путь и найди, где возникает перегрузка.
- Покажи, какие соединения затронет временная блокировка, прежде чем применять её.

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23654
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18779
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17191
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12110

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