EasyPanel MCP Server¶

Infraestructura EasyPanel Orquestada por MCP¶

Python 3.10+ Cross-Platform MCP Protocol

¿Qué es EasyPanel MCP?¶

EasyPanel MCP es un servidor de Model Context Protocol (MCP) que permite a agentes de inteligencia artificial interactuar directamente con tu panel EasyPanel para gestionar infraestructura, desplegar servicios y administrar contenedores Docker mediante comandos naturales.

¿Por Qué Usar EasyPanel MCP?¶

Control Natural por IA¶

Describe lo que necesitas en lenguaje natural y deja que tu agente de IA se encargue de todo el proceso de despliegue.

Deployments en Segundos¶

De idea a producción en minutos. La IA puede crear, configurar y desplegar servicios completos automáticamente.

Redes Aisladas¶

Soporte completo para redes internas Docker. Mantén tus servicios sensibles completamente aislados de internet.

Debugging Inteligente¶

La IA puede analizar logs, diagnosticar problemas y sugerir soluciones en tiempo real.

Auto-Scaling¶

Detecta picos de tráfico y escala servicios automáticamente basado en métricas en tiempo real.

Multi-Plataforma¶

Funciona en Windows, macOS y Linux. Compatible con Claude Desktop, Cursor, Cline, ChatGPT, n8n, y cualquier cliente MCP.

Inicio Rápido¶

1. Instalación¶

# Clonar repositorio
git clone https://github.com/dannymaaz/easypanel-mcp
cd easypanel-mcp

# Crear entorno virtual
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Instalar dependencias
pip install -r requirements.txt

2. Configuración¶

# Copiar archivo de ejemplo
cp .env.example .env

# Editar .env con tus credenciales
# EASYPANEL_URL=https://tu-easypanel.com
# EASYPANEL_API_KEY=tu_api_key

3. Ejecutar¶

# Modo stdio (Claude Desktop, etc.)
python src/server.py

# Modo HTTP (n8n, webhooks)
python src/server.py http

Ejemplo de Uso¶

Caso Real: Despliegue Completo

Usuario: "Despliega mi API Flask con PostgreSQL en producción"

IA:

[Proyecto] Creando proyecto 'api-flask-prod'
[Servicios] Desplegando servicio 'postgres-db' con imagen postgres:15
[Redes] Creando red interna 'api-net' para comunicación segura
[Configuración] Configurando servicio 'flask-api' con variables de entorno
[Completado] ¡Deploy completado! Tu API está disponible en https://api.tudominio.com

Herramientas Disponibles¶

30 herramientas organizadas en 7 categorías para gestión completa de infraestructura con IA:

Categoría	Herramientas	Descripción
Servicios	`list_services`, `get_service`, `create_service`, `update_service`, `delete_service`, `restart_service`, `start_service`, `stop_service`, `deploy_service`, `get_service_logs`	Gestión completa de servicios Docker + logs inteligentes
Deployments	`list_deployments`, `create_deployment`, `get_deployment`, `get_deployment_logs`	Control de deployments y versiones
Redes	`list_networks` (auto-discovery), `create_network`, `delete_network`	Descubrimiento automático de topología
Proyectos	`list_projects`, `create_project`, `delete_project`, `get_project`	Organización de recursos
Monitoreo	`get_system_stats`, `get_service_stats`, `health_check`, `get_server_ip`	Métricas en tiempo real (CPU, RAM, disco)
Escalado	`scale_service`, `auto_scale_service`	Escalado vertical y automático con thresholds
Seguridad	`list_domains`, `create_domain`, `get_public_key`	Dominios y autenticación Git

Integraciones¶

AI Agents (Claude, Cursor, Cline, ChatGPT) Claude Desktop n8n Workflows GitHub Actions

Documentación Completa¶

Casos de Uso¶

Agentes de Desarrollo¶

Usuario: "Despliega mi API Flask con PostgreSQL"
IA: [Proyecto] Proyecto creado.
IA: [Servicios] PostgreSQL y Flask iniciados.
IA: [Completado] Despliegue completado con éxito en 45 segundos.

Auto-Scaling Inteligente¶

IA: "Detectado incremento del 300% en tráfico"
IA: [Escalado] Escalando servicio 'worker' de 2 a 6 réplicas

Debugging Asistido¶

Usuario: "¿Por qué falla el servicio worker?"
IA: [Monitoreo] Analizando logs del contenedor...
IA: [Error] ConnectionRefusedError - Redis no está respondiendo en el puerto 6379.

Prototipado Rápido¶

Usuario: "Necesito un entorno de staging"
IA: [Proyecto] Creando entorno de pruebas.
IA: [Completado] Entorno disponible: https://staging.myapp.com

Seguridad y Redes Aisladas¶

EasyPanel MCP soporta redes internas Docker para aislar servicios sensibles:

# docker-compose.yml
networks:
  internal-net:
    driver: overlay
    internal: true  # Red aislada sin acceso directo a internet

services:
  api:
    networks:
      - internal-net  # Solo accesible internamente
      - public-net    # Para servicios que necesitan internet

  database:
    networks:
      - internal-net  # Base de datos completamente aislada

Autor & Créditos¶

Danny Maaz
Ingeniero en Sistemas | Creador de EasyPanel MCP

LinkedIn • GitHub

Apoya el Proyecto¶

Cada donación ayuda a mantener el proyecto y agregar nuevas características.

Licencia¶

MIT License con cláusula de atribución. Ver LICENSE para detalles.

Desarrollado y mantenido por Danny Maaz
DevOps y orquestación eficiente para desarrolladores.