1Panel MCP Server

by ruibaby
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows for automated website deployment to 1Panel servers, including creating websites if they don't exist, uploading static website files, and providing deployment statistics.

  • Provides video demonstration capabilities, with a specific demo video hosted on Bilibili showcasing the 1Panel deployment functionality.

Servidor MCP de 1 panel

Un servidor de Protocolo de Contexto de Modelo (MCP) para la implementación automatizada de sitios web en 1Panel.

[!IMPORTANTE] Actualmente este proyecto es un proyecto experimental y no significa que pueda utilizarse directamente.

Demostración en vídeo

https://www.bilibili.com/video/BV1SjQRY3EmM/

Características

  • Automatiza la implementación de sitios web en servidores 1Panel
  • Crea sitios web si aún no existen
  • Sube archivos de sitios web estáticos a 1Panel
  • Totalmente compatible con el protocolo estándar MCP

Instalación

# Clone the repository git clone https://github.com/yourusername/1panel-mcp-server.git cd 1panel-mcp-server # Install dependencies npm install # Or if you use pnpm pnpm install # Configure environment variables cp .env.example .env

Edite el archivo .env con la información de su servidor 1Panel:

PORT=3000 ONEPANEL_BASE_URL=http://your-1panel-ip:port/api/v1 ONEPANEL_API_KEY=your_api_key ONEPANEL_LANGUAGE=zh # Language options: zh (Chinese) or en (English)

Uso

Iniciar el servidor

# Start the server npm start # For development with auto-reload npm run dev

Configurar MCP en Cursor IDE

Para utilizar este servidor con Cursor IDE, agregue la siguiente configuración de MCP:

  1. Cursor abierto
  2. Crear .cursor/mcp.json
{ "mcpServers": { "Deploy to 1Panel": { "url": "http://localhost:3000/sse" } } }

Utilice MCP para implementar sitios web

En Cursor, puedes implementar sitios web usando el siguiente comando en el chat de IA:

Deploy to 1Panel with domain=yourdomain.com

O puede utilizar el siguiente formato:

Deploy website to 1Panel server, domain: yourdomain.com

Referencia de API

Herramienta MCP: implementar_sitio web

Implementa un sitio web en 1Panel.

Parámetros:

  • domain (obligatorio): Dominio del sitio web
  • buildDir (opcional): ruta del directorio de compilación

Respuesta:

Successfully deployed to 1Panel! Domain: yourdomain.com URL: http://yourdomain.com Upload statistics: - Total files: 25 - Successfully uploaded: 25 - Failed to upload: 0

Detalles de implementación

Proceso de implementación

  1. Verificar directorio de compilación : verifica si existe el directorio de compilación especificado
  2. Creación de sitio web : crea un nuevo sitio web estático a través de la API de 1Panel si no existe
  3. Carga de archivos : carga todos los archivos del directorio de compilación al sitio web
  4. Estadísticas : Devuelve estadísticas detalladas sobre el proceso de carga.

Solución de problemas

Si encuentra problemas de implementación, verifique lo siguiente:

  1. Asegúrese de que su clave API sea válida y tenga permisos suficientes
  2. Verifique que el directorio del sitio web exista y tenga permisos de escritura
  3. Consulte los registros del servidor 1Panel para obtener información de error más detallada
  4. Si la carga de archivos falla, puede deberse a problemas de permisos o formato del archivo.
-
security - not tested
F
license - not found
-
quality - not tested

Un servidor experimental que implementa el Protocolo de Contexto de Modelo para automatizar las implementaciones de sitios web en servidores 1Panel, lo que permite a los usuarios crear sitios web y cargar archivos estáticos a través de comandos de lenguaje natural.

  1. Video demo
    1. Features
      1. Installation
        1. Usage
          1. Start the server
          2. Configure MCP in Cursor IDE
          3. Use MCP to Deploy Websites
        2. API Reference
          1. MCP Tool: deploy_website
        3. Implementation Details
          1. Deployment Process
        4. Troubleshooting
          ID: oll043mmpu