CloudNet MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，提供了对 CloudNet Service REST API v3 的接口访问。它使得 AI 助手能够安全准确地观测您的 CloudNet 节点和服务。

🌟 功能特性

• 获取节点及信息: 列出所有集群节点并获取详细统计数据。

• 管理服务: 列出活跃的智能服务，并可在服务器控制台上无缝执行命令 (execute_service_command)。

• 玩家管理: 获取在线玩家 (get_online_players)，查看详细的玩家资料 (get_player_info)，将玩家从网络中踢出 (kick_player)，发送消息 (send_player_message)，以及通过代理或下游边界代表他们执行命令 (execute_player_command)。

基于 CloudNet Swagger 文档开发。

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: 基本认证密码

🚀 运行

使用 uv：

uv run cloudnet-mcp

🔌 在 Claude Desktop 中使用

将此内容添加到您的 claude_desktop_config.json 中：

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

CloudNet MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，提供了对 CloudNet Service REST API v3 的接口访问支持。它使得 AI 助手能够安全准确地观测您的 CloudNet 节点和服务。

🌟 功能特性

• 获取节点列表及信息: 查看整个 CloudNet 集群内所有节点的详细统计数据和信息

• 管理服务 (Services): 获取运行中的智能服务列表，支持在服务端控制台远程异步执行命令 (execute_service_command)

• 玩家管理与交互 (Player Management): 查询在线玩家列表或通过唯一下位码查询 (get_online_players, get_player_info)、全局踢出玩家 (kick_player)、互发消息聊天 (send_player_message) 以及代替玩家执行代理层或子服命令 (execute_player_command)

基于 CloudNet 官方 Swagger API 文档开发.

🛠 前置要求

• 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: 基本认证的密码

🚀 运行方法

使用 uv:

uv run cloudnet-mcp

🔌 在 Claude Desktop 中使用

将以下配置添加至您的 claude_desktop_config.json：

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