Servidor MCP de CloudNet

Este es un servidor del Protocolo de Contexto de Modelos (MCP) que proporciona una interfaz para la API REST v3 de CloudNet Service. Esto permite a los asistentes de IA observar sus nodos y servicios de CloudNet de forma segura y precisa.

Características

• Obtener nodos e información: Enumera todos los nodos del clúster y obtiene estadísticas detalladas.

• Gestionar servicios: Enumera los servicios inteligentes activos y ejecuta comandos en las consolas de los servidores sin problemas.

• Gestión de jugadores: Recupera jugadores en línea, inspecciona perfiles de jugadores, expulsa jugadores, envía mensajes y ejecuta comandos en su nombre.

• Modo Bot de QQ: Optimizado para bots de gestión de servidores de grupos de QQ con ejecución segura de comandos.

Related MCP server: Coolify MCP Server

Requisitos previos

• Python 3.12+

• Gestor de paquetes uv

Instalación

git clone https://github.com/yourusername/cloudnet-mcp.git
cd cloudnet-mcp
uv sync

Configuración

Variables de entorno

• CLOUDNET_URL: La URL de la API REST (predeterminado: http://127.0.0.1:2812/api/v3)

• CLOUDNET_USER: Nombre de usuario para autenticación básica

• CLOUDNET_PASSWORD: Contraseña para autenticación básica

Modo Bot de QQ (Opcional)

Copie la configuración de ejemplo y personalícela:

cp config.example.yaml config.yaml

Habilite el modo QQ en config.yaml:

qq_mode:
  enabled: true
  safe_commands_only: true
  chinese_responses: true

Ejecución

# Basic usage
uv run cloudnet-mcp

# With config file
uv run cloudnet-mcp -c config.yaml

Opciones de línea de comandos

Modo Bot de QQ

Cuando el modo QQ está habilitado, hay herramientas adicionales disponibles:

Ejecución segura de comandos

Los comandos están organizados por nivel de permiso:

• Invitado (Guest): Comandos de consulta (list, tps, seed, etc.)

• Administrador (Admin): Comandos de gestión (kick, ban, whitelist, gamemode, etc.)

• Superusuario (Super User): Comandos de servidor (stop, restart, reload, etc.)

Herencia de permisos: Administrador hereda de Invitado, Superusuario hereda de todos.

Comandos personalizados

Añada comandos personalizados en config.yaml:

safe_commands:
  guest:
    - command: stats
      args: "<player>"
      description: "View player statistics"
  admin:
    - command: money
      args: "set <player> <amount>"
      description: "Set player balance"

Los comandos personalizados se fusionan con los comandos integrados. Puede sobrescribir las descripciones integradas utilizando el mismo nombre de comando.

Comandos bloqueados

Estos patrones siempre están bloqueados:

• op - Conceder estado de operador

• deop - Revocar estado de operador

• execute - Ejecutar como otra entidad

Uso con Claude Desktop

Añada esto a su claude_desktop_config.json:

{
  "mcpServers": {
    "cloudnet": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH/TO/YOUR/cloudnet-mcp",
        "run",
        "cloudnet-mcp",
        "-c",
        "PATH/TO/YOUR/cloudnet-mcp/config.yaml"
      ],
      "env": {
        "CLOUDNET_URL": "http://127.0.0.1:2812/api/v3",
        "CLOUDNET_USER": "your_user",
        "CLOUDNET_PASSWORD": "your_password"
      }
    }
  }
}

Servidor MCP de CloudNet

Este es un servidor del Protocolo de Contexto de Modelos (MCP) que proporciona una interfaz para la API REST v3 de CloudNet Service. Permite a los asistentes de IA observar sus nodos y servicios de CloudNet de forma segura y precisa.

Características

• Obtener nodos e información: Ver estadísticas e información detallada de todos los nodos en el clúster de CloudNet.

• Gestionar servicios: Obtener una lista de servicios inteligentes en ejecución y ejecutar comandos de forma remota en la consola del servidor.

• Gestión de jugadores: Consultar jugadores en línea, ver detalles de jugadores, expulsar jugadores, enviar mensajes y ejecutar comandos en nombre de los jugadores.

• Modo Bot de QQ: Modo optimizado para bots de gestión de servidores en grupos de QQ, compatible con la ejecución segura de comandos.

Requisitos previos

• Python 3.12 o superior

• Gestor de paquetes uv

Guía de instalación

git clone https://github.com/yourusername/cloudnet-mcp.git
cd cloudnet-mcp
uv sync

Configuración

Variables de entorno

