🚀 EasyPanel MCP Server¶

Transforma Prompts en Infraestructura¶

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:

🚀 Creando proyecto 'api-flask-prod'
📦 Desplegando servicio 'postgres-db' con imagen postgres:15
🔗 Creando red interna 'api-net' para comunicación segura
⚙️ Configurando servicio 'flask-api' con variables de entorno
✅ ¡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
📊 Monitoring	`get_system_stats`, `get_service_stats`, `health_check`, `get_server_ip`	Métricas en tiempo real (CPU, RAM, disco)
⚡ Scaling	`scale_service`, `auto_scale_service`	Escalado vertical y automático con thresholds
🔒 Security	`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¶

🚀 Getting Started¶

🛠️ Tools Reference¶

Overview - 30 herramientas en 7 categorías
Services Tools - 10 herramientas (create, deploy, logs)
Deployments Tools - 4 herramientas
Networks Tools - 3 herramientas (auto-discovery)
Projects Tools - 4 herramientas
Monitoring Tools - 4 herramientas (stats, health)
Scaling Tools - 2 herramientas (auto-scale)
Security Tools - 3 herramientas (domains, Git)

💡 Examples¶

🚀 Advanced Features¶

Security & Networks - Auth, redes aisladas
Deployment Guide - Docker, GitHub, Git
Debugging - Logs, diagnóstico
Auto-Scaling - Vertical, automático

❓ Support¶

🎯 Casos de Uso¶

Agentes de Desarrollo¶

Usuario: "Despliega mi API Flask con PostgreSQL"
IA: 🚀 Deploy completado en 45 segundos

Auto-Scaling Inteligente¶

IA: "Detecto incremento del 300% en tráfico"
IA: 🔄 Escalando servicio 'worker' de 2 a 6 réplicas

Debugging Asistido¶

Usuario: "¿Por qué falla el servicio worker?"
IA: 🔍 Error: ConnectionRefusedError - Redis no está corriendo

Prototipado Rápido¶

Usuario: "Necesito un entorno de staging"
IA: 🎨 Entorno creado: 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 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 features.

📜 Licencia¶

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

🚀 Construido con ❤️ por Danny Maaz
Transformando prompts en infraestructura, una línea a la vez.