remnawave-mcp
remnawave-mcp
Remnawave 패널 API를 위한 MCP 서버입니다.
@folexz스코프로 게시되었습니다. npm의 스코프 없는remnawave-mcp이름은 Remnawave 2.7.4를 대상으로 하는 무관한 프로젝트에 속하며, 2.8.0+에서는 작동하지 않습니다.
npx -y @folexz/remnawave-mcp # configured via REMNAWAVE_BASE_URL + REMNAWAVE_API_TOKEN_READ/_WRITERemnawave API v3.3.2의 28개 컨트롤러에 걸친 전체 205개 작업을 다룹니다 — 사용자, 노드, 호스트, 구성 프로필, 스쿼드, 구독, 노드 플러그인, 인프라 과금, 시스템 통계 — 패널 자체의 OpenAPI 문서에서 수작업 없이 생성되었습니다. 더 새로운 스펙을 npm run build-spec에 지정하면 도구 표면도 그에 따라 갱신됩니다.
주요 특징
스펙 기반, 자체 갱신.
npm run update-spec은 Remnawave가 공개한 최신 OpenAPI 문서를 가져와 카탈로그를 재구축합니다. 모든 도구의 입력 스키마는 작업의 매개변수와 요청 본문에서 직접 가져옵니다. API에 대해 수작업으로 작성된 부분은 없으며, 재구축 시 추가·제거·이름 변경된 모든 작업을 명명하는 diff를 출력하므로 버전 업그레이드로 도구가 조용히 사라질 수 없습니다.제한된 컨텍스트 비용. 205개의 타입화된 도구는 매 요청마다
tools/list에 약 39k 토큰이 소모됩니다. 기본 프로필은 5개 도구(약 1.4k 토큰)만 노출하면서도 모든 작업에 도달할 수 있습니다 — 205개 도구가 아닌 이유 참조.두 토큰 최소 권한 인증. 읽기 토큰과 선택적 쓰기 토큰.
GET은 읽기 토큰을 사용하고,POST/PATCH/PUT/DELETE는 쓰기 토큰을 사용합니다. 쓰기 토큰이 없으면 변경 도구는 아예 등록되지 않습니다 — 서버는 물리적으로 읽기 전용입니다.실제 패널을 위한 안전장치. 모든 구성 쓰기는 패널이 모든 노드에 구성을 푸시하고 Xray를 재시작하게 하므로, 변경 작업은 최소 간격으로 직렬화되고 백오프로 재시도됩니다. 대량 및 삭제 작업은 추가로
confirm: true가 필요합니다.내장된 필드 노트. 아래의 주의사항은 해당 작업에 첨부되어 도구 설명과
remnawave_describe_operation출력에 표시됩니다.성공할 수 없는 요청 없음. 16개 엔드포인트(인증, 패스키, API 토큰 관리)는 로그인한 관리자 JWT에만 제공되며 API 토큰을 거부합니다. 이들은 스펙에서 감지되어 전송 대신 설명과 함께 로컬에서 거부됩니다.
탈출구.
remnawave_request_read/remnawave_request_write는 문서화되지 않은 경로와 OpenAPI가 표현할 수 없는 쿼리 구문을 포함한 모든 경로에 도달할 수 있습니다.
Related MCP server: mcp-remnawave
요구 사항
Node.js ≥ 18
HTTPS로 접근 가능한 Remnawave 패널(3.x)
패널의 API 토큰: 설정 → API 토큰. Remnawave 3.x는 범위가 지정된 토큰을 지원합니다 — 읽기 범위의 토큰 하나와, 변경 작업이 필요하다면 쓰기 범위의 두 번째 토큰을 발급하세요.
설치
빠른 방법은 npx입니다 — Claude Code에 등록 참조. 소스에서 실행하려면:
git clone https://github.com/folexz/remnawave-mcp.git
cd remnawave-mcp
npm install
npm run build구성
모든 구성은 MCP 호스트가 제공하는 환경 변수입니다. 파일은 읽지 않습니다.
변수 | 필수 | 기본값 | 설명 |
| 예 | — | 패널 원본 주소, 예: |
| 예 | — | 읽기 토큰. 별칭: |
| 아니요 | — | 쓰기 토큰. 생략하면 읽기 전용으로 실행됩니다. |
| 아니요 |
|
|
| 아니요 | — | 쉼표로 구분된 컨트롤러 슬러그; 프로필의 타입화된 도구 선택을 재정의합니다. |
| 아니요 |
| 이보다 큰 입력 스키마는 |
| 아니요 |
| 두 변경 작업 사이의 최소 간격. |
| 아니요 |
| 전송 실패, 429 및 5xx에 대한 재시도 횟수. |
| 아니요 |
| 요청당 타임아웃. |
| 아니요 |
|
|
| 아니요 |
|
|
Claude Code에 등록
읽기 전용(권장 기본값):
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변경 작업 활성화 및 일상적인 컨트롤러용 타입화된 도구 포함:
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는 npx가 실행할 때마다 최신 게시 버전을 해석하게 합니다. 로컬 빌드를 실행하려면 명령을 node /absolute/path/to/remnawave-mcp/dist/index.js로 바꾸세요.
Claude Desktop / 기타 MCP 클라이언트에 등록
{
"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"
}
}
}
}205개 도구가 아닌 이유
tools/list는 매 요청마다 모델에 다시 전송되므로 직렬화된 크기가 영구적인 컨텍스트 비용입니다. 이 스펙에서 측정됨(npx tsx scripts/tool-stats.ts):
프로필 | 도구 수(읽기+쓰기) |
| ≈ 토큰 | 도구 수(읽기 전용) | ≈ 토큰 |
| 5 | 5.6 KB | ~1.4k | 4 | ~1.2k |
| 91 | 71 KB | ~17.8k | 38 | ~5.9k |
| 210 | 156 KB | ~39k | 92 | ~13.9k |
Remnawave의 DTO가 full이 그렇게 비싼 이유입니다. 역참조된 호스트 객체 하나는 모든 인바운드 및 보안 변형을 포함하므로 그 자체로 약 30KB의 JSON Schema입니다.
따라서 서버는 "작업당 도구 하나"와 "단일 무딘 디스패처" 중 하나를 선택하지 않고, 둘 다 제공하며 프로필이 얼마나 광고할지 결정하게 합니다:
카탈로그 도구(항상 켜짐, 3개 도구).
remnawave_list_operations는 카탈로그를 탐색·검색하고 작업당 한 줄의 간결한 결과를 반환합니다.remnawave_describe_operation은 한 작업에 대한 완전한 JSON Schema와 필드 노트를 반환합니다.remnawave_call은 205개 중 이름으로 어떤 작업이든 실행합니다. 일반적인 루프는 목록 → 설명 → 호출이며, API가 아무리 커져도 동일한 1.4k 토큰 비용이 듭니다. 이는 에이전트 하네스가 도구 스키마를 지연 로딩할 때 사용하는 것과 같은 지연 로딩 아이디어입니다.타입화된 도구(프로필 선택). 실제로 작업하는 컨트롤러에 대해 작업당 하나의 생성된 도구 —
core는 사용자, 노드, 호스트, 구성 프로필, 내부 스쿼드, 시스템 및 두 개의 대량 작업 컨트롤러를 다룹니다.full은 모든 것을 다룹니다.minimal은 없습니다.REMNAWAVE_MAX_SCHEMA_BYTES를 초과하는 스키마는 최상위 필드를 유지하고 중첩을 제거하며, 전체 버전은remnawave_describe_operation을 가리킵니다.탈출구(2개 도구). 스펙이 놓친 모든 것에 대한 원시 GET 및 원시 쓰기.
모든 경로는 동일한 실행기를 거치므로 쓰기 게이트, 파괴적 확인 게이트, 경로 템플릿 및 쿼리 처리는 어떤 표면을 사용하든 동일하게 동작합니다.
취향에 따라 프로필을 선택하세요: 연결된 MCP 서버가 많으면 minimal, 일상적인 작업을 한 번의 호출로 원하면 core, 컨텍스트가 문제되지 않으면 full.
필드 노트 — 스펙이 문서화하지 않은 동작
이 모든 것은 실제 3.3.2 패널에서 확인되었으며 도구 설명의 해당 작업에 첨부되어 있습니다.
PATCH /api/config-profiles는 패치가 아니라 교체입니다. 본문은{uuid, config}이며config는 완전하고 유효한 Xray 구성이어야 합니다. 일부만 보내면A061: Config doesn't have inbounds오류가 발생합니다. 올바른 순서:GET /api/config-profiles/{uuid}→ 반환된config객체를 제자리에서 편집 → 전체를PATCH로 다시 전송.패널은
127.0.0.1:3000에서 응답하지 않습니다. 패널 호스트 자체에서도,docker-proxy가 그곳에서 수신 중이어도 마찬가지입니다(curl은 종료 코드 52, 빈 응답 반환). 항상 Bearer 토큰과 함께 공개 HTTPS 원본을 사용하세요.모든 응답은
{"response": ...}로 감싸져 있습니다. 이 서버는 이를 풀어서 도구 출력이 페이로드 자체가 되게 합니다.호스트는 중첩된
inbound.configProfileUuid(및inbound.configProfileInboundUuid)를 통해 프로필에 바인딩됩니다. 최상위configProfileUuid가 아닙니다. 실제 호스트에서 확인됨: 중첩은 존재, 최상위는 없음.연속된
PATCH실행은 패널을 다운시킵니다. 각 구성 쓰기는 모든 노드에 푸시하고 그곳의 Xray를 재시작합니다. 여러 번 연속하면 패널 자체의 TLS 리스너가 응답을 멈춥니다. 클라이언트는 변경 작업을 직렬화하고(REMNAWAVE_WRITE_MIN_INTERVAL_MS, 기본 1500ms) 전송 실패를 지수 백오프와 지터로 재시도합니다. 병렬로 대량 업데이트를 발사하여 이를 무력화하지 마세요.POST /api/subscription-templates는 빈 템플릿만 생성합니다. 콘텐츠는 별도의PATCH /api/subscription-templates로 업로드됩니다. JSON과 YAML 본문은 같은 호출에서 업데이트할 수 없습니다.호스트의
serverDescription은 30자로 제한됩니다(스펙의maxLength로 확인됨). 또한 Hysteria2 호스트가 원시 JSON 대신 Happ에서 제대로 렌더링되게 하는 값이기도 합니다.16개 엔드포인트는 관리자 JWT 전용입니다 —
auth및passkeys컨트롤러 전체와 API 토큰 관리(GET/POST /api/tokens,DELETE /api/tokens/{uuid},GET /api/tokens/scopes). 패널은 그곳에서 API 토큰에 401/403으로 응답합니다. 이 서버는 스펙에서 이를 감지하여 로컬에서 거부합니다.REMNAWAVE_ALLOW_ADMIN_JWT_OPS=1은 구성한 토큰이 실제로 관리자 JWT인 경우 게이트를 해제합니다.GET /api/users/stream은 단일 문서가 아닌 줄바꿈 구분 JSON으로 응답합니다. 텍스트 덩어리로 반환하는 대신 사용자 레코드 배열로 파싱됩니다.PATCH /api/hosts는 실제 부분 패치입니다 —{uuid, serverDescription}만으로도 작동합니다. 전체 교체 의미론을 가진 것은 구성 프로필뿐입니다. 실제로 확인됨.오류는
{message, errorCode}로 반환되며,errorCode(예:A061)는 이 서버의 오류 텍스트에 포함됩니다.
도구 범위
모든 컨트롤러는 remnawave_call과 탈출구를 통해 접근할 수 있습니다. 타입화된 열은 REMNAWAVE_TOOL_PROFILE=core에서 개별 도구를 받는 컨트롤러를 보여줍니다.
컨트롤러 슬러그 | 작업 수 |
|
| 17 | 예 |
| 18 | — |
| 15 | 예 |
| 12 | — |
| 12 | 예 |
| 12 | 예 |
| 10 | 예 |
| 9 | 예 |
| 8 | — |
| 7 | — |
| 7 | — |
| 7 | — |
| 7 | 예 |
| 7 | — |
| 7 | — |
| 7 | — |
| 6 | — |
| 5 | — |
| 5 | — |
| 5 | — |
| 4 | — |
| 4 | 예 |
| 4 | — |
| 3 | — |
| 2 | — |
| 2 | — |
| 2 | — |
| 1 | — |
합계 | 205 |
실시간 서버에서 remnawave_list_operations를 실행하면 정확하고 최신의 목록을 얻을 수 있습니다.
예시
타입이 지정된 도구 없이 탐색하고 호출하기:
// 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, query는 JSON 텍스트로도 도착할 수 있습니다 — "params": "{\"uuid\":\"…\"}" —
일부 MCP 클라이언트가 타입이 지정되지 않은 도구 인수를 파싱하지 않고 그대로 전달하기 때문입니다.
문자열은 자동으로 파싱됩니다. JSON이 아닌 문자열은 그렇다고 알려주는 메시지와 함께 거부됩니다.
구성 프로필을 안전하게 편집하기(A061 함정):
// 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 */ } } } } }스펙으로는 표현할 수 없는 쿼리 구문:
{ "tool": "remnawave_request_read",
"arguments": { "path": "/api/users",
"query": { "size": 25, "start": 0,
"filters[0][id]": "status", "filters[0][value]": "ACTIVE" } } }테스트
npm run build
npm test # 50 unit tests + the offline smoke suite
npm run test:unit # unit tests alone단위 테스트는 조용히 실패하는 부분을 다룹니다: Remnawave의 재귀적 DTO를 통한 $ref 확장,
도구 이름 도출(길이 예산, 결정성, 충돌 감지), 카탈로그 diff, 두 가지 쓰기 게이트,
admin-JWT 게이트, 스키마 축소 및 NDJSON 파싱.
실제 패널에 대한 읽기 전용 검사
패널에 접근 가능하고 읽기 토큰이 환경에 있는 경우, 스모크 스크립트는 실시간 읽기 전용 호출도 실행합니다(변경 작업은 절대 하지 않음):
REMNAWAVE_BASE_URL=https://panel.example.com \
REMNAWAVE_API_TOKEN_READ="$REMNAWAVE_API_TOKEN" \
npm run smoke토큰이 이미 있는 곳(예: 패널 호스트)에서 실행하면 비밀이 외부로 유출되지 않습니다. 스크립트는 형태(타입, 키 이름, 배열 길이)만 출력하고 페이로드 값은 절대 출력하지 않으므로, 그 출력은 이슈에 붙여 넣어도 안전합니다.
가드레일 검사는 의도적으로 http://127.0.0.1:9를 가리키므로, 게이트가 실패하여 열려도
실제 패널에 도달할 수 없습니다.
쓰기 경로 검증
읽기만으로는 토큰 라우팅, 스로틀, 확인 게이트, 부분 패치 의미론이 실제로 작동하는지 증명할 수
없습니다. scripts/write-check.mjs는 아무도 연결하지 않은 객체에 대해 이를 증명하고, 건드린
기존 객체 하나를 원래대로 되돌려 놓습니다:
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>]인바운드와 멤버가 없는 내부 스쿼드를 생성했다가 다시 삭제하고, 한 호스트의
serverDescription을 다시 쓴 다음 원래 값으로 복원합니다. 확인 플래그 없이는 시작을 거부하며,
무언가 남아 있으면 0이 아닌 종료 코드를 보고합니다.
실제 3.3.2 패널에서 다음을 확인했습니다: 확인 게이트가 실제 DELETE에서 유지됨; 부분
PATCH /api/hosts가 작동함; 패널이 31자 serverDescription을 거부함; 원래 값(null 포함)이
왕복됨; 연속 변경이 구성된 1500ms 하한에 대해 1525ms와 1524ms 간격으로 실행됨.
로컬에서 검사하기
REMNAWAVE_BASE_URL=https://panel.example.com REMNAWAVE_API_TOKEN_READ=xxx npm run inspectAPI 스펙 업데이트
API에 관한 모든 것은 하나의 파일에서 비롯되므로, 새 Remnawave 릴리스를 추적하는 것은 단 하나의 명령으로 끝납니다:
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스펙의 출처
https://cdn.remna.st/docs/openapi.json — Remnawave 자체의 Build&Push OpenAPI Specs
워크플로가 모든 업스트림 태그에서 게시하므로 항상 최신 릴리스를 설명합니다. 다른 소스를
고정하려면 --url <u> 또는 REMNAWAVE_SPEC_URL로 재정의하세요.
패널 인스턴스는 사용 가능한 소스가 아닙니다: 배포에서 문서를 활성화하지 않는 한 문서가
비활성화되어 있고, 활성화하더라도 Swagger는 일반적인 리버스 프록시가 라우팅하지 않는
/backend-tools/swagger에 마운트됩니다. 실제 3.3.2 패널을 탐색한 결과 모든 일반적인 스펙
경로에서 404가 반환되었습니다.
다운로드는 비어 있지 않은 paths를 가진 OpenAPI 문서로 파싱된 후에만 디스크에 기록되므로,
오류 페이지나 캡티브 포털이 작동 중인 스펙을 덮어쓸 수 없습니다.
이후 확인할 사항
build-spec은 새 카탈로그를 이전 카탈로그와 비교하고 모든 변경 사항을 출력합니다:
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는 해당 도구를 이름으로 참조하는 프롬프트나 스크립트에 대해 호환성이 깨지는 변경입니다.
--strict는 이를 0이 아닌 종료 코드로 바꾸며, 자동화에서 사용해야 하는 플래그입니다.added는 안전합니다. 새 작업은
remnawave_call을 통해 즉시 접근 가능하며, 해당 컨트롤러가 활성 프로필에 있으면 타입이 지정된 도구를 얻습니다.schema changed는 실제로 사용하는 작업에 대해 한 번 살펴볼 가치가 있습니다.
npm test는 디스크의 카탈로그가 새 빌드와 일치하는지, 모든 도구 이름이 고유하고 64자
예산 안에 있는지, 가드레일이 여전히 유지되는지 다시 확인합니다.
자동화
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푸시된 태그는 릴리스 워크플로를 트리거하고, 이 워크플로는 npm에 다시 게시합니다.
@folexz/remnawave-mcp@latest로 등록된 클라이언트는 다음 시작 시 새 버전을 받습니다.
릴리스(관리자용)
첫 게시 — 반드시 수동
npm은 아직 존재하지 않는 패키지에 대해 신뢰할 수 있는 게시자를 구성할 수 없습니다: 해당 설정은 패키지 자체의 설정 페이지에 있기 때문입니다. 이는 알려져 있고 아직 열려 있는 제한 사항이며(npm/cli#8544), 스코프가 있는 패키지에도 적용됩니다. 따라서 버전 0.1.0은 로그인된 머신에서 올려야 합니다:
npm whoami # must print the account that owns the @folexz scope
npm publish --access public--access public이 필요합니다: 스코프가 있는 패키지는 기본적으로 restricted로 설정되기
때문입니다.
그 다음 토큰 없는 릴리스로 전환
패키지가 존재하면 npmjs.com → @folexz/remnawave-mcp → Settings → Trusted Publisher에서
저장소 folexz/remnawave-mcp와 워크플로 release.yml을 가진 GitHub Actions 게시자를
추가하세요. package.json의 repository.url은 GitHub 저장소와 정확히 일치해야 합니다 —
실제로 일치합니다.
그 후 .github/workflows/release.yml은 푸시된 모든 vX.Y.Z 태그에서 OIDC를 통해
게시합니다 — 토큰도, 비밀도 없이, 출처(provenance)가 자동으로 첨부됩니다:
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워크플로는 lockfile에서 재설치하고, 재빌드하고, 단위 테스트와 오프라인 스모크 스위트를
실행하며, 태그가 package.json과 일치하지 않으면 즉시 실패합니다.
@folexz/remnawave-mcp@latest로 등록된 클라이언트는 다음 시작 시 새 버전을 받습니다.
보안 참고 사항
토큰은 환경에서만 읽히며 절대 로그에 기록되지 않습니다. 로그는 stderr로 이동합니다. stdout은 MCP JSON-RPC 채널입니다.
REMNAWAVE_API_TOKEN_READ만 구성하는 것이 좋습니다. 쓰기 토큰 없이는 변경 도구가 존재하지 않으므로, 손상되었거나 혼란스러운 클라이언트가 패널을 변경할 수 없습니다.구독 엔드포인트는 작동하는 클라이언트 구성을 반환합니다. 해당 출력을 비밀로 취급하세요.
실제 토큰을 커밋하지 마세요.
.env는 gitignore되어 있습니다..env.example은 형태를 보여줍니다.
알려진 제한 사항
본문 검증은 패널에 위임됩니다. 이 서버는 필수 인수와 필수
body가 있는지만 확인합니다. 본문의 내부 형태를 스키마에 대해 검증하지는 않습니다. 이는 의도적인 것입니다 — 패널이 이미 모든 필드를 검증하고 정확한message+errorCode(예:A061)로 응답하며, 이를 로컬에서 중복 구현하려면 JSON Schema 검증기와 필연적으로 어긋나는 두 번째 규칙 사본을 배포해야 하기 때문입니다. 대가로, 잘못된 본문은 알아내는 데 왕복 한 번이 듭니다.탈출구(escape hatch)는 작업별 게이트를 우회합니다.
remnawave_request_write는 설계상 원시(raw)입니다: 여전히 쓰기 토큰이 필요하고 여전히 스로틀과 재시도 로직을 거치지만, 파괴적인confirm게이트나 admin-JWT 검사를 적용하지 않습니다. 조회할 작업이 없기 때문입니다. 스펙이 설명하지 않는 경로가 필요하지 않다면remnawave_call을 선호하세요.도구는 배포된 스펙(v3.3.2)만큼만 최신입니다. 다른 마이너 버전의 패널은 스펙이 설명하지 않는 경로를 노출할 수 있습니다. 이것이 탈출구가 존재하는 이유입니다. API 스펙 업데이트를 참조하세요.
Admin-JWT 엔드포인트는 게이트만 있고 구현되지 않았습니다. 이 서버는 API 토큰을 보유합니다. 관리자 로그인을 수행하거나, 세션을 유지하거나, JWT를 갱신하지 않습니다. 관리자 JWT를 토큰으로 제공하고
REMNAWAVE_ALLOW_ADMIN_JWT_OPS=1을 설정하면 해당 16개 엔드포인트를 호출할 수 있지만, 만료와 갱신은 사용자의 책임입니다.Prometheus basic-auth 메트릭 엔드포인트는 이 스펙의 일부가 아니며 노출되지 않습니다.
write-check.mjs는 변경을 수행합니다. 관리자용 도구이며npm test에서 제외되고, 명시적인 확인 플래그 없이는 실행을 거부합니다.
라이선스
MIT — LICENSE를 참조하세요.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.
EU cloud as MCP tools: VPS, databases, caches, storage, containers and more. Takes an API token.
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Toolstile is a managed MCP gateway that connects remote MCP servers behind one endpoint, with per-agent permissions, shared accounts and activity logs. Connect at https://mcp.toolstile.com/mcp over Streamable HTTP with OAuth; sign in at https://toolstile.com, select a workspace and connect your upstream servers. Available tools, resources and prompts depend on that workspace and the agent's granted access.
Related MCP Servers
- AlicenseCqualityBmaintenanceWraps the Remnawave API to provide per-operation MCP tools with mutation safety and data redaction, enabling secure interaction with Remnawave panel.100MIT
- AlicenseCqualityBmaintenanceEnables 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.204MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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
- AlicenseCqualityCmaintenanceEnables 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.190MIT