remnawave-mcp

MCP-сервер для панели Remnawave 3.x. Даёт ИИ-ассистентам — Claude, Cursor, VS Code (Copilot), Windsurf, Codex, Gemini CLI и любым другим MCP-клиентам — доступ к пользователям, нодам, трафику, устройствам, подключениям и GeoCheck. Только чтение и фильтр приватности на вашей стороне.

Как это выглядит

Related MCP server: remnawave-mcp-server

Возможности

• Только чтение по умолчанию. Ничего в панели не меняется, пока вы явно не включите запись.

• Всегда под вашу версию панели. Инструменты не написаны руками, а собираются из официального пакета @remnawave/backend-contract. Обновили панель → подняли версию пакета → пересобрали.

• Секреты недоступны никогда: вход в панель, passkey, SECRET_KEY нод, API-токены, SSH-билеты и хранилище SSH-ключей нод. Веб-терминал панели через MCP не открывается — чтобы ИИ заходил на сервер, используйте отдельный SSH MCP с ограниченным пользователем.

• Утечка чата не выдаёт ни ключей, ни клиентов. Приватные ключи Reality, пароли, UUID и ссылки подключения скрываются, а личные данные клиентов (username, email, Telegram ID, IP, HWID) заменяются псевдонимами. Подробнее — Приватность.

• Готовые отчёты одной командой: panel_overview (сводка по панели), user_report (всё о клиенте), sharing_suspects (кто делится подпиской), плюс find_user, geocheck_node, node_connections, user_connections.

• Несколько панелей в одном сервере. Подключите две-три панели (или больше) — ассистент сам выберет нужную по имени, а ответы подписаны, с какой панели они пришли. Подробнее — Несколько панелей.

• Шаблоны запросов в клиентах с поддержкой MCP-шаблонов: «Сводка по панели», «Разбор клиента», «Кто делится подпиской», «Проверка нод».

• Бережёт ноды и лимиты: повторный GeoCheck одной ноды в течение 30 минут отдаёт прошлый результат, ответы сжаты (в 2–3 раза меньше токенов), список нод и отчёт GeoCheck по умолчанию короткие (full: true — полные).

• Три способа установки: сборка из исходников (Node.js) и Docker-образ под каждую версию панели — для любого клиента; для Claude Desktop — ещё и расширение в один клик, токен хранится в защищённом хранилище системы.

Совместимость

Версия контракта должна совпадать с версией панели хотя бы по первым двум цифрам. Сервер сам подстраивается под установленный контракт (адреса, параметры и список команд берутся из него), а при подключении сверяет версию панели: если она другая, в чате появится предупреждение с подсказкой, какую сборку взять (файл расширения или версию контракта).

Как устроено

flowchart LR
    A["ИИ-клиент<br/>Claude · Cursor · VS Code…"] -- stdio --> B["<b>remnawave-mcp</b><br/>фильтр приватности<br/>только чтение · отчёты"]
    B -- HTTPS --> C["Remnawave API<br/>REST, токен"]
    C --> D["Ноды<br/>Xray"]

Документация

Установка

Сервер нужно один раз поставить на компьютер (или сервер), где работает ваш ИИ-клиент, а затем указать его в настройках клиента — см. Подключение к клиентам.

Пользуетесь Claude Desktop? Можно ничего не ставить — у него есть расширение в один клик, см. «Claude Desktop» в разделе Подключение к клиентам.

Способ 1 — из исходников (Node.js)

Нужны Node.js 22+ и Git. Windows:

winget install OpenJS.NodeJS.LTS
winget install Git.Git

После установки перезапустите PowerShell и соберите сервер:

cd C:\Tools
git clone https://github.com/3APA3A-3AHO3A/remnawave-mcp.git
cd remnawave-mcp
npm ci
npm run build
npm run list-tools

Последняя строка должна быть вида 84 API tools + 7 extra (contract 3.4.11). Сервер — это файл C:\Tools\remnawave-mcp\dist\index.js, его путь понадобится в настройках клиента.

