Skip to main content
Glama
remnawave-mcp

remnawave-mcp

by folexz

remnawave-mcp

npm version CI license node

Ein MCP-Server für die Remnawave-Panel-API.

Veröffentlicht unter dem @folexz-Scope: Der ungescopte Name remnawave-mcp auf npm gehört zu einem unabhängigen Projekt, das auf Remnawave 2.7.4 abzielt und mit 2.8.0+ nicht funktioniert.

npx -y @folexz/remnawave-mcp   # configured via REMNAWAVE_BASE_URL + REMNAWAVE_API_TOKEN_READ/_WRITE

Es deckt alle 205 Operationen über 28 Controller der Remnawave-API v3.3.2 ab — Benutzer, Knoten, Hosts, Konfigurationsprofile, Squads, Abonnements, Knoten-Plugins, Infra-Abrechnung, System- Statistiken — generiert aus dem eigenen OpenAPI-Dokument des Panels, nicht handgeschrieben. Wenn du eine neuere Spezifikation an npm run build-spec übergibst, folgt die Tool-Oberfläche.

Highlights

  • Spezifikationsgetrieben und selbstaktualisierend. npm run update-spec holt das neueste OpenAPI-Dokument aus der eigenen veröffentlichten Kopie von Remnawave und baut den Katalog neu auf; das Eingabeschema jedes Tools stammt direkt aus den Parametern und dem Anforderungstext der Operation. Nichts an der API ist handgeschrieben, und der Neubau gibt einen Diff aus, der jede hinzugefügte, entfernte oder umbenannte Operation nennt, sodass ein Versionssprung nicht stillschweigend ein Tool fallen lassen kann.

  • Begrenzte Kontextkosten. 205 typisierte Tools würden ~39k Tokens von tools/list bei jeder Anfrage kosten. Das Standardprofil stellt 5 Tools (~1.4k Tokens) bereit und erreicht trotzdem jede Operation — siehe Warum nicht 205 Tools.

  • Zwei-Token-Prinzip der geringsten Rechte. Ein Lesetoken und ein optionales Schreib-Token. GET verwendet das Lesetoken; POST/PATCH/PUT/DELETE verwenden das Schreib-Token. Ohne ein Schreib-Token werden mutierende Tools überhaupt nicht registriert — der Server ist physisch schreibgeschützt.

  • Schutzmechanismen für ein Live-Panel. Mutationen werden mit einem Mindestintervall serialisiert und mit Backoff erneut versucht, weil jeder Konfigurationsschreibvorgang das Panel dazu bringt, die Konfiguration an alle Knoten zu pushen und Xray neu zu starten. Massen- und Löschoperationen erfordern zusätzlich confirm: true.

  • Eingebaute Feldnotizen. Die unten genannten Stolperfallen sind an den betroffenen Operationen angebracht, sodass sie in der Tool-Beschreibung und in der Ausgabe von remnawave_describe_operation erscheinen.

  • Keine Anfragen, die nicht erfolgreich sein können. 16 Endpunkte (Auth, Passkeys, API-Token-Verwaltung) werden nur an ein eingeloggtes Admin-JWT ausgeliefert und lehnen API-Tokens ab. Sie werden aus der Spezifikation erkannt und lokal mit einer Erklärung abgelehnt, anstatt gesendet zu werden.

  • Notausgänge. remnawave_request_read / remnawave_request_write erreichen jeden Pfad, einschließlich undokumentierter Routen und Abfragesyntax, die OpenAPI nicht ausdrücken kann.

Related MCP server: mcp-remnawave

Anforderungen

  • Node.js ≥ 18

  • Ein Remnawave-Panel (3.x), das über HTTPS erreichbar ist

  • Ein API-Token vom Panel: Einstellungen → API-Tokens. Remnawave 3.x unterstützt gescopte Tokens — erstelle eines mit Lese-Scopes und, wenn du Mutationen möchtest, ein zweites mit Schreib-Scopes.

Installation

Der schnelle Weg ist npx — siehe Registrierung mit Claude Code. Um aus dem Quellcode auszuführen:

