CloudNet MCP-Server

Dies ist ein Model Context Protocol (MCP) Server, der eine Schnittstelle zur CloudNet Service REST API v3 bereitstellt. Dies ermöglicht es KI-Assistenten, Ihre CloudNet-Knoten und -Dienste sicher und präzise zu beobachten.

Funktionen

• Knoten & Informationen abrufen: Alle Cluster-Knoten auflisten und detaillierte Statistiken abrufen.

• Dienste verwalten: Aktive Smart-Services auflisten und Befehle nahtlos auf Server-Konsolen ausführen.

• Spielerverwaltung: Online-Spieler abrufen, Spielerprofile einsehen, Spieler kicken, Nachrichten senden und Befehle in ihrem Namen ausführen.

• QQ-Bot-Modus: Optimiert für QQ-Gruppen-Serververwaltungs-Bots mit sicherer Befehlsausführung.

Related MCP server: Coolify MCP Server

Voraussetzungen

• Python 3.12+

• uv Paketmanager

Installation

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

Konfiguration

Umgebungsvariablen

• CLOUDNET_URL: Die URL zur REST API (Standard: http://127.0.0.1:2812/api/v3)

• CLOUDNET_USER: Benutzername für die Basisauthentifizierung

• CLOUDNET_PASSWORD: Passwort für die Basisauthentifizierung

QQ-Bot-Modus (Optional)

Kopieren Sie die Beispielkonfiguration und passen Sie diese an:

cp config.example.yaml config.yaml

Aktivieren Sie den QQ-Modus in der config.yaml:

qq_mode:
  enabled: true
  safe_commands_only: true
  chinese_responses: true

Ausführung

# Basic usage
uv run cloudnet-mcp

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

Befehlszeilenoptionen

QQ-Bot-Modus

Wenn der QQ-Modus aktiviert ist, stehen zusätzliche Tools zur Verfügung:

Sichere Befehlsausführung

Befehle sind nach Berechtigungsstufen organisiert:

• Gast: Abfragebefehle (list, tps, seed usw.)

• Admin: Verwaltungsbefehle (kick, ban, whitelist, gamemode usw.)

• Super User: Serverbefehle (stop, restart, reload usw.)

Berechtigungsvererbung: Admin erbt Gast, Super User erbt alles.

Benutzerdefinierte Befehle

Fügen Sie benutzerdefinierte Befehle in der config.yaml hinzu:

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

Benutzerdefinierte Befehle werden mit den integrierten Befehlen zusammengeführt. Überschreiben Sie integrierte Beschreibungen, indem Sie denselben Befehlsnamen verwenden.

Blockierte Befehle

Diese Muster sind immer blockiert:

• op - Operator-Status gewähren

• deop - Operator-Status entziehen

• execute - Als andere Entität ausführen

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "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"
      }
    }
  }
}

CloudNet MCP-Server

Dies ist ein Model Context Protocol (MCP) Server, der eine Schnittstelle zur CloudNet Service REST API v3 bereitstellt. Er ermöglicht es KI-Assistenten, Ihre CloudNet-Knoten und -Dienste sicher und präzise zu beobachten.

Funktionsmerkmale

• Knotenliste und Informationen abrufen: Detaillierte Statistiken und Informationen zu allen Knoten im gesamten CloudNet-Cluster anzeigen.

• Dienste verwalten: Liste der laufenden Smart-Services abrufen, unterstützt die Remote-Ausführung von Befehlen auf der Serverkonsole.

• Spielerverwaltung: Online-Spieler abfragen, Spielerdetails einsehen, Spieler kicken, Nachrichten senden, Befehle stellvertretend für Spieler ausführen.

• QQ-Bot-Modus: Optimierter Modus für QQ-Gruppen-Serververwaltungs-Bots, unterstützt sichere Befehlsausführung.

Voraussetzungen

• Python 3.12 oder höher

• uv Paketmanager

Installationsanleitung

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

Konfiguration

Umgebungsvariablen

