Marzban MCP — MCP-сервер для Claude Code: управление панелью
MCP-сервер, через который ИИ-агент видит операции панели Marzban и выполняет их по вашей просьбе в чате.
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Что делает Marzban MCP
Этот сервер ставит между агентом и панелью Marzban прослойку на TypeScript SDK marzban-sdk. Авторизация, повторы запросов и типизированные ошибки живут в самом SDK, поэтому сервер и ваш собственный код на этой библиотеке ведут себя одинаково. Один и тот же клиент — у MCP-сервера и у консольной утилиты из того же репозитория.
Ставится пакетом marzban-mcp через npx. Перед запуском задайте три переменные: MARZBAN_BASE_URL, MARZBAN_USERNAME, MARZBAN_PASSWORD. Без них сервер к панели не подключится, так что логин и пароль от панели нужны до первого запроса. Есть и образ ilmar7786/marzban-mcp, если удобнее в Docker.
Сервер открывает операции панели как инструменты для агента, и дальше всё зависит от того, насколько аккуратно вы формулируете задачу. Учётные данные от панели лежат в конфиге MCP — это повод проверить, кому доступен файл.
Какие задачи решает
- посмотреть состояние панели Marzban из чата с агентом
- завести пользователя в панели, не открывая веб-интерфейс
- выгрузить список учётных записей и их лимиты
- поправить настройки существующего пользователя по описанию
- сверить, что агент видит ту же панель, что и ваш код на SDK
Примеры запросов агенту
- Покажи список пользователей в панели Marzban и их статус
- Создай пользователя в Marzban с лимитом трафика по моему описанию
- Найди в панели пользователя, у которого истёк срок, и покажи его настройки
Как установить Marzban MCP
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"marzban-mcp": {
"command": "npx",
"args": [
"-y",
"marzban-mcp"
],
"env": {
"MARZBAN_BASE_URL": "<MARZBAN_BASE_URL>",
"MARZBAN_USERNAME": "<MARZBAN_USERNAME>",
"MARZBAN_PASSWORD": "<MARZBAN_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Marzban MCP
Как установить Marzban MCP в Claude Code?
Добавьте сервер одной командой: `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`. Подставьте адрес панели и учётные данные вместо плейсхолдеров.
Что делает Marzban MCP?
Даёт агенту набор инструментов для операций панели Marzban: чтение и изменение данных учётных записей идут через marzban-sdk, тот же клиент, что и в вашем коде.
Что нужно подготовить до запуска?
Адрес панели, логин и пароль администратора. Они передаются серверу через переменные окружения MARZBAN_BASE_URL, MARZBAN_USERNAME и MARZBAN_PASSWORD — без них подключения не будет.