git clone https://github.com/folexz/remnawave-mcp.git
cd remnawave-mcp
npm install
npm run build

Konfiguration

Die gesamte Konfiguration erfolgt über Umgebungsvariablen, die von deinem MCP-Host bereitgestellt werden. Es werden keine Dateien gelesen.

Variable

Erforderlich

Standard

Beschreibung

REMNAWAVE_BASE_URL

ja

—

Panel-Ursprung, z. B. https://panel.example.com (ohne /api-Suffix).

REMNAWAVE_API_TOKEN_READ

ja

—

Lesetoken. Alias: REMNAWAVE_API_TOKEN, damit der eigene .env-Name des Panels funktioniert.

REMNAWAVE_API_TOKEN_WRITE

nein

—

Schreib-Token. Weglassen, um schreibgeschützt zu laufen.

REMNAWAVE_TOOL_PROFILE

nein

minimal

minimal | core | full — wie viele typisierte Tools beworben werden.

REMNAWAVE_CONTROLLERS

nein

—

Kommagetrennte Controller-Slugs; überschreibt die Auswahl der typisierten Tools des Profils.

REMNAWAVE_MAX_SCHEMA_BYTES

nein

2000

Eingabeschemata, die größer sind, werden in tools/list zusammengefaltet.

REMNAWAVE_WRITE_MIN_INTERVAL_MS

nein

1500

Mindestabstand zwischen zwei Mutationen.

REMNAWAVE_MAX_RETRIES

nein

3

Wiederholungen bei Transportfehlern, 429 und 5xx.

REMNAWAVE_TIMEOUT_MS

nein

30000

Timeout pro Anfrage.

REMNAWAVE_SKIP_CONFIRM

nein

0

1 entfernt die confirm: true-Anforderung bei destruktiven Operationen.

REMNAWAVE_ALLOW_ADMIN_JWT_OPS

nein

0

1 erlaubt die 16 Admin-JWT-only-Endpunkte (nur setzen, wenn dein Token ein Admin-JWT ist).

Registrierung mit Claude Code

Schreibgeschützt (empfohlener Standard):

claude mcp add remnawave --scope user \
  --env REMNAWAVE_BASE_URL=https://panel.example.com \
  --env REMNAWAVE_API_TOKEN_READ=your_read_token \
  -- npx -y @folexz/remnawave-mcp@latest

Mit aktivierten Mutationen und typisierten Tools für die alltäglichen Controller:

claude mcp add remnawave --scope user \
  --env REMNAWAVE_BASE_URL=https://panel.example.com \
  --env REMNAWAVE_API_TOKEN_READ=your_read_token \
  --env REMNAWAVE_API_TOKEN_WRITE=your_write_token \
  --env REMNAWAVE_TOOL_PROFILE=core \
  -- npx -y @folexz/remnawave-mcp@latest

@latest sorgt dafür, dass npx bei jedem Start die neueste veröffentlichte Version auflöst. Um einen lokalen Build auszuführen, ersetze den Befehl durch node /absolute/path/to/remnawave-mcp/dist/index.js.

Registrierung mit Claude Desktop / anderen MCP-Clients

{
  "mcpServers": {
    "remnawave": {
      "command": "npx",
      "args": ["-y", "@folexz/remnawave-mcp@latest"],
      "env": {
        "REMNAWAVE_BASE_URL": "https://panel.example.com",
        "REMNAWAVE_API_TOKEN_READ": "your_read_token"
      }
    }
  }
}

Warum nicht 205 Tools

tools/list wird bei jeder Anfrage erneut an das Modell gesendet, daher ist seine serialisierte Größe eine dauerhafte Kontextsteuer. Gemessen an dieser Spezifikation (npx tsx scripts/tool-stats.ts):

Profil

Tools (Lesen+Schreiben)

tools/list

≈ Tokens

Tools (nur Lesen)

≈ Tokens

minimal

5

5.6 KB

~1.4k

4

~1.2k

core

91

71 KB

~17.8k

38

~5.9k

full

210

156 KB

~39k

92

~13.9k