• CLOUDNET_URL: CloudNet REST API-Adresse (Standard: http://127.0.0.1:2812/api/v3)

• CLOUDNET_USER: Benutzername für die Basisauthentifizierung

• CLOUDNET_PASSWORD: Passwort für die Basisauthentifizierung

QQ-Bot-Modus (Optional)

Kopieren Sie die Beispielkonfigurationsdatei und ändern Sie diese:

cp config.example.yaml config.yaml

Aktivieren Sie den QQ-Modus in der config.yaml:

qq_mode:
  enabled: true
  safe_commands_only: true
  chinese_responses: true

Ausführung

# 基本用法
uv run cloudnet-mcp

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

Befehlszeilenparameter

QQ-Bot-Modus

Nach Aktivierung des QQ-Modus stehen folgende zusätzliche Tools zur Verfügung:

Sichere Befehlsausführung

Befehle sind nach Berechtigungsstufen organisiert:

• Guest (Gast): Abfragebefehle (list, tps, seed usw.)

• Admin (Administrator): Verwaltungsbefehle (kick, ban, whitelist, gamemode usw.)

• Super User (Superuser): Serververwaltungsbefehle (stop, restart, reload usw.)

Berechtigungsvererbung: Administratoren erben Gastrechte, Superuser erben alle Rechte.

Liste der integrierten Befehle

Guest-Stufe (11):

• list - Online-Spielerliste anzeigen

• tps - Server-TPS anzeigen

• seed - Welt-Seed anzeigen

• difficulty - Spielschwierigkeit anzeigen

• whitelist list - Whitelist anzeigen

• time query - Spielzeit abfragen

• gamerule query - Spielregeln abfragen

• scoreboard objectives list - Scoreboard-Ziele auflisten

• scoreboard players list - Scoreboard-Spieler auflisten

• bossbar list - Boss-Leisten auflisten

• trigger - Scoreboard-Ziel auslösen

Admin-Stufe (41):

• kick <Spieler> [Grund] - Spieler kicken

• ban <Spieler> [Grund] - Spieler bannen

• pardon <Spieler> - Bann aufheben

• ban-ip <Adresse|Spieler> [Grund] - IP bannen

• pardon-ip <Adresse> - IP-Bann aufheben

• whitelist add/remove <Spieler> - Whitelist-Verwaltung

• whitelist on/off/reload - Whitelist ein-/ausschalten/neu laden

• gamemode <Modus> [Spieler] - Spielmodus festlegen

• tp <Entität|Koordinaten> - Entität teleportieren

• give <Spieler> <Gegenstand> [Anzahl] - Gegenstand geben

• clear [Spieler] [Gegenstand] [Anzahl] - Gegenstände löschen

• effect <Spieler> give|clear - Effekte geben/löschen

• enchant <Spieler> <Verzauberung> [Stufe] - Gegenstand verzaubern

• summon <Entität> [Koordinaten] - Entität beschwören

• kill [Entität] - Entität töten

• fill/setblock/clone - Block-Operationen

• weather clear|rain|thunder - Wetter einstellen

• time set <Zeit> - Spielzeit einstellen

• Mehr...

Super User-Stufe (16):

• stop - Server stoppen

• restart - Server neu starten

• reload - Datenpakete neu laden

• save-all/save-off/save-on - Speichersteuerung

• debug start|stop - Performance-Analyse debuggen

• gamerule set <Regel> <Wert> - Spielregel festlegen

• defaultgamemode <Modus> - Standard-Spielmodus festlegen

• Mehr...

Benutzerdefinierte Befehle

Fügen Sie benutzerdefinierte Befehle in der config.yaml hinzu:

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: "查看插件列表"

Benutzerdefinierte Befehle werden mit den integrierten Befehlen zusammengeführt. Verwenden Sie denselben Befehlsnamen, um die Beschreibung eines integrierten Befehls zu überschreiben.

Blockierte Befehle

Die folgenden Befehlsmuster sind immer blockiert:

• op - Administratorrechte gewähren

• deop - Administratorrechte entziehen

• execute - Als andere Entität ausführen

Verwendung mit Claude Desktop

Fügen Sie die folgende Konfiguration zu Ihrer claude_desktop_config.json hinzu:

{
  "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": "您的密码"
      }
    }
  }
}