• CLOUDNET_URL: Dirección de la API REST de CloudNet (predeterminado: http://127.0.0.1:2812/api/v3)

• CLOUDNET_USER: Nombre de usuario para autenticación básica

• CLOUDNET_PASSWORD: Contraseña para autenticación básica

Modo Bot de QQ (Opcional)

Copie el archivo de configuración de ejemplo y modifíquelo:

cp config.example.yaml config.yaml

Habilite el modo QQ en config.yaml:

qq_mode:
  enabled: true
  safe_commands_only: true
  chinese_responses: true

Ejecución

# 基本用法
uv run cloudnet-mcp

# 使用配置文件
uv run cloudnet-mcp -c config.yaml

Parámetros de línea de comandos

Modo Bot de QQ

Tras habilitar el modo QQ, se proporcionarán las siguientes herramientas adicionales:

Ejecución segura de comandos

Los comandos están organizados por nivel de permiso:

• Guest (Invitado): Comandos de consulta (list, tps, seed, etc.)

• Admin (Administrador): Comandos de gestión (kick, ban, whitelist, gamemode, etc.)

• Super User (Superusuario): Comandos de gestión del servidor (stop, restart, reload, etc.)

Herencia de permisos: El administrador hereda los permisos de invitado, el superusuario hereda todos los permisos.

Lista de comandos integrados

Nivel Guest (11):

• list - Ver lista de jugadores en línea

• tps - Ver TPS del servidor

• seed - Ver semilla del mundo

• difficulty - Ver dificultad del juego

• whitelist list - Ver lista blanca

• time query - Consultar hora del juego

• gamerule query - Consultar reglas del juego

• scoreboard objectives list - Listar objetivos del marcador

• scoreboard players list - Listar jugadores del marcador

• bossbar list - Listar barras de jefe

• trigger - Activar objetivo del marcador

Nivel Admin (41):

• kick <jugador> [razón] - Expulsar jugador

• ban <jugador> [razón] - Banear jugador

• pardon <jugador> - Desbanear jugador

• ban-ip <dirección|jugador> [razón] - Banear IP

• pardon-ip <dirección> - Desbanear IP

• whitelist add/remove <jugador> - Gestión de lista blanca

• whitelist on/off/reload - Activar/desactivar/recargar lista blanca

• gamemode <modo> [jugador] - Establecer modo de juego

• tp <entidad|coordenadas> - Teletransportar entidad

• give <jugador> <objeto> [cantidad] - Dar objeto

• clear [jugador] [objeto] [cantidad] - Limpiar objetos

• effect <jugador> give|clear - Dar/limpiar efectos

• enchant <jugador> <encantamiento> [nivel] - Encantar objeto

• summon <entidad> [coordenadas] - Invocar entidad

• kill [entidad] - Matar entidad

• fill/setblock/clone - Operaciones de bloques

• weather clear|rain|thunder - Establecer clima

• time set <hora> - Establecer hora del juego

• Más...

Nivel Super User (16):

• stop - Detener servidor

• restart - Reiniciar servidor

• reload - Recargar paquetes de datos

• save-all/save-off/save-on - Control de guardado

• debug start|stop - Análisis de rendimiento de depuración

• gamerule set <regla> <valor> - Establecer reglas del juego

• defaultgamemode <modo> - Establecer modo de juego predeterminado

• Más...

Comandos personalizados

Añada comandos personalizados en config.yaml:

safe_commands:
  guest:
    - command: stats
      args: "<玩家>"
      description: "查看玩家统计"
    - command: ping
      description: "查看延迟"
  admin:
    - command: money
      args: "set <玩家> <金额>"
      description: "设置玩家余额"
    - command: heal
      args: "[玩家]"
      description: "治疗玩家"
  super_user:
    - command: plugins
      description: "查看插件列表"

Los comandos personalizados se fusionarán con los integrados. Puede usar el mismo nombre de comando para sobrescribir la descripción de los comandos integrados.

Comandos bloqueados

Las siguientes plantillas de comandos siempre están bloqueadas:

• op - Conceder permisos de administrador

• deop - Revocar permisos de administrador

• execute - Ejecutar como otra entidad

Uso con Claude Desktop

Añada la siguiente configuración a su claude_desktop_config.json:

{
  "mcpServers": {
    "cloudnet": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH/TO/YOUR/cloudnet-mcp",
        "run",
        "cloudnet-mcp",
        "-c",
        "PATH/TO/YOUR/cloudnet-mcp/config.yaml"
      ],
      "env": {
        "CLOUDNET_URL": "http://127.0.0.1:2812/api/v3",
        "CLOUDNET_USER": "您的用户名",
        "CLOUDNET_PASSWORD": "您的密码"
      }
    }
  }
}