Remnawaves DTOs sind der Grund, warum full so teuer ist: Ein einzelnes dereferenziertes Host-Objekt ist ~30 KB JSON-Schema für sich, weil es jede eingehende und Sicherheitsvariante einbettet.

Der Server wählt also nicht zwischen „ein Tool pro Operation“ und „einem stumpfen Dispatcher“ — er liefert beides und lässt das Profil entscheiden, wie viel beworben wird:

  1. Katalog-Tools (immer aktiv, 3 Tools). remnawave_list_operations durchsucht und sucht den Katalog und gibt eine kompakte Zeile pro Operation zurück; remnawave_describe_operation gibt das vollständige JSON-Schema plus Feldnotizen für eine Operation zurück; remnawave_call führt jede der 205 nach Namen aus. Die übliche Schleife ist Liste → Beschreiben → Aufrufen, und sie kostet dieselben 1,4k Tokens, egal wie groß die API wird. Das ist dieselbe Lazy-Loading-Idee, die ein Agent-Harness verwendet, wenn es Tool-Schemata aufschiebt.

  2. Typisierte Tools (profilausgewählt). Ein generiertes Tool pro Operation für die Controller, mit denen du tatsächlich arbeitest — core deckt Benutzer, Knoten, Hosts, Konfigurationsprofile, interne Squads, System und die beiden Bulk-Action-Controller ab; full deckt alles ab; minimal nichts. Schemata über REMNAWAVE_MAX_SCHEMA_BYTES behalten ihre Top-Level-Felder und lassen die Verschachtelung weg, mit einem Verweis auf remnawave_describe_operation für die vollständige Version.

  3. Notausgänge (2 Tools). Rohes GET und rohes Schreiben für alles, was die Spezifikation übersieht.

Jede Route läuft durch denselben Executor, sodass das Schreib-Gate, das Destruktiv-Bestätigungs-Gate, Pfad-Templating und Abfragebehandlung identisch funktionieren, egal welche Oberfläche du verwendest.

Wähle ein Profil nach Geschmack: minimal, wenn du viele MCP-Server verbunden hast, core, wenn du die alltäglichen Operationen mit einem Aufruf erreichbar haben möchtest, full, wenn Kontext keine Rolle spielt.

Feldnotizen — Verhalten, das die Spezifikation nicht dokumentiert

Alle diese Punkte wurden gegen ein Live-3.3.2-Panel getestet und sind an den betroffenen Operationen in den Tool-Beschreibungen angebracht.

  • PATCH /api/config-profiles ist ein Ersetzen, kein Patchen. Der Body ist {uuid, config} und config muss die vollständige, gültige Xray-Konfiguration sein. Ein Fragment schlägt fehl mit A061: Config doesn't have inbounds. Korrekte Reihenfolge: GET /api/config-profiles/{uuid} → das zurückgegebene config-Objekt direkt bearbeiten → PATCH das Ganze zurück.

  • Das Panel antwortet nicht auf 127.0.0.1:3000, selbst vom Panel-Host aus und obwohl docker-proxy dort lauscht (curl gibt Exit 52 zurück, leere Antwort). Verwende immer den öffentlichen HTTPS-Ursprung mit einem Bearer-Token.

  • Jede Antwort ist in {"response": ...} eingebettet. Dieser Server entpackt sie, sodass die Tool-Ausgabe die Nutzlast selbst ist.

  • Ein Host bindet sich über das verschachtelte inbound.configProfileUuid an ein Profil (plus inbound.configProfileInboundUuid), nicht über ein Top-Level-configProfileUuid. Verifiziert gegen Live-Hosts: verschachtelt vorhanden, Top-Level fehlt.

  • Eine Reihe von PATCHes bringt das Panel zum Absturz. Jeder Konfigurationsschreibvorgang pusht an jeden Knoten und startet dort Xray neu; mehrere hintereinander und der eigene TLS-Listener des Panels antwortet nicht mehr. Der Client serialisiert Mutationen (REMNAWAVE_WRITE_MIN_INTERVAL_MS, Standard 1500 ms) und wiederholt Transportfehler mit exponentiellem Backoff und Jitter. Umgehe das nicht, indem du Bulk-Updates parallel auslöst.

  • POST /api/subscription-templates erstellt nur eine leere Vorlage. Der Inhalt wird durch ein separates PATCH /api/subscription-templates hochgeladen. JSON- und YAML-Bodies können nicht im selben Aufruf aktualisiert werden.

  • serverDescription auf einem Host ist auf 30 Zeichen begrenzt (bestätigt durch maxLength in der Spezifikation). Es ist auch das, was einen Hysteria2-Host in Happ ordentlich rendern lässt statt als rohes JSON.

  • Sechzehn Endpunkte sind nur für Admin-JWT — die gesamten auth- und passkeys-Controller plus API-Token-Verwaltung (GET/POST /api/tokens, DELETE /api/tokens/{uuid}, GET /api/tokens/scopes). Das Panel antwortet dort auf ein API-Token mit 401/403. Dieser Server erkennt sie aus der Spezifikation und lehnt sie lokal ab; REMNAWAVE_ALLOW_ADMIN_JWT_OPS=1 hebt die Sperre auf, wenn das konfigurierte Token wirklich ein Admin-JWT ist.

  • GET /api/users/stream antwortet mit zeilengetrenntem JSON, nicht mit einem Dokument. Es wird in ein Array von Benutzerdatensätzen geparst, anstatt als Textblob zurückgegeben zu werden.

  • PATCH /api/hosts ist ein echtes partielles Patch — {uuid, serverDescription} allein funktioniert. Nur Konfigurationsprofile haben die Ersetze-das-Ganze-Semantik. Live verifiziert.

  • Fehler kommen als {message, errorCode} zurück; der errorCode (z. B. A061) ist im Fehlertext dieses Servers enthalten.

