MegaCloud MCP Server

MegaCloud MCP 服务

MegaCloud API 的 MCP 服务，可用于管理中间件、检查信息等。

功能

• 主机检查
• 中间件生命周期管理（创建、启动、停止、重启、删除、添加节点、删除节点）
• 状态和配置检查
• 备份
• 节点级管理

工具

以下是转换为所需格式的 MCP 工具列表：

1. list_available_hosts

   • 列出可用于部署中间件的所有主机。
   • 输入：无
   • 返回：主机对象列表。

2. list_middleware_types

   • 列出所有中间件类型。
   • 输入：无
   • 返回：支持的中间件类型标识符列表。

3. list_middleware_instances

   • 列出当前已部署的所有中间件实例。
   • 输入：无
   • 返回：中间件实例对象列表

4. restart_middleware

   • 重启中间件实例。
   • 输入：
     • middleware_instance_name（字符串）：中间件实例名称
   • 返回：操作结果／状态确认

5. stop_middleware

   • 停止中间件实例。
   • 输入：
     • middleware_instance_name（字符串）：中间件实例名称
   • 返回：操作结果／状态确认

6. start_middleware

   • 启动中间件实例。
   • 输入：
     • middleware_instance_name（字符串）：中间件实例名称
   • 返回：操作结果／状态确认

7. delete_middleware

   • 删除中间件实例。
   • 输入：
     • middleware_instance_name（字符串）：中间件实例名称
   • 返回：操作结果／删除确认

8. get_middleware_info

   • 获取中间件实例的所有信息，例如配置、节点等。
   • 输入：
     • middleware_instance_name（字符串）：中间件实例名称
   • 返回：详细的中间件实例对象

9. get_middleware_status

   • 获取中间件实例的状态。
   • 输入：
     • middleware_instance_name（字符串）：中间件实例名称
   • 返回：状态对象（例如运行／已停止状态及节点列表）

10. backup_middleware

    • 备份中间件实例。
    • 输入：
      • middleware_instance_name（字符串）：中间件实例名称
    • 返回：备份任务详情／确认信息

11. list_middleware_instance_nodes

    • 列出中间件实例的所有节点。
    • 输入：
      • middleware_instance_name（字符串）：中间件实例名称
    • 返回：节点对象数组

12. remove_middleware_instance_nodes

    • 从中间件实例中移除节点。
    • 输入：
      • name（字符串）：中间件实例名称
      • node_names（数组[string]）：要移除的节点名称
    • 返回：操作结果／更新后的节点列表

13. create_single_redis_middleware

    • 创建单个 Redis 实例。
    • 输入：
      • host_name（字符串）：主机名称（必填）
      • max_memory_in_gb（整数，默认值 4）：最大内存（GB）
      • name（字符串 | null，默认值 null）：实例名称（可选）
    • 返回：新创建的中间件实例对象

14. create_redis_cluster_middleware

    • 创建 Redis Cluster 中间件实例。
    • 输入：
      • name（字符串 | null，默认值 null）：集群名称（可选）
      • max_memory_in_gb（整数，默认值 4）：每个节点的最大内存（GB）
      • master_host_names（数组[string]）：主节点主机名称（必填）
      • replica_host_names（数组[string]）：副本节点主机名称（必填）
    • 返回：新创建的集群实例对象

15. add_redis_nodes

    • 向 Redis 中间件实例添加节点。
    • 输入：
      • name（字符串）：Redis 实例名称（必填）
      • master_host_names（数组[string] | null，默认值 null）：新的主节点主机（可选）
      • replica_host_names（数组[string] | null，默认值 null）：新的副本节点主机（可选）
    • 返回：操作结果／更新后的集群拓扑

设置

获取身份验证令牌

登录 MegaCloud 控制台，在加载任意 API 调用时打开浏览器的 Network 标签页，并提取 Authorization: Bearer <token> 请求头的值。

安装

克隆仓库：

git clone https://github.com/megaease/megacloud-mcp.git

然后运行

pip install "mcp[cli]"

请记得为所有用户全局安装 mcp 命令。

VS Code 集成

Cline

安装适用于 VS Code 的 Cline 扩展。

使用以下配置设置 MegaCloud MCP 服务：

{
  "mcpServers": {
    "megacloud-mcp": {
      "type": "stdio",
      "command": "mcp",
      "args": [
        "run",
        "<your-repo-dir>/megacloud-mcp/megacloud_mcp/__main__.py"
      ],
      "env": {
        "MEGACLOUD_AUTHTOKEN": "<your-auth-token>"
      }
    }
  }
}

GitHub Copilot

{
    "mcp": {
        "servers": {
            "test-megacloud-mcp": {
                "type": "stdio",
                "command": "mcp",
                "args": [
                    "run",
                    "<your-repo-dir>/megacloud-mcp/megacloud_mcp/__main__.py"
                ],
                "env": {
                    "MEGACLOUD_AUTHTOKEN": "<your-auth-token>"
                }
            }
        }
    }
}

使用 Docker 运行

构建镜像：

docker build -t megaease/megacloud-mcp . 

设置：

{
    "megacloud-mcp": {
        "type": "stdio",
        "command": "docker",
        "args": [
            "run",
            "-i", 
            "--rm",
            "-e",
            "MEGACLOUD_AUTHTOKEN",
            "megaease/megacloud-mcp"
        ],
        "env": {
            "MEGACLOUD_AUTHTOKEN": "<your-auth-token>"
        }
    }
}