# Marzban MCP

MCP-сервер, через который ИИ-агент видит операции панели Marzban и выполняет их по вашей просьбе в чате.

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

## Что делает

Этот сервер ставит между агентом и панелью Marzban прослойку на TypeScript SDK `marzban-sdk`. Авторизация, повторы запросов и типизированные ошибки живут в самом SDK, поэтому сервер и ваш собственный код на этой библиотеке ведут себя одинаково. Один и тот же клиент — у MCP-сервера и у консольной утилиты из того же репозитория.

Ставится пакетом `marzban-mcp` через `npx`. Перед запуском задайте три переменные: `MARZBAN_BASE_URL`, `MARZBAN_USERNAME`, `MARZBAN_PASSWORD`. Без них сервер к панели не подключится, так что логин и пароль от панели нужны до первого запроса. Есть и образ `ilmar7786/marzban-mcp`, если удобнее в Docker.

Сервер открывает операции панели как инструменты для агента, и дальше всё зависит от того, насколько аккуратно вы формулируете задачу. Учётные данные от панели лежат в конфиге MCP — это повод проверить, кому доступен файл.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `MARZBAN_BASE_URL`, `MARZBAN_USERNAME`, `MARZBAN_PASSWORD` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add marzban-mcp -e MARZBAN_BASE_URL=<MARZBAN_BASE_URL> -e MARZBAN_USERNAME=<MARZBAN_USERNAME> -e MARZBAN_PASSWORD=<MARZBAN_PASSWORD> -- npx -y marzban-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add marzban-mcp --env MARZBAN_BASE_URL=<MARZBAN_BASE_URL> --env MARZBAN_USERNAME=<MARZBAN_USERNAME> --env MARZBAN_PASSWORD=<MARZBAN_PASSWORD> -- npx -y marzban-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "marzban-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "marzban-mcp"
            ],
            "env": {
                "MARZBAN_BASE_URL": "<MARZBAN_BASE_URL>",
                "MARZBAN_USERNAME": "<MARZBAN_USERNAME>",
                "MARZBAN_PASSWORD": "<MARZBAN_PASSWORD>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "marzban-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "marzban-mcp"
            ],
            "env": {
                "MARZBAN_BASE_URL": "<MARZBAN_BASE_URL>",
                "MARZBAN_USERNAME": "<MARZBAN_USERNAME>",
                "MARZBAN_PASSWORD": "<MARZBAN_PASSWORD>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MARZBAN_BASE_URL=<MARZBAN_BASE_URL> -e MARZBAN_USERNAME=<MARZBAN_USERNAME> -e MARZBAN_PASSWORD=<MARZBAN_PASSWORD> marzban-mcp npx -y marzban-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- посмотреть состояние панели Marzban из чата с агентом
- завести пользователя в панели, не открывая веб-интерфейс
- выгрузить список учётных записей и их лимиты
- поправить настройки существующего пользователя по описанию
- сверить, что агент видит ту же панель, что и ваш код на SDK

## Примеры запросов агенту
- Покажи список пользователей в панели Marzban и их статус
- Создай пользователя в Marzban с лимитом трафика по моему описанию
- Найди в панели пользователя, у которого истёк срок, и покажи его настройки

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17160
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

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