Tool-Abdeckung

Jeder Controller ist über remnawave_call und die Notausgänge erreichbar. Die typisierte Spalte zeigt, welche unter REMNAWAVE_TOOL_PROFILE=core einzelne Tools erhalten.

Controller-Slug

Operationen

Unter core typisiert

users

17

ja

node-plugins

18

—

nodes

15

ja

infra-billing

12

—

internal-squads

12

ja

system

12

ja

users-bulk-actions

10

ja

config-profiles

9

ja

external-squads

8

—

auth

7

—

bandwidth-stats

7

—

connections

7

—

hosts

7

ja

hwid-user-devices

7

—

subscription-page-configs

7

—

subscriptions

7

—

subscription-template

6

—

node-integrations

5

—

passkeys

5

—

snippets

5

—

api-tokens

4

—

hosts-bulk-actions

4

ja

metadata

4

—

public-subscription

3

—

remnawave-settings

2

—

subscription-request-history

2

—

subscription-settings

2

—

keygen

1

—

Gesamt

205

Führe remnawave_list_operations gegen einen laufenden Server aus, um den exakten, aktuellen Satz zu erhalten.

Beispiele

Durchsuchen und aufrufen ohne typisierte Tools:

// 1. What is there?
{ "tool": "remnawave_list_operations", "arguments": { "controller": "nodes" } }

// 2. What does it take?
{ "tool": "remnawave_describe_operation",
  "arguments": { "operation": "remnawave_post_nodes_uuid_actions_restart" } }

// 3. Do it.
{ "tool": "remnawave_call",
  "arguments": { "operation": "remnawave_post_nodes_uuid_actions_restart",
                 "params": { "uuid": "…" } } }

params, body und query können auch als JSON-Text ankommen — "params": "{\"uuid\":\"…\"}" — weil einige MCP-Clients untypisierte Tool-Argumente wörtlich weiterreichen, statt sie zu parsen. Der String wird für dich geparst; einer, der kein JSON ist, wird mit einer entsprechenden Meldung abgelehnt.

Ein Config-Profil sicher bearbeiten (die A061-Falle):

// Read the whole profile first — PATCH replaces the config wholesale.
{ "tool": "remnawave_call",
  "arguments": { "operation": "remnawave_get_config_profiles_uuid", "params": { "uuid": "…" } } }

