helbertparanhos/easypanel-mcp-server

helbertparanhos/easypanel-mcp-server

от helbertparanhos
MCP-сервер, который даёт Claude полный контроль над Easypanel: деплой из GitHub, управление переменными окружения, логи, домены, базы данных и контейнеры — 57 инструментов плюс raw-доступ ко всем п...

easypanel-mcp-server

MCP Server for full Easypanel control via Claude Code, Cursor and Claude Desktop.

npm version License: MIT GitHub Stars GitHub Forks GitHub Issues Glama Quality

TypeScript Node.js MCP Claude Code Cursor Claude Desktop

Instagram YouTube LinkedIn Buy Me A Coffee Strat Academy


What is this

easypanel-mcp-server connects Claude Code, Cursor and Claude Desktop directly to your Easypanel instance — a modern Docker-based server control panel — through the Model Context Protocol.

Instead of switching between your editor and the Easypanel dashboard, you control everything from inside Claude: deploy from GitHub, update env vars, read live logs, exec into containers, manage domains, databases, volumes and ports, set resource limits, run Docker maintenance and monitor your server — all in natural language.

It maps the Easypanel API to 57 typed tools across 15 categories, plus a single trpc_raw escape hatch that reaches any of Easypanel's ~350 procedures (40+ namespaces) for everything not covered by a dedicated tool. It speaks both API generations — the tRPC API of panels ≤ 2.30 and the new RPC layer introduced in Easypanel 2.31 — auto-detecting which one your panel uses. Every destructive action is gated behind an explicit confirmation, every response opens with a context banner so Claude always knows what it is touching, and an optional read-only mode lets you connect safely to a production panel.

Инструменты были проиндексированы:
add_domain

Добавляет кастомный домен в сервис с автоматическим HTTPS через Let's Encrypt.

Параметры
  • hoststringобязательный

    Hostname do domínio (ex: app.meusite.com)

  • httpsboolean

    Ativar HTTPS com Let's Encrypt (default: true)

  • pathstring

    Caminho base (default: /)

  • portnumberобязательный

    Porta interna do serviço (ex: 3000, 8080)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

cleanup_docker_images

Удаляет с сервера только неиспользуемые образы Docker (dangling/без контейнера), освобождая место, не затрагивая контейнеры, сети или тома. Операция более легкая и безопасная, чем prune_docker: образы можно пересоздать при новом деплое. Глобальная область действия сервера.

Параметры

Без параметров.

create_compose

Создайте сервис типа Docker Compose в проекте. Затем используйте set_compose_file (через easypanel_raw) или панель, чтобы задать docker-compose, и deploy_compose для развёртывания.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço compose

create_database

Создает сервис базы данных (Postgres, MySQL, MariaDB, MongoDB или Redis) в проекте.

Параметры
  • passwordstring

    Senha do banco (gerada automaticamente se não informada)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome para o serviço de banco (ex: postgres, db-prod)

  • typeenumобязательный

    Tipo do banco de dados

create_mount

Добавляет том/монтирование к сервису для сохранения данных между развёртываниями. Используйте type 'volume' для именованного управляемого тома, 'bind' для сопоставления пути хоста. Применяется при следующем развёртывании.

Параметры
  • confirmstring

    Obrigatório apenas para bind mounts de caminhos sensíveis do host (/, /etc, docker.sock, etc). Deve ser "CONFIRMO".

  • hostPathstring

    Caminho no host (apenas para type=bind)

  • mountPathstringобязательный

    Caminho dentro do container, ex: /app/data

  • namestring

    Nome do volume (apenas para type=volume)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

  • typeenumобязательный

    'volume' (nomeado, gerenciado pelo Docker) ou 'bind' (caminho do host)

create_port

Публикует порт сервиса на хосте (порт-маппинг), открывая его напрямую наружу в обход прокси/домена. Полезно для сырых TCP/UDP (базы данных, игры и т.п.). Применяется при следующем деплое. ⚠️ Привилегированные порты (publishedPort < 1024, например 80/443/22) требуют подтверждения: "CONFIRMO".