На macOS / Linux — те же команды, путь любой (например, ~/remnawave-mcp).

Панель не 3.4.x? Поставьте контракт под свою версию и пересоберите:

npm i @remnawave/backend-contract@<версия_панели> --save-exact
npm run build

Способ 2 — Docker

Node.js не нужен — только Docker. Удобнее всего на сервере с панелью: Docker там уже есть (Remnawave сама работает в Docker).

docker pull ghcr.io/3apa3a-3aho3a/remnawave-mcp:3.4

• :3.4 — образ под панель 3.4.x; есть :3.3, :3.2, :3.1, :3.0 и :latest (текущая стабильная). Образы для amd64 и arm64, запускаются не от root.

• В настройках клиента вместо node и пути к файлу указывается docker run — готовые блоки есть в Подключение к клиентам.

• -e REMNAWAVE_API_TOKEN у docker run без значения передаёт токен в контейнер из окружения, поэтому он не светится в списке процессов (ps).

Напрямую к контейнеру панели, минуя nginx / Cloudflare и интернет — подключите контейнер MCP к Docker-сети панели:

docker network ls                      # в стандартной установке сеть называется remnawave-network
docker ps --format '{{.Names}}'        # контейнер панели — обычно remnawave

и в настройках клиента используйте адрес http://remnawave:3000 и аргументы docker run -i --rm --network remnawave-network …. При адресе http://… сервер сам добавляет заголовки, которые обычно ставит обратный прокси (X-Forwarded-Proto, X-Forwarded-For). Если панель всё равно отвечает ошибкой — используйте внешний https:// адрес.

⚠ Безопасность на сервере. MCP даёт ИИ удобные команды и прячет секреты, но не ограничивает консольных агентов (Claude Code, Codex, Gemini CLI и т.п.): если у агента есть доступ к консоли сервера, он может выполнить любую команду. Запускайте такие агенты на боевом сервере не от root, не включайте режим «разрешать всё», а токен панели давайте только с правами read.

API-токен в панели

Настройки → API-токены → Создать. Выдайте только права read:

users, nodes, hosts, hwid, connections, bandwidth-stats, system, subscriptions, subscription-request-history, internal-squads, external-squads, config-profiles, node-plugins (по желанию — остальные разделы тоже на read).

Не выдавайте write, *, а также api-tokens, passkeys, auth, keygen.

Права в Remnawave делятся на «чтение/запись», а не на GET/POST. Поэтому GeoCheck, запросы подключений и поиск пользователя работают с правами read, хотя это POST-запросы.

Подключение к клиентам

Во всех клиентах одно и то же: команда запуска сервера и две переменные — REMNAWAVE_BASE_URL (адрес панели) и REMNAWAVE_API_TOKEN (токен). Отличается только, куда это вписать.

В примерах — сервер, собранный из исходников в C:\Tools\remnawave-mcp (в JSON обратные слэши удваиваются: \\). На macOS / Linux укажите свой путь, например /home/user/remnawave-mcp/dist/index.js.

Через Docker — в любом примере замените command и args:

"command": "docker",
"args": ["run", "-i", "--rm", "-e", "REMNAWAVE_BASE_URL", "-e", "REMNAWAVE_API_TOKEN", "ghcr.io/3apa3a-3aho3a/remnawave-mcp:3.4"],

Несколько панелей — в том же блоке добавьте переменные второй панели (REMNAWAVE_2_BASE_URL, REMNAWAVE_2_API_TOKEN, …), см. Несколько панелей.

Раскройте свой клиент:

Расширение в один клик (проще всего, Node.js не нужен — он встроен в Claude Desktop):

1. Узнайте версию своей панели — она написана внизу панели Remnawave (например, 3.4.5). Откройте последний релиз и скачайте файл под неё:

