CloudNet MCP Server

Это сервер протокола контекста модели (MCP), который предоставляет интерфейс к REST API v3 CloudNet Service. Это позволяет ИИ-ассистентам безопасно и точно отслеживать ваши узлы и сервисы CloudNet.

Функции

• Получение узлов и информации: Список всех узлов кластера и получение подробной статистики.

• Управление сервисами: Список активных интеллектуальных сервисов и возможность беспрепятственного выполнения команд в консолях серверов.

• Управление игроками: Получение списка онлайн-игроков, просмотр профилей, исключение игроков, отправка сообщений и выполнение команд от их имени.

• Режим QQ-бота: Оптимизировано для ботов управления серверами в группах 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: URL-адрес REST API (по умолчанию: http://127.0.0.1:2812/api/v3)

• CLOUDNET_USER: Имя пользователя для базовой аутентификации

• CLOUDNET_PASSWORD: Пароль для базовой аутентификации

Режим QQ-бота (опционально)

Скопируйте пример конфигурации и настройте его:

cp config.example.yaml config.yaml

Включите режим QQ в config.yaml:

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-бота

Когда включен режим QQ, становятся доступны дополнительные инструменты:

Безопасное выполнение команд

Команды организованы по уровням доступа:

• Гость (Guest): Команды запроса (list, tps, seed и т.д.)

• Администратор (Admin): Команды управления (kick, ban, whitelist, gamemode и т.д.)

• Суперпользователь (Super User): Команды сервера (stop, restart, reload и т.д.)

Наследование прав: Администратор наследует права гостя, суперпользователь наследует все права.

Пользовательские команды

Добавьте пользовательские команды в 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 Server

Это сервер протокола контекста модели (MCP), который предоставляет интерфейс к REST API v3 CloudNet Service. Это позволяет ИИ-ассистентам безопасно и точно отслеживать ваши узлы и сервисы CloudNet.

Функции

• Получение списка узлов и информации: Просмотр подробной статистики и информации обо всех узлах в кластере CloudNet.

• Управление сервисами: Получение списка запущенных интеллектуальных сервисов, поддержка удаленного выполнения команд в консоли сервера.

• Управление игроками: Поиск онлайн-игроков, просмотр деталей игрока, исключение игроков, отправка сообщений, выполнение команд от имени игрока.

• Режим QQ-бота: Оптимизированный режим для ботов управления серверами в группах 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-бота (опционально)

Скопируйте пример файла конфигурации и измените его:

cp config.example.yaml config.yaml

Включите режим QQ в config.yaml:

qq_mode:
  enabled: true
  safe_commands_only: true
  chinese_responses: true

Запуск

# 基本用法
uv run cloudnet-mcp

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

Параметры командной строки

Режим QQ-бота

После включения режима 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 - Список полос боссов

• trigger - Триггер цели таблицы очков

Уровень Admin (41 команда):

• kick <игрок> [причина] - Исключить игрока

• ban <игрок> [причина] - Забанить игрока

• pardon <игрок> - Разбанить игрока

• ban-ip <адрес|игрок> [причина] - Забанить IP

• pardon-ip <адрес> - Разбанить IP

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