// Send the full, edited config back.
{ "tool": "remnawave_call",
  "arguments": { "operation": "remnawave_patch_config_profiles",
                 "params": { "body": { "uuid": "…", "config": { /* complete Xray config */ } } } } }

Abfragesyntax, die die Spezifikation nicht ausdrücken kann:

{ "tool": "remnawave_request_read",
  "arguments": { "path": "/api/users",
                 "query": { "size": 25, "start": 0,
                            "filters[0][id]": "status", "filters[0][value]": "ACTIVE" } } }

Testen

npm run build
npm test            # 50 unit tests + the offline smoke suite
npm run test:unit   # unit tests alone

Die Unit-Tests decken die Teile ab, die stillschweigend fehlschlagen: $ref-Erweiterung durch Remnawaves rekursive DTOs, Ableitung der Tool-Namen (Längenbudget, Determiniertheit, Kollisionserkennung), der Katalog-Diff, beide Schreib-Gates, das Admin-JWT-Gate, Schema-Kollabierung und NDJSON-Parsing.

Schreibgeschützte Prüfungen gegen ein echtes Panel

Mit einem erreichbaren Panel und einem Lese-Token in der Umgebung führt das Smoke-Skript auch Live- Aufrufe im Nur-Lese-Modus aus (niemals eine Mutation):

REMNAWAVE_BASE_URL=https://panel.example.com \
REMNAWAVE_API_TOKEN_READ="$REMNAWAVE_API_TOKEN" \
npm run smoke

Führe es dort aus, wo das Token bereits liegt (z. B. auf dem Panel-Host), damit das Geheimnis nie reist. Das Skript gibt Formen aus — Typen, Schlüsselnamen, Array-Längen — und niemals Payload-Werte, sodass seine Ausgabe bedenkenlos in ein Issue eingefügt werden kann.

Schutzprüfungen zeigen absichtlich auf http://127.0.0.1:9, sodass ein Gate, das jemals offen fehlschlägt, kein echtes Panel erreichen könnte.

Verifizieren des Schreibpfads

Lesevorgänge können nicht beweisen, dass Token-Routing, Drosselung, Bestätigungs-Gate und Teil-Patch-Semantik tatsächlich funktionieren. scripts/write-check.mjs beweist sie an Objekten, an denen niemand hängt, und stellt das eine bereits vorhandene Objekt, das es berührt, wieder her:

REMNAWAVE_BASE_URL=https://panel.example.com \
REMNAWAVE_API_TOKEN_READ="$T" REMNAWAVE_API_TOKEN_WRITE="$T" \
node scripts/write-check.mjs --i-understand-this-mutates [--host-uuid <uuid>]

Es erstellt ein internes Squad ohne Inbounds und ohne Mitglieder und löscht es wieder, dann überschreibt es serverDescription auf einem Host und stellt den ursprünglichen Wert wieder her. Es weigert sich, ohne das Bestätigungs-Flag zu starten, und meldet einen Exit-Code ungleich Null, wenn etwas zurückbleibt.

Gegen ein Live-3.3.2-Panel bestätigte es: Das Bestätigungs-Gate hält bei einem echten DELETE; ein partielles PATCH /api/hosts funktioniert; das Panel lehnt eine 31 Zeichen lange serverDescription ab; der ursprüngliche Wert (einschließlich null) übersteht den Roundtrip; und aufeinanderfolgende Mutationen waren 1525 und 1524 ms voneinander entfernt bei einem konfigurierten Minimum von 1500 ms.

Lokal inspizieren

REMNAWAVE_BASE_URL=https://panel.example.com REMNAWAVE_API_TOKEN_READ=xxx npm run inspect

Aktualisieren der API-Spezifikation

Alles an der API stammt aus einer Datei, sodass das Verfolgen einer neuen Remnawave-Version ein einziger Befehl ist:

npm run update-spec            # fetch the newest spec + rebuild the catalogue
npm run update-spec -- --strict  # additionally fail if any operation disappeared or was renamed
npm run build && npm test      # compile and verify

Woher die Spezifikation stammt