Параметры
  • confirmstring

    Obrigatório apenas para publishedPort < 1024. Deve ser "CONFIRMO".

  • projectNamestringобязательный

    Nome do projeto

  • protocolenum

    Protocolo (default: tcp)

  • publishedPortnumberобязательный

    Porta externa (no host)

  • serviceNamestringобязательный

    Nome do serviço

  • targetPortnumberобязательный

    Porta interna (no container)

create_project

Создаёт новый проект в Easypanel.

Параметры
  • projectNamestringобязательный

    Nome do projeto — apenas letras minúsculas, números, hífens e underscores

create_service

Создает новый сервис приложения в проекте. После создания настройте source с помощью set_source_github или set_source_image.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço — apenas letras minúsculas, números, hífens e underscores

delete_env_var

⚠️ Удаляет переменную окружения. Читает текущее состояние перед записью. Требует подтверждения: "CONFIRMO".

Параметры
  • confirmstringобязательный

    Confirmação obrigatória. Deve ser exatamente "CONFIRMO"

  • keystringобязательный

    Nome da variável a remover

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

delete_project

⚠️ РАЗРУШИТЕЛЬНО - Навсегда удаляет проект и ВСЕ его сервисы и данные. Необратимо. Требует подтверждения: "CONFIRMO".

Параметры
  • confirmstringобязательный

    Confirmação obrigatória. Deve ser exatamente a string "CONFIRMO"

  • projectNamestringобязательный

    Nome exato do projeto a deletar

deploy_compose

Запускает развертывание (docker compose up) сервиса Compose с текущей конфигурацией.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço compose

deploy_service

Запускает деплой сервиса с текущей конфигурацией. Использует настроенный источник (GitHub, image, dockerfile). Работает для сервисов app и compose — определяет тип и направляет в нужный namespace (не нужно заранее знать, compose это или нет).

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

destroy_database

⚠️ УНИЧТОЖИТЕЛЬНО — Удаляет базу данных и ВСЕ её данные навсегда. Необратимо. Требуется подтверждение: "CONFIRMO".

Параметры
  • confirmstringобязательный

    Confirmação obrigatória. Deve ser exatamente "CONFIRMO"

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço de banco

  • typeenumобязательный

    Tipo do banco de dados

destroy_service

⚠️ ДЕСТРУКТИВНО — Навсегда удаляет сервис и его данные. Необратимо. Требуется подтверждение: "CONFIRMO".

Параметры
  • confirmstringобязательный

    Confirmação obrigatória. Deve ser exatamente "CONFIRMO"

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço a destruir

disable_github_deploy

Отключает авто-деплой через GitHub. Деплои нужно будет запускать вручную.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

easypanel_raw

Вызывает напрямую любую операцию API Easypanel (~375), не охваченную выделенными инструментами. Используйте для продвинутых функций: Traefik, брендинг, Cloudflare Tunnel, Box, WordPress, резервное копирование томов/БД, уведомления, провайдеры хранилищ и т.д. Чтение (isMutation=false) используется по умолчанию. ⚠️ Чтения могут возвращать чувствительные данные (переменные окружения/секреты любого проекта). Для записи передайте isMutation:true И confirm:"CONFIRMO" — произвольные записи обходят защиту выверенных инструментов. Чтобы узнать доступные имена, прочитайте GET <панель>/api/openapi.json.

Параметры
  • confirmstring

    Obrigatório quando isMutation=true. Deve ser exatamente "CONFIRMO".

  • inputobject

    Objeto de parâmetros da procedure (opcional). Ex: { projectName: "meu-app" }.

  • isMutationboolean

    true para operações de escrita, false para leitura (padrão). Escritas exigem confirm. O client valida contra o OpenAPI do painel e recusa escrita chamada como leitura (e vice-versa).

  • procedurestringобязательный

    Nome da operação. Em painéis 2.33+ use o nome achatado da API pública, ex: "listCertificates", "getDashboard", "listVolumeBackups". A notação antiga com namespace ("certificates.listCertificates") também é aceita e traduzida.

enable_github_deploy

Активирует авто-деплой через GitHub: при каждом пуше в настроенную ветку автоматически запускается деплой.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

exec_in_container

