Integración del Servidor MCP 1Panel

¿Qué hace el Servidor MCP “1Panel”?

El Servidor MCP 1Panel es una implementación del servidor Model Context Protocol (MCP) diseñada específicamente para integrarse con 1Panel. Actúa como un puente entre asistentes de IA y la plataforma 1Panel, permitiendo flujos de desarrollo mejorados al posibilitar que agentes de IA interactúen de forma programática con las APIs y fuentes de datos de 1Panel. Al desplegar este servidor, los desarrolladores pueden utilizar herramientas impulsadas por IA para automatizar y agilizar tareas administrativas y operativas comunes dentro de sus entornos 1Panel, como consultar el estado del sistema, gestionar archivos o ejecutar comandos de control. El servidor soporta múltiples métodos de transporte (stdio y sse), ofreciendo flexibilidad para la integración en distintos entornos y puede configurarse de forma segura mediante tokens API y direcciones de host.

Lista de Prompts

No se mencionan plantillas de prompt en la documentación o el código disponible.

Lista de Recursos

No se describen recursos MCP explícitos en la documentación o el código disponible.

Lista de Herramientas

No se listan ni describen herramientas específicas en la documentación o el código disponible (por ejemplo, server.py no existe en este proyecto hecho en Go).

Casos de uso de este Servidor MCP

• Automatización de 1Panel: Integra asistentes de IA para automatizar tareas administrativas de 1Panel, como reinicios de servicios, gestión de usuarios o verificaciones de estado a través de comandos estandarizados de IA.
• Operaciones Remotas: Permite que scripts o flujos impulsados por IA interactúen con servidores 1Panel de forma remota, mejorando capacidades DevOps y de administración de sistemas.
• Integración IA SSE/Streaming: Habilita interacciones en tiempo real entre 1Panel y agentes de IA usando el modo de transporte SSE, permitiendo monitoreo en vivo y respuestas rápidas.
• Acceso Programático Seguro: Utiliza tokens de acceso y configuración basada en variables de entorno para exponer de forma segura solo las partes necesarias de 1Panel a agentes de IA, manteniendo la seguridad operativa.

Cómo configurarlo

Windsurf

1. Asegúrate de tener el binario o la imagen Docker del Servidor MCP 1Panel.

2. Obtén tu token de acceso de 1Panel y la URL del host.

3. Edita el archivo de configuración de Windsurf.

4. Agrega el siguiente fragmento JSON bajo mcpServers:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<tu token de acceso de 1Panel>",
           "PANEL_HOST": "por ejemplo http://localhost:8080"
         }
       }
     }
   }
   

5. Guarda y reinicia Windsurf, luego verifica la conexión al servidor.

Ejemplo con Docker

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PANEL_HOST",
        "-e",
        "PANEL_ACCESS_TOKEN",
        "1panel/1panel-mcp-server"
      ],
      "env": {
        "PANEL_HOST": "por ejemplo http://localhost:8080",
        "PANEL_ACCESS_TOKEN": "<tu token de acceso de 1Panel>"
      }
    }
  }
}

Claude

1. Descarga o compila el Servidor MCP 1Panel.
2. Obtén tu token API de 1Panel y la información del host.
3. Abre el archivo de configuración de Claude.
4. Inserta la misma configuración que para Windsurf bajo mcpServers.
5. Guarda y reinicia Claude.

Cursor

1. Asegúrate de que el Servidor MCP 1Panel esté instalado.

2. Obtén tu token de acceso y la URL del host.

3. Edita el archivo de configuración de Cursor.

4. Agrega:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<tu token de acceso de 1Panel>",
           "PANEL_HOST": "por ejemplo http://localhost:8080"
         }
       }
     }
   }
   

5. Guarda los cambios y reinicia Cursor.

Ejemplo en modo SSE

Si usas el modo SSE, inicia el servidor con:

mcp-1panel -host http://localhost:8080 -token <tu token de acceso de 1Panel> -transport sse -addr http://localhost:8000

Agrega a mcpServers:

{
  "mcpServers": {
    "mcp-1panel": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Cline

1. Instala el Servidor MCP 1Panel.
2. Establece tus variables PANEL_ACCESS_TOKEN y PANEL_HOST.
3. Edita el archivo de configuración de Cline e inserta el mismo JSON que arriba.
4. Guarda y reinicia Cline.

Protección de claves API

Almacena claves API e información sensible en variables de entorno. Ejemplo de configuración:

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "mcp-1panel",
      "env": {
        "PANEL_ACCESS_TOKEN": "${PANEL_ACCESS_TOKEN}",
        "PANEL_HOST": "${PANEL_HOST}"
      }
    }
  }
}

Reemplaza ${PANEL_ACCESS_TOKEN} y ${PANEL_HOST} con los nombres de tus variables de entorno.

Cómo usar este MCP dentro de flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo de FlowHunt, primero agrega el componente MCP a tu flujo y conéctalo con tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración de sistema MCP, inserta los detalles de tu servidor MCP usando este formato JSON:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://tuservidormcp.ejemplo/rutadelmcp/url"
  }
}

Una vez configurado, el agente de IA podrá utilizar este MCP como herramienta con acceso a todas sus funciones y capacidades. Recuerda cambiar “MCP-name” por “mcp-1panel” y la URL por la de tu propio servidor MCP.

Resumen

Nuestra opinión

El Servidor MCP 1Panel ofrece instrucciones claras de instalación e integración y es mantenido activamente, con buen número de estrellas y forks. Sin embargo, la falta de descripciones detalladas de herramientas, prompts y recursos en la documentación limita su usabilidad directa para flujos de trabajo de IA complejos. Por lo anterior, valoramos esta implementación MCP con un 5/10 en cuanto a completitud y facilidad de uso para desarrolladores.

Puntaje MCP