https://cdn.remna.st/docs/openapi.json — veröffentlicht von Remnawaves eigenem Build&Push OpenAPI Specs-Workflow bei jedem Upstream-Tag, sodass sie immer die neueste Version beschreibt. Überschreibe mit --url <u> oder REMNAWAVE_SPEC_URL, um eine andere Quelle festzulegen.

Eine Panel-Instanz ist keine brauchbare Quelle: Dokumentation ist deaktiviert, sofern die Bereitstellung sie nicht aktiviert, und selbst dann ist Swagger unter /backend-tools/swagger gemountet, das der übliche Reverse-Proxy nicht routet. Das Abfragen eines Live-3.3.2-Panels ergab 404 auf jedem herkömmlichen Spezifikationspfad.

Der Download wird erst nach dem Parsen als OpenAPI-Dokument mit nicht-leerem paths auf die Festplatte geschrieben, sodass eine Fehlerseite oder ein Captive Portal eine funktionierende Spezifikation nicht überschreiben kann.

Was danach zu prüfen ist

build-spec vergleicht den neuen Katalog mit dem vorherigen und gibt jede Änderung aus:

build-spec: Remnawave API v3.4.0 -> 211 operations, 28 controllers, 315 KB
  methods: DELETE=22 GET=90 PATCH=19 POST=78 PUT=2  admin-JWT-only: 16
  diff: API version 3.3.2 -> 3.4.0
  REMOVED — tools that will disappear (1):
    remnawave_get_old_thing  (GET /api/old-thing)
  added (7):
    ...
  • REMOVED / RENAMED sind brechend für alle, deren Prompts oder Skripte diese Tools benennen. --strict macht daraus einen Exit-Code ungleich Null, was das Flag ist, das die Automatisierung verwenden sollte.

  • added ist sicher; die neuen Operationen sind sofort über remnawave_call erreichbar und erhalten typisierte Tools, wenn ihr Controller im aktiven Profil ist.

  • schema changed ist einen Blick wert für die Operationen, die du tatsächlich verwendest.

npm test prüft dann erneut, dass der Katalog auf der Festplatte mit einem frischen Build übereinstimmt, dass alle Tool-Namen eindeutig und innerhalb des 64-Zeichen-Budgets liegen und dass die Schutzmechanismen weiterhin gelten.

Automatisieren

npm run update-spec -- --strict   # exits non-zero on a breaking catalogue change
npm test
npm version minor --no-git-tag-version
git commit -am "chore: Remnawave API 3.4.0" && git push
git tag "v$(node -p "require('./package.json').version")" && git push --tags

Der gepushte Tag löst den Release-Workflow aus, der erneut auf npm veröffentlicht. Clients, die mit @folexz/remnawave-mcp@latest registriert sind, übernehmen die neue Version bei ihrem nächsten Start.

Veröffentlichen (Maintainer)

Erste Veröffentlichung — notwendigerweise manuell