Выполняет команду внутри контейнера сервиса и возвращает вывод (stdout/stderr). Используйте для отладки в рантайме: просмотр файлов, проверка переменных, тестирование связности, запуск миграций и т.д. Выполняется в первом контейнере сервиса (или в указанном containerId). ⚠️ Выполняет произвольные команды — потенциально деструктивные команды (rm -rf, dd, mkfs, shutdown, kill, pipe в shell и т.д.) требуют подтверждения: "CONFIRMO".

Параметры
  • commandstringобязательный

    Comando shell a executar, ex: 'ls -la /app', 'cat package.json', 'env', 'node -v'

  • confirmstring

    Obrigatório apenas para comandos destrutivos. Deve ser exatamente "CONFIRMO".

  • containerIdstring

    ID do container específico (opcional — default: primeiro container do serviço)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

get_action

Возвращает детали и логи конкретного действия (deploy, build и т.д.).

Параметры
  • actionIdstringобязательный

    ID da ação (obtido via list_actions)

get_build_logs

Возвращает логи сборки/развёртывания последнего зарегистрированного action для сервиса. Используйте для отладки ошибок сборки.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

get_docker_events

Захватывает события Docker с сервера в реальном времени в течение короткого окна (~8 с): start, stop, kill, die, exec, health_status и т.д. Используйте для расследования перезапусков и сбоев. Примечание: показывает только события, происходящие во время захвата (истории нет); сервер в простое может вернуть пустой результат.

Параметры
  • limitnumber

    Número máximo de eventos a coletar (default: 30, max: 100)

get_docker_stats

Возвращает состояние задач Docker для каждого сервиса: работающие реплики (actual) по сравнению с желаемыми (desired). Используйте для быстрой проверки, какие сервисы работают, масштабированы или упали. Для CPU/памяти сервиса используйте get_service_stats.

Параметры

Без параметров.

get_env_vars

Перечисляет переменные окружения сервиса. Значения чувствительных переменных (KEY, SECRET, PASSWORD, TOKEN) по умолчанию маскируются. Используйте include_values: true, чтобы увидеть полные значения.

Параметры
  • include_valuesboolean

    Se true, exibe valores completos incluindo segredos (use com cautela)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

get_exposed_ports

Перечисляет опубликованные на хосте порты сервиса. Используйте, чтобы узнать, на каких портах сервис доступен извне.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

get_project

Возвращает полные детали проекта: список сервисов, конфигурации и текущий статус.

Параметры
  • projectNamestringобязательный

    Nome exato do projeto

get_service_error

Возвращает последнюю зарегистрированную ошибку сервиса. Используйте для отладки сбоев при развертывании или во время выполнения.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

get_service_logs

Ищет логи контейнера сервиса. Используйте для отладки ошибок во время выполнения. Возвращает последние N строк.

Параметры
  • linesnumber

    Número de linhas a retornar (default: 100, max: 500)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

get_service_notes

Читает заметки/аннотации, сохраненные в сервисе.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

get_service_stats

Возвращает метрики конкретного сервиса: CPU, память и сеть контейнера.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

get_storage_stats

Возвращает использование хранилища сервера.

Параметры

Без параметров.

get_system_stats

Возвращает метрики сервера: CPU, память, диск, сеть и uptime. Используйте для проверки здоровья сервера.

Параметры

Без параметров.

inspect_compose

Возвращает конфигурацию сервиса Docker Compose: compose-файл, env, source и состояние. Используйте перед любыми изменениями.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço compose

inspect_database

Возвращает детали базы данных: учётные данные, открытый порт, строку подключения и статус.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço de banco

  • typeenumобязательный

    Tipo do banco de dados

inspect_service

Возвращает полную конфигурацию сервиса: source, env vars, deploy config, mounts, ports, domínios, recursos. Используйте ВСЕГДА перед любым обновлением, чтобы сохранить состояние.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

list_actions

Список выполняемых или недавних действий/jobs (deploys, builds, restarts). Глобальный список хранит только короткое окно — передайте projectName/serviceName, чтобы отфильтровать на сервере и не потерять действия конкретного сервиса.

Параметры
  • limitnumber

    Número máximo de ações a retornar (default: 50)

  • projectNamestring

    Filtrar por projeto (opcional)

  • serviceNamestring

    Filtrar por serviço (opcional)

  • typestring

    Filtrar por tipo de ação, ex: deployment (opcional)

list_certificates

