CloudNet MCP サーバー

これは、CloudNet Service REST API v3 へのインターフェースを提供する Model Context Protocol (MCP) サーバーです。これにより、AI アシスタントは CloudNet ノードやサービスを安全かつ正確に監視できます。

機能

• ノードと情報の取得: クラスター内の全ノードを一覧表示し、詳細な統計情報を取得します。

• サービスの管理: アクティブなスマートサービスを一覧表示し、サーバーコンソールでコマンドをシームレスに実行します。

• プレイヤー管理: オンラインプレイヤーの取得、プレイヤープロファイルの確認、プレイヤーのキック、メッセージの送信、およびプレイヤーに代わってのコマンド実行を行います。

• QQ Bot モード: 安全なコマンド実行機能を備えた、QQ グループサーバー管理ボット向けに最適化されています。

Related MCP server: Coolify MCP Server

前提条件

• Python 3.12+

• uv パッケージマネージャー

インストール

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

設定

環境変数

• CLOUDNET_URL: REST API の URL (デフォルト: http://127.0.0.1:2812/api/v3)

• CLOUDNET_USER: 基本認証のユーザー名

• CLOUDNET_PASSWORD: 基本認証のパスワード

QQ Bot モード (オプション)

設定例をコピーしてカスタマイズします：

cp config.example.yaml config.yaml

config.yaml で QQ モードを有効にします：

qq_mode:
  enabled: true
  safe_commands_only: true
  chinese_responses: true

実行

# Basic usage
uv run cloudnet-mcp

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

コマンドラインオプション

QQ Bot モード

QQ モードが有効な場合、追加のツールが利用可能になります：

安全なコマンド実行

コマンドは権限レベルごとに整理されています：

• Guest: クエリコマンド (list, tps, seed など)

• Admin: 管理コマンド (kick, ban, whitelist, gamemode など)

• Super User: サーバーコマンド (stop, restart, reload など)

権限の継承: Admin は Guest を継承し、Super User はすべてを継承します。

カスタムコマンド

config.yaml にカスタムコマンドを追加します：

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

カスタムコマンドは組み込みコマンドとマージされます。同じコマンド名を使用することで、組み込みコマンドの説明を上書きできます。

ブロックされたコマンド

以下のパターンは常にブロックされます：

• op - オペレーター権限の付与

• deop - オペレーター権限の取り消し

• execute - 他のエンティティとして実行

Claude Desktop での使用

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

CloudNet MCP サーバー

これは、CloudNet Service REST API v3 へのインターフェースを提供する Model Context Protocol (MCP) サーバーです。AI アシスタントが CloudNet ノードやサービスを安全かつ正確に監視できるようにします。

機能特性

• ノードリストと情報の取得: CloudNet クラスター内の全ノードの詳細な統計データと情報を確認します。

• サービスの管理: 実行中のスマートサービスリストを取得し、サーバーコンソールでリモートコマンドを実行します。

• プレイヤー管理: オンラインプレイヤーの照会、プレイヤー詳細の確認、プレイヤーのキック、メッセージ送信、プレイヤーに代わってのコマンド実行を行います。

• QQ Bot モード: QQ グループサーバー管理ボット向けに最適化されたモードで、安全なコマンド実行をサポートします。

前提条件

• Python 3.12 以上

• uv パッケージマネージャー

インストールガイド

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

設定

環境変数

• CLOUDNET_URL: CloudNet REST API アドレス (デフォルト: http://127.0.0.1:2812/api/v3)

• CLOUDNET_USER: 基本認証のユーザー名

• CLOUDNET_PASSWORD: 基本認証のパスワード

QQ Bot モード (オプション)

設定ファイルのサンプルをコピーして修正します：

cp config.example.yaml config.yaml

config.yaml で QQ モードを有効にします：

qq_mode:
  enabled: true
  safe_commands_only: true
  chinese_responses: true

実行

# 基本用法
uv run cloudnet-mcp

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

コマンドライン引数

QQ Bot モード

QQ モードを有効にすると、以下の追加ツールが提供されます：

安全なコマンド実行

コマンドは権限レベルごとに構成されています：

• Guest (ゲスト): クエリ系コマンド (list, tps, seed など)

• Admin (管理者): 管理系コマンド (kick, ban, whitelist, gamemode など)

• Super User (スーパーユーザー): サーバー管理コマンド (stop, restart, reload など)

権限の継承: 管理者はゲスト権限を継承し、スーパーユーザーはすべての権限を継承します。

内蔵コマンドリスト

Guest レベル (11個):

• list - オンラインプレイヤーリストを表示

• tps - サーバーの TPS を表示

• seed - ワールドシードを表示

• difficulty - ゲーム難易度を表示

• whitelist list - ホワイトリストを表示

• time query - ゲーム時間を照会

• gamerule query - ゲームルールを照会

• scoreboard objectives list - スコアボード目標をリストアップ

• scoreboard players list - スコアボードプレイヤーをリストアップ

• bossbar list - Boss バーをリストアップ

• trigger - スコアボード目標をトリガー

Admin レベル (41個):

• kick <プレイヤー> [理由] - プレイヤーをキック

• ban <プレイヤー> [理由] - プレイヤーを BAN

• pardon <プレイヤー> - BAN を解除

• ban-ip <アドレス|プレイヤー> [理由] - IP を BAN

• pardon-ip <アドレス> - IP BAN を解除

• whitelist add/remove <プレイヤー> - ホワイトリスト管理

• whitelist on/off/reload - ホワイトリストのオン/オフ/リロード

• gamemode <モード> [プレイヤー] - ゲームモードを設定

• tp <エンティティ|座標> - エンティティをテレポート

• give <プレイヤー> <アイテム> [数量] - アイテムを付与

• clear [プレイヤー] [アイテム] [数量] - アイテムを消去

• effect <プレイヤー> give|clear - 効果を付与/消去

• enchant <プレイヤー> <エンチャント> [レベル] - アイテムをエンチャント

• summon <エンティティ> [座標] - エンティティを召喚

• kill [エンティティ] - エンティティをキル

• fill/setblock/clone - ブロック操作

• weather clear|rain|thunder - 天候を設定

• time set <時間> - ゲーム時間を設定

• その他...

Super User レベル (16個):

• stop - サーバーを停止

• restart - サーバーを再起動

• reload - データパックをリロード

• save-all/save-off/save-on - 保存制御

• debug start|stop - パフォーマンス分析のデバッグ

• gamerule set <ルール> <値> - ゲームルールを設定

• defaultgamemode <モード> - デフォルトゲームモードを設定

• その他...

カスタムコマンド

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

カスタムコマンドは内蔵コマンドとマージされます。同じコマンド名を使用すると、内蔵コマンドの説明を上書きできます。

ブロックされたコマンド

以下のコマンドテンプレートは常にブロックされます：

• op - 管理者権限を付与

• deop - 管理者権限を取り消し

• execute - 他のエンティティとして実行

Claude Desktop での使用

以下の設定を 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": "您的密码"
      }
    }
  }
}