# Remnawave MCP-сервер

MCP-сервер, который оборачивает Remnawave API в инструменты, понятные AI-ассистенту
(Zed, Claude, Cursor и т.д.). Вместо ручных `curl` агент вызывает
`list_nodes()`, `reset_user_traffic(user_id)`, `extend_user(...)` и т.п.

## Структура

| Файл | Что это |
|------|---------|
| `client.py` | чистый HTTP-клиент к API (без MCP-зависимостей) |
| `server.py` | MCP-сервер (FastMCP → `MCPServer`), обёртки над `client.py` |
| `smoke_test.py` | самопроверка: полный stdio-handshake + вызов инструмента |
| `requirements.txt` | зависимости (`mcp>=2`, `requests`) |

## Установка

```bash
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
```

Токен и адрес панели берутся из env-переменных (не хардкодятся):

```bash
export REMNAWAVE_API_TOKEN="<JWT>"
export REMNAWAVE_API_URL="https://your-panel.example.com/api"   # base URL панели
```

## Проверка

```bash
REMNAWAVE_API_TOKEN=... REMNAWAVE_API_URL=... .venv/bin/python smoke_test.py
```

Должно вывести `Инструментов зарегистрировано: 22` и живой JSON нод.

## Подключение к Zed

В `settings.json` (пользовательский `~/.config/zed/settings.json` или проектный
`.zed/settings.json`) добавь секцию `context_servers`:

```json
{
  "context_servers": {
    "remnawave": {
      "command": {
        "path": "/absolute/path/to/mcp-remnawave/.venv/bin/python",
        "args": ["/absolute/path/to/mcp-remnawave/server.py"],
        "env": {
          "REMNAWAVE_API_TOKEN": "<JWT>",
          "REMNAWAVE_API_URL": "https://your-panel.example.com/api"
        }
      }
    }
  }
}
```

> Пути должны быть **абсолютными**. Схема `context_servers.<имя>.command.{path,args,env}`
> соответствует стандарту MCP; если в твоей версии Zed ключ называется иначе
> (`mcp` вместо `context_servers`) — поправь имя ключа, содержимое то же.

## Инструменты (22)

**Ноды:** `list_nodes`, `get_node(uuid)`, `restart_node(uuid)`, `enable_node(uuid)`, `disable_node(uuid)`

**Пользователи:** `list_users(offset,limit)`, `get_user_by_username(username)`,
`get_user_by_short_uuid(short_uuid)`, `get_user_accessible_nodes(user_id)`,
`create_user(...)`, `update_user(...)`,
`enable_user(user_id)`, `disable_user(user_id)`, `reset_user_traffic(user_id)`,
`revoke_user(user_id)`, `extend_user(user_id, days)`

**Сквады:** `list_squads()`

**Профили:** `list_config_profiles()`, `get_computed_config(uuid)`

**Хосты:** `list_hosts()`, `create_host(...)`

**Генерация ключа ноды:** `keygen()`

## Расширение

Добавить новый инструмент — два шага:

1. В `client.py` — функция, которая дёргает нужный эндпоинт через `_request(...)`.
2. В `server.py` — обёртка с `@mcp.tool()` и понятным docstring (это описание,
   которое видит модель).

## Безопасность

- Токен живёт только в env (или в `env`-блоке конфига Zed), в код не зашит.
- `REMNAWAVE_API_URL` задаётся через env; значение по умолчанию не задано.