Перечисляет сертификаты SSL/TLS, управляемые Easypanel (покрываемые домены, издатель, срок действия). Используйте для аудита HTTPS и продлений.

Параметры

Без параметров.

list_containers

Перечисляет работающие контейнеры Docker сервиса (ID, имя, образ, команда, статус, порты). Используйте, чтобы найти контейнер перед exec_in_container или проверить, работает ли сервис.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

list_domains

Перечисляет все домены, настроенные в сервисе.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

list_mounts

Выводит список томов и точек монтирования сервиса: именованные тома, bind-монтирования и смонтированные файлы. Используйте, чтобы посмотреть, где хранятся постоянные данные сервиса.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

list_nodes

Выводит список узлов кластера Docker Swarm, управляемого Easypanel (manager/worker, статус, доступность). На единственном сервере возвращает только локальный узел.

Параметры

Без параметров.

list_ports

Перечисляет сопоставления портов службы (опубликованный порт на хосте → порт контейнера). Дополняет get_exposed_ports полной конфигурацией портов. Используйте, чтобы увидеть, что открыто и по какому протоколу.

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

list_projects

Перечисли все проекты Easypanel с их сервисами и статусами. Используй, чтобы узнать, что есть в панели, прежде чем выполнять операции.

Параметры

Без параметров.

list_users

Список пользователей панели Easypanel (администратор, email-адреса, роли).

Параметры

Без параметров.

prune_docker

Выполняет "docker system prune" на всём сервере через Easypanel: удаляет остановленные контейнеры, неиспользуемые сети, кеш сборки и не ссылающиеся образы, чтобы освободить место на диске. ⚠️ Разрушительное действие ГЛОБАЛЬНОГО масштаба (затрагивает все проекты сервера, а не конкретный сервис) — требует подтверждения: "CONFIRMO". Используйте cleanup_docker_images для более щадящей очистки (только неиспользуемые образы).

Параметры
  • confirmstring

    Obrigatório. Deve ser exatamente "CONFIRMO" para confirmar a limpeza global.

reboot_server

⚠️ КРИТИЧНО - Перезагружает весь СЕРВЕР (хост-машину). ВСЕ сервисы и панель будут недоступны до завершения boot. Используйте только при плановом обслуживании. Требует подтверждения: "ПОДТВЕРЖДАЮ".

Параметры
  • confirmstring

    Obrigatório. Deve ser exatamente "CONFIRMO".

remove_domain

⚠️ Удаляет домен навсегда. Трафик на этот хост перестанет работать. Требуется подтверждение: «CONFIRMO».

Параметры
  • confirmstringобязательный

    Confirmação obrigatória. Deve ser exatamente "CONFIRMO"

  • domainIdstringобязательный

    ID do domínio a remover (obtido via list_domains)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

rename_service

⚠️ Переименовывает или перемещает сервис. Webhooks, DNS и внутренние ссылки, использующие старое имя, перестанут работать. Требуется подтверждение: "CONFIRMO".

Параметры
  • confirmstringобязательный

    Confirmação obrigatória. Deve ser exatamente "CONFIRMO"

  • newProjectNamestringобязательный

    Novo projeto (pode ser o mesmo)

  • newServiceNamestringобязательный

    Novo nome do serviço

  • projectNamestringобязательный

    Projeto atual do serviço

  • serviceNamestringобязательный

    Nome atual do serviço

restart_panel

⚠️ Перезапускает сам Easypanel. Панель управления/API ненадолго становятся недоступными; размещённые сервисы продолжают работать. Требуется подтверждение: "CONFIRMO".

Параметры
  • confirmstring

    Obrigatório. Deve ser exatamente "CONFIRMO".

restart_service

Перезапускает сервис. Вызывает кратковременную недоступность. Работает для приложения и compose — в compose перезапускается через redeploy (docker compose up пересоздаёт контейнеры).

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

set_env_var

Добавляет или обновляет ОДНУ переменную окружения. Перед записью читает текущее состояние — не удаляет другие переменные.

Параметры
  • keystringобязательный

    Nome da variável (ex: DATABASE_URL)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

  • valuestringобязательный

    Valor da variável

set_primary_domain

Определяет, какой домен является основным (используется как основной URL сервиса).