Взяли не тот файл — не страшно: сервер сам сравнит версии и подскажет в чате, какой файл нужен. 2. Дважды щёлкните по файлу (или Claude → Настройки → Расширения и перетащите файл в окно). 3. Нажмите Установить и заполните адрес панели 1 и API-токен панели 1. Остальные поля можно оставить пустыми. Вторая и третья панель — поля панели 2 и панели 3 (имя, адрес, токен), см. Несколько панелей. 4. Готово — спросите в чате: «Сделай сводку по панели».

Токен хранится в защищённом хранилище Windows/macOS, а не текстом в файле. Обновление — скачать новый .mcpb и открыть его так же. Расширение подключает до трёх панелей; больше трёх, а также вторая и третья панель за Caddy или Cloudflare Access — вручную, как ниже.

Вручную (сервер из исходников или Docker): Claude → Настройки → Разработчик → Edit Config. Полностью закройте Claude (трей → Выход) и в claude_desktop_config.json добавьте сразу после первой {:

  "mcpServers": {
    "remnawave": {
      "command": "node",
      "args": ["C:\\Tools\\remnawave-mcp\\dist\\index.js"],
      "env": {
        "REMNAWAVE_BASE_URL": "https://panel.example.com",
        "REMNAWAVE_API_TOKEN": "ВАШ_ТОКЕН"
      }
    }
  },

Запятая после блока обязательна, если в файле есть другие настройки. Запустите Claude — в Настройки → Разработчик сервер должен быть в статусе running. Пример целиком: examples/claude_desktop_config.example.json.

Одна команда:

claude mcp add remnawave --scope user -e REMNAWAVE_BASE_URL=https://panel.example.com -e REMNAWAVE_API_TOKEN=ВАШ_ТОКЕН -- node "C:\Tools\remnawave-mcp\dist\index.js"

Через Docker (например, Claude Code прямо на сервере с панелью):

claude mcp add remnawave --scope user \
  -e REMNAWAVE_BASE_URL=https://panel.example.com \
  -e REMNAWAVE_API_TOKEN=ВАШ_ТОКЕН \
  -- docker run -i --rm -e REMNAWAVE_BASE_URL -e REMNAWAVE_API_TOKEN ghcr.io/3apa3a-3aho3a/remnawave-mcp:3.4

• --scope user — сервер доступен во всех проектах.

• Несколько панелей в одном сервере — добавьте -e REMNAWAVE_NAME=main -e REMNAWAVE_2_NAME=… -e REMNAWAVE_2_BASE_URL=… -e REMNAWAVE_2_API_TOKEN=…, см. Несколько панелей.

• --scope local — только в текущем проекте. Так удобно держать разные панели в разных проектах: в каждом своя команда claude mcp add со своим адресом и токеном. Настройки хранятся в личном конфиге Claude Code, а не в репозитории.

• Не используйте --scope project: он записывает сервер вместе с токеном в .mcp.json, который обычно попадает в git.

• Проверка: claude mcp list — сервер должен быть ✓ Connected.

Файл ~/.cursor/mcp.json — для всех проектов, или .cursor/mcp.json в папке проекта. Сервер появится в Settings → MCP.

{
  "mcpServers": {
    "remnawave": {
      "command": "node",
      "args": ["C:\\Tools\\remnawave-mcp\\dist\\index.js"],
      "env": {
        "REMNAWAVE_BASE_URL": "https://panel.example.com",
        "REMNAWAVE_API_TOKEN": "ВАШ_ТОКЕН"
      }
    }
  }
}

Файл .vscode/mcp.json в проекте или команда MCP: Open User Configuration — для всех проектов. Ключ здесь servers, а токен VS Code спросит при первом запуске и сохранит в защищённом хранилище — в файл он не попадает.

{
  "inputs": [
    { "type": "promptString", "id": "remnawave-token", "description": "Remnawave API token", "password": true }
  ],
  "servers": {
    "remnawave": {
      "command": "node",
      "args": ["C:\\Tools\\remnawave-mcp\\dist\\index.js"],
      "env": {
        "REMNAWAVE_BASE_URL": "https://panel.example.com",
        "REMNAWAVE_API_TOKEN": "${input:remnawave-token}"
      },
      "type": "stdio"
    }
  }
}

Шаблоны запросов в чате Copilot — через «/».

Settings → Cascade → MCP Servers → View raw config — откроется mcp_config.json.

{
  "mcpServers": {
    "remnawave": {
      "command": "node",
      "args": ["C:\\Tools\\remnawave-mcp\\dist\\index.js"],
      "env": {
        "REMNAWAVE_BASE_URL": "https://panel.example.com",
        "REMNAWAVE_API_TOKEN": "ВАШ_ТОКЕН"
      }
    }
  }
}

Значок MCP Servers в панели Cline → Configure → Configure MCP Servers — откроется cline_mcp_settings.json.

{
  "mcpServers": {
    "remnawave": {
      "command": "node",
      "args": ["C:\\Tools\\remnawave-mcp\\dist\\index.js"],
      "env": {
        "REMNAWAVE_BASE_URL": "https://panel.example.com",
        "REMNAWAVE_API_TOKEN": "ВАШ_ТОКЕН"
      }
    }
  }
}

Команда zed: open settings file (или Settings → AI → MCP Servers). Ключ здесь context_servers.

{
  "context_servers": {
    "remnawave": {
      "command": "node",
      "args": ["C:\\Tools\\remnawave-mcp\\dist\\index.js"],
      "env": {
        "REMNAWAVE_BASE_URL": "https://panel.example.com",
        "REMNAWAVE_API_TOKEN": "ВАШ_ТОКЕН"
      }
    }
  }
}

Вкладка Program справа → Install → Edit mcp.json.

{
  "mcpServers": {
    "remnawave": {
      "command": "node",
      "args": ["C:\\Tools\\remnawave-mcp\\dist\\index.js"],
      "env": {
        "REMNAWAVE_BASE_URL": "https://panel.example.com",
        "REMNAWAVE_API_TOKEN": "ВАШ_ТОКЕН"
      }
    }
  }
}

Файл ~/.codex/config.toml (формат TOML):

[mcp_servers.remnawave]
command = "node"
args = ['C:\Tools\remnawave-mcp\dist\index.js']

[mcp_servers.remnawave.env]
REMNAWAVE_BASE_URL = "https://panel.example.com"
REMNAWAVE_API_TOKEN = "ВАШ_ТОКЕН"

Файл ~/.gemini/settings.json — для всех проектов, или .gemini/settings.json в проекте.

{
  "mcpServers": {
    "remnawave": {
      "command": "node",
      "args": ["C:\\Tools\\remnawave-mcp\\dist\\index.js"],
      "env": {
        "REMNAWAVE_BASE_URL": "https://panel.example.com",
        "REMNAWAVE_API_TOKEN": "ВАШ_ТОКЕН"
      }
    }
  }
}

Удалённые клиенты (Streamable HTTP)

По умолчанию ничего не меняется: сервер использует stdio. Для HTTP установите REMNAWAVE_TRANSPORT=http и отдельный Bearer-токен. Без токена сервер не запустится. Используйте случайный ключ (например, openssl rand -hex 32), не токен панели.

export REMNAWAVE_BASE_URL=https://panel.example.com
export REMNAWAVE_API_TOKEN=YOUR_PANEL_TOKEN
export REMNAWAVE_HTTP_TOKEN="$(openssl rand -hex 32)"
REMNAWAVE_TRANSPORT=http node dist/index.js

В клиенте с поддержкой Streamable HTTP и пользовательских заголовков укажите http://127.0.0.1:3001/mcp и заголовок Authorization: Bearer <HTTP_TOKEN>. OAuth и подключение облачных клиентов, требующих OAuth, пока не поддерживаются. Браузерные запросы с заголовком Origin отклоняются.

Для удалённого доступа используйте HTTPS reverse proxy (пример фрагмента nginx внутри TLS server):

location = /mcp {
    proxy_pass http://127.0.0.1:3001;
    proxy_http_version 1.1;
    proxy_set_header Authorization $http_authorization;
    proxy_buffering off;
    proxy_read_timeout 1800s;
    client_max_body_size 1m;
}

Для Docker можно явно установить REMNAWAVE_HTTP_HOST=0.0.0.0 внутри контейнера и опубликовать порт только на loopback хоста (-p 127.0.0.1:3001:3001). Не публикуйте HTTP без TLS в интернет. Передавайте ключи через защищённый env-файл.

Каждая MCP-сессия получает собственные карты псевдонимов и кэши. В HTTP-режиме REMNAWAVE_PRIVACY_SALT игнорируется, псевдонимы не переносятся между сессиями. Лимит — 32 сессии, сессии удаляются после 30 минут без активности (проверка раз в минуту). Ключ доступа общий: это не многопользовательская авторизация; любой владелец ключа получает доступ ко всем настроенным панелям. Ограничивайте доступ и частоту запросов на reverse proxy.

Внимание: по умолчанию действуют read-only и strict privacy. Как и в stdio, REMNAWAVE_READONLY=false включает запись, а REMNAWAVE_PRIVACY=off отключает маскирование. Утечка HTTP-ключа в режиме записи означает доступ к изменению панели. Не включайте эти режимы без необходимости, используйте HTTPS и минимальные права токена панели.

Нет вашего клиента в списке? Подойдёт любой, который умеет запускать локальные MCP-серверы: укажите команду node, путь к dist/index.js и две переменные — REMNAWAVE_BASE_URL и REMNAWAVE_API_TOKEN.

Несколько панелей

Один сервер может работать сразу с несколькими панелями Remnawave. Инструментов при этом столько же, сколько с одной панелью, — у каждого появляется обязательный параметр panel со списком имён ваших панелей:

• ассистент выбирает панель по смыслу вопроса («на панели second»), а если не понял — уточняет или проверяет все и подписывает результаты;

• каждый ответ начинается со строки [panel: имя], а инструмент list_panels показывает подключённые панели и их версии;

• ID пользователей, UUID нод и хостов у каждой панели свои — сервер никогда не отправит запрос не в ту панель, а без panel запрос не выполняется вовсе;

• версия, лимит повторов GeoCheck и ошибки — отдельно по каждой панели; одна недоступная панель не мешает работать с остальными;

• псевдонимы клиентов общие: одинаковый псевдоним означает одно и то же значение, даже если он встретился в разных панелях (например, один e-mail в обеих).

Если панель одна, ничего не меняется: параметра panel нет, настройки прежние.

Настройка. Первая панель — как обычно, остальные — те же переменные с номером после REMNAWAVE_. Имена задавать необязательно (по умолчанию panel1, panel2, …), но с понятными именами ассистенту проще:

"env": {
  "REMNAWAVE_NAME": "main",
  "REMNAWAVE_BASE_URL": "https://panel.example.com",
  "REMNAWAVE_API_TOKEN": "ТОКЕН_ПАНЕЛИ_1",
  "REMNAWAVE_2_NAME": "second",
  "REMNAWAVE_2_BASE_URL": "https://panel2.example.net",
  "REMNAWAVE_2_API_TOKEN": "ТОКЕН_ПАНЕЛИ_2"
}

Третья панель — REMNAWAVE_3_…, и так далее, без ограничения. Если вторая панель стоит за Caddy или Cloudflare Access — REMNAWAVE_2_API_KEY, REMNAWAVE_2_CF_ACCESS_CLIENT_ID, REMNAWAVE_2_CF_ACCESS_CLIENT_SECRET, REMNAWAVE_2_HEADERS.

• Расширение Claude Desktop — до трёх панелей: поля панели 2 и панели 3 в настройках расширения (Настройки → Расширения → Remnawave → Configure). Пустые поля — панели нет.

• Docker — передайте и переменные второй панели: "-e", "REMNAWAVE_NAME", "-e", "REMNAWAVE_2_NAME", "-e", "REMNAWAVE_2_BASE_URL", "-e", "REMNAWAVE_2_API_TOKEN".

• Сервер собран под одну версию контракта, поэтому панели лучше держать на одной версии. Если версия одной панели другая, сервер предупредит именно про неё. Не меняйте ради неё версию контракта — сломаются остальные; такую панель подключите отдельным сервером (отдельным блоком mcpServers или вторым Docker-образом под её версию).

Старый способ — отдельный блок mcpServers на каждую панель — тоже работает, но тогда у ассистента два набора одинаковых инструментов, и в части клиентов (Cursor и др.) упирается в лимит числа инструментов.

Настройки (переменные окружения)

Адрес, токен, имя и заголовки без номера (REMNAWAVE_BASE_URL, REMNAWAVE_API_KEY, REMNAWAVE_HEADERS, CF_ACCESS_…) относятся к первой панели, с номером — к панели с этим номером. Все остальные настройки (REMNAWAVE_READONLY, REMNAWAVE_PRIVACY, лимиты, таймаут) общие для всех панелей.

Что можно спросить

Готовые шаблоны есть в клиентах, которые поддерживают MCP-шаблоны (prompts): Сводка по панели, Разбор клиента, Кто делится подпиской, Проверка нод. В остальных просто пишите текстом.

Или обычным текстом:

• «Как дела у панели?» — сводка: онлайн, офлайн-ноды, трафик, истекающие подписки

• «Разбери клиента 1234» — подписка, устройства, трафик по дням и нодам, последние запросы

• «Кто похоже делится подпиской?»

• «Сколько активных и онлайн пользователей?»

• «Найди клиента с Telegram ID 123456789, покажи устройства и срок подписки»

• «Какие ноды офлайн?» / «Трафик по нодам за прошлую неделю»

• «Сделай GeoCheck ноды NL-1»

• «Кто сейчас на ноде DE-1 и с каких IP?»

• «Топ пользователей по количеству устройств» / «Отчёт по торрентам за сутки»

• С несколькими панелями: «Сравни онлайн на main и second», «На какой панели клиент с Telegram ID 123456789?»

GeoCheck и запросы подключений выполняются на ноде и тратят её трафик. Поэтому повторный запрос для той же ноды в течение 30 минут (подключения — 2 минут) отдаёт прошлый результат с пометкой, а не нагружает ноду снова.

Приватность

Всё, что сервер отдаёт ИИ, попадает в историю чата. Поэтому ответы панели фильтруются у вас на компьютере, до отправки в чат.

Как работают псевдонимы. Вместо ivan_petrov ИИ видит user~dca596, вместо IP — ip~f055f3. Одинаковые значения дают одинаковые псевдонимы, поэтому ИИ всё равно заметит, что «у двух клиентов один IP» или «это тот же человек», но самих данных не узнает. Псевдоним можно передать обратно в команду — сервер подставит настоящее значение локально.

Настоящие данные нужны вам — откройте клиента в панели по его ID.

Чего фильтр не может: то, что вы сами пишете в чат (например, «найди Telegram ID 123…»), в чате остаётся. Спрашивайте по ID пользователя или псевдониму, когда это возможно.

Также:

• В расширении токен хранится в защищённом хранилище системы; при ручной установке — только в конфиге вашего MCP-клиента, в репозиторий не попадает.

• Каждое изменение проверяется автотестами: если что-то начнёт пропускать ключи или данные клиентов, CI станет красным.

• Используйте отдельный токен только на чтение, чтобы его можно было отозвать, не трогая боты и мониторинг.

Если не работает

Сначала проверьте сервер без клиента — в папке сервера:

$env:REMNAWAVE_BASE_URL="https://panel.example.com"; $env:REMNAWAVE_API_TOKEN="ВАШ_ТОКЕН"; node dist/index.js

Строка remnawave-mcp 1.5.0: 91 tools, read-only, privacy strict, https://panel.example.com (с несколькими панелями — … 2 panels: main (https://…), second (https://…)) значит, что сервер запускается (дальше он ждёт клиента — закройте его Ctrl+C). Ошибка вместо неё — ищите её в таблице.

Где логи сервера. Их показывает сам клиент — обычно в разделе настроек MCP или в окне вывода. Claude Desktop пишет их в файлы:

Get-Content "$env:APPDATA\Claude\logs\mcp-server-remnawave.log" -Tail 30

Проверить, что Claude Desktop видит настройки:

Get-Content "$env:APPDATA\Claude\claude_desktop_config.json" -Raw | ConvertFrom-Json | Select-Object -ExpandProperty mcpServers | Format-List

Обновление

• Расширение Claude Desktop — скачать новый .mcpb из последнего релиза и открыть.

• Docker — docker pull ghcr.io/3apa3a-3aho3a/remnawave-mcp:3.4.

• Из исходников:

cd C:\Tools\remnawave-mcp
git pull
npm ci
npm run build

После обновления перезапустите клиент.

Раз в сутки GitHub Actions сверяет последний стабильный релиз панели Remnawave с версией контракта в проекте и, если вышла новая, сам открывает Pull Request с обновлённым и собранным проектом и запускает на нём обычные проверки CI. Промежуточные сборки контракта (dev-версии между релизами) пропускаются.

Как это устроено

В пакете @remnawave/backend-contract каждая ручка API описана «командой»: адрес, метод, схемы параметров и пометка чтение/запись. Сервер при запуске проходит по всем командам и превращает каждую в MCP-инструмент, проверяя аргументы теми же схемами, что и панель. Поэтому код почти не зависит от версии Remnawave.

src/
  index.ts     — точка входа: настройки, выбор инструментов, запуск
  server.ts    — MCP-сервер: список инструментов, проверка аргументов, вызовы, шаблоны
  registry.ts  — сборка инструментов из контракта, список запрещённых
  extras.ts    — отчёты и удобные инструменты (panel_overview, user_report, …)
  validate.ts  — проверка аргументов и безопасная подстановка в адрес запроса
  views.ts     — компактный вид ответов (get_nodes и др.)
  hints.ts     — предупреждения к командам записи
  prompts.ts   — шаблоны запросов (MCP prompts)
  redact.ts    — фильтр приватности: скрытие секретов и псевдонимы
  format.ts    — компактный вывод и сокращение длинных списков
  limits.ts    — ограничение повторов GeoCheck и размера списков
  version.ts   — сверка версии панели с версией сборки
  client.ts    — HTTP-запросы к панели
  config.ts    — переменные окружения, список панелей

Для разработчиков

npm test                    # 75 тестов: приватность (ничего не утекает), отчёты, ограничения, список инструментов, несколько панелей
npm run pack:mcpb           # расширение под текущую версию → build\remnawave-3.4.mcpb
npm run pack:mcpb -- --all  # под все версии 3.x → build\remnawave-3.0.mcpb … remnawave-3.4.mcpb

• CI на каждый push: сборка, тесты, npm audit, сборка расширения (файл доступен в Actions → запуск → Artifacts).

• Релиз: поднять версию в package.json, добавить раздел в CHANGELOG.md, затем на сайте Releases → Draft a new release (тег vX.Y.Z) или из консоли git tag vX.Y.Z + git push origin vX.Y.Z. GitHub сам соберёт, прогонит тесты и приложит файлы .mcpb под все версии 3.x; пустой текст релиза заполнится из CHANGELOG.

• Перед релизом поправьте статичные бейджи в шапке обоих README (поддерживаемые версии Remnawave, число тестов), а при смене подписей — баннер и пример диалога в docs/ (это SVG, текст в них правится как в обычном файле).

• Новая версия панели: раз в сутки workflow сверяет стабильный релиз Remnawave и открывает PR с обновлённым контрактом.

Благодарности

Идея — TrackLine/mcp-remnawave (под Remnawave 2.x).

Режим Streamable HTTP для удалённых клиентов — Иван Зорин (@localzet), #24.

Лицензия

MIT