npm kann keinen vertrauenswürdigen Publisher für ein Paket konfigurieren, das noch nicht existiert: Die Einstellung liegt auf der eigenen Einstellungsseite des Pakets. Das ist eine bekannte, noch offene Einschränkung (npm/cli#8544), und sie gilt auch für Scoped-Pakete. Version 0.1.0 muss also von einer angemeldeten Maschine aus veröffentlicht werden:

npm whoami            # must print the account that owns the @folexz scope
npm publish --access public

--access public ist erforderlich: Scoped-Pakete sind standardmäßig auf restricted gesetzt.

Dann Wechsel zu tokenlosen Releases

Sobald das Paket existiert, füge auf npmjs.com → @folexz/remnawave-mcp → Settings → Trusted Publisher einen GitHub-Actions-Publisher mit Repository folexz/remnawave-mcp und Workflow release.yml hinzu. repository.url in package.json muss exakt mit dem GitHub-Repository übereinstimmen — tut es.

Danach veröffentlicht .github/workflows/release.yml bei jedem gepushten vX.Y.Z-Tag per OIDC — ohne Token, ohne Secret, mit automatisch angehängter Provenienz:

npm version patch --no-git-tag-version
git commit -am "chore: v0.1.1"
git push
git tag v0.1.1 && git push origin v0.1.1

Der Workflow installiert aus der Lockfile neu, baut neu, führt die Unit-Tests und die Offline-Smoke-Suite aus und schlägt schnell fehl, wenn der Tag nicht mit package.json übereinstimmt.

Clients, die mit @folexz/remnawave-mcp@latest registriert sind, übernehmen die neue Version bei ihrem nächsten Start.

Sicherheitshinweise

  • Tokens werden nur aus der Umgebung gelesen und niemals protokolliert. Logs gehen nach stderr; stdout ist der MCP-JSON-RPC-Kanal.

  • Bevorzuge die Konfiguration nur von REMNAWAVE_API_TOKEN_READ. Mutierende Tools existieren ohne Schreib-Token nicht, sodass ein kompromittierter oder verwirrter Client das Panel nicht ändern kann.

  • Abonnement-Endpunkte geben funktionierende Client-Konfigurationen zurück. Behandle ihre Ausgabe als geheim.

  • Committe niemals echte Tokens. .env ist gitignored; .env.example zeigt die Form.

Bekannte Einschränkungen

  • Die Body-Validierung ist an das Panel delegiert. Dieser Server prüft nur, ob erforderliche Argumente und ein erforderlicher body vorhanden sind; er validiert die innere Form des Bodys nicht gegen das Schema. Das ist beabsichtigt — das Panel validiert bereits jedes Feld und antwortet mit einer präzisen message + errorCode (z. B. A061), und das lokale Duplizieren würde bedeuten, einen JSON-Schema-Validator plus eine zweite, unweigerlich abweichende Kopie der Regeln auszuliefern. Der Preis ist, dass ein fehlerhafter Body eine Roundtrip-Reise kostet, um es herauszufinden.

  • Die Notausgänge umgehen die Per-Operation-Gates. remnawave_request_write ist von Natur aus roh: Es erfordert weiterhin ein Schreib-Token und durchläuft weiterhin die Drosselung und die Wiederholungslogik, wendet aber nicht das destruktive confirm-Gate oder die Admin-JWT-Prüfung an, weil es keine Operation hat, aus der es diese nachschlagen könnte. Bevorzuge remnawave_call, es sei denn, du brauchst eine Route, die die Spezifikation nicht beschreibt.

  • Tools sind nur so aktuell wie die ausgelieferte Spezifikation (v3.3.2). Ein Panel mit einer anderen Minor-Version kann Routen bereitstellen, die es nicht beschreibt; dafür sind die Notausgänge da. Siehe Aktualisieren der API-Spezifikation.

  • Admin-JWT-Endpunkte sind gated, nicht implementiert. Dieser Server trägt API-Tokens; er führt keinen Admin-Login durch, hält keine Sitzung und erneuert kein JWT. Wenn du ein Admin-JWT als Token bereitstellst und REMNAWAVE_ALLOW_ADMIN_JWT_OPS=1 setzt, werden diese 16 Endpunkte aufrufbar, aber Ablauf und Erneuerung sind dein Problem.

  • Der Prometheus-Basic-Auth-Metrics-Endpunkt ist nicht Teil dieser Spezifikation und wird nicht bereitgestellt.

  • write-check.mjs mutiert. Es ist ein Maintainer-Tool, von npm test ausgeschlossen und weigert sich, ohne ein explizites Bestätigungs-Flag zu laufen.

Lizenz

MIT — siehe LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      Enables MCP clients like Claude Code, Claude Desktop, or Cursor to read and manage Remnawave 3.x VPN panel resources — users, nodes, hosts, config profiles, squads, subscription templates, billing, and HWID devices — through the panel's REST API, with contract-driven tool schemas, numeric user IDs, multi-panel config lookup, and an optional readonly mode.
      204
      13 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables managing and observing Technitium DNS Server through MCP, including read-only or read-write tool surfaces, scoped bearer authentication, audit logging, and confirmation gates for destructive operations.
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Enables managing a Remnawave VPN panel from MCP clients, providing tools for users, nodes, subscriptions, statistics, billing, and system operations, plus resources and prompts for common admin tasks.
      190
      13 npm
      MIT