Параметры
  • domainIdstringобязательный

    ID do domínio a tornar primário (obtido via list_domains)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

set_service_notes

Сохраняет заметки/аннотации в сервисе (поддерживается markdown).

Параметры
  • notesstringобязательный

    Conteúdo das notas (markdown)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

set_service_resources

Задаёт лимиты и резервы CPU и памяти для сервиса. Отправляйте только поля, которые хотите изменить: пропущенные сохраняют текущее значение (0 = без лимита). Память в МБ, CPU в ядрах (0.5 = половина ядра). Применяется при следующем деплое/перезапуске.

Параметры
  • cpuLimitnumber

    Limite de CPU (1 = 1 núcleo)

  • cpuReservationnumber

    Reserva de CPU (1 = 1 núcleo)

  • memoryLimitnumber

    Limite de memória em MB (hard cap)

  • memoryReservationnumber

    Reserva de memória em MB (soft)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

set_source_github

Настраивает источник сервиса на репозиторий GitHub. Репозиторий должен быть подключён в Easypanel (Settings > GitHub).

Параметры
  • ownerstringобязательный

    Dono do repositório (usuário ou org no GitHub)

  • pathstring

    Caminho dentro do repo onde está o app (use '/' para raiz)

  • projectNamestringобязательный

    Nome do projeto

  • refstringобязательный

    Branch ou tag (ex: main, master, v1.0.0)

  • repostringобязательный

    Nome do repositório

  • serviceNamestringобязательный

    Nome do serviço

set_source_image

Настраивает источник сервиса для Docker-образа.

Параметры
  • imagestringобязательный

    Imagem Docker (ex: nginx:latest, ghcr.io/user/app:tag)

  • passwordstring

    Senha do registry (para imagens privadas)

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

  • usernamestring

    Usuário do registry (para imagens privadas)

start_service

Запускает остановленный сервис. Работает для app и compose (в compose эквивалентно redeploy/compose up).

Параметры
  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

stop_service

⚠️ ОСТАНОВКА службы в продакшене. Пользователи не смогут получить доступ, пока она остановлена. Требуется подтверждение: "CONFIRMO".

Параметры
  • confirmstringобязательный

    Confirmação obrigatória. Deve ser exatamente "CONFIRMO"

  • projectNamestringобязательный

    Nome do projeto

  • serviceNamestringобязательный

    Nome do serviço

Похожие MCP-сервера

ofershap/mcp-server-docker

ofershap/mcp-server-docker

MCP-сервер для управления Docker из AI-ассистента: просмотр контейнеров, логов, запуск/остановка, выполнение команд и мониторинг ресурсов. Подключается к локальному Docker без API-ключей. Полезен р...

TypeScript2
asif-nvc/e2b-sandbox-mcp

asif-nvc/e2b-sandbox-mcp

MCP-сервер, подключающий Claude Code к облачным Linux-сандбоксам E2B для работы с GitHub-репозиториями (клон, команды, файлы, git) безопасно, не затрагивая локальную машину.

TypeScript3
tumf/mcp-shell-server

tumf/mcp-shell-server

MCP сервер для безопасного удалённого выполнения команд оболочки с белым списком, изоляцией окружения и аудитом. Поддерживает stdin, пайпы и лимиты времени/вывода. Идеален для интеграции shell-команд в MCP с контролем безопасности.

Python191
ferrislucas/iterm-mcp

ferrislucas/iterm-mcp

Разработчики: MCP сервер для iTerm дает модели полный контроль над терминалом - выполнение команд, чтение вывода, управление REPL. Эффективный расход токенов, простая интеграция. Делегируйте задачи и наблюдайте за работой.

TypeScript567
quantgeekdev/docker-mcp

quantgeekdev/docker-mcp

MCP сервер для управления Docker через Claude AI. Создавай контейнеры, разворачивай Compose-стэки и смотри логи — всё без командной строки. Идеально для DevOps, автоматизации развертывания и мониторинга. Минимум кликов, максимум контроля над инфраструктурой.

Python501
DigitalOcean MCP

DigitalOcean MCP

MCP сервер для управления облачными ресурсами DigitalOcean через API: дроплеты, базы данных и Kubernetes. Инструмент для автоматизации инфраструктуры разработчиками и DevOps.

Go133
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин