了解 CloudControl MCP Server

更新时间:
复制为 MD 格式

简介

CloudControl MCP Server 是一个基于阿里云 Cloud Control API 的 Model Context Protocol (MCP) 服务器,提供统一的接口来管理和操作阿里云资源。通过 MCP Server,可实现以下功能:

  • 创建、更新、删除超过300种阿里云资源

  • 查询资源元数据

  • 将已有资源导出为 Terraform 代码

  • 快速体验云产品功能

功能特性

CloudControl MCP Server 支持通过自然语言统一管理超过300种云产品资源。使用时无需记忆复杂的API参数和产品差异,通过自然语言描述需求,MCP Server即可自动解析、填充参数并执行相应操作。

典型产品示例

  • VPC(专有网络):创建和管理虚拟私有网络、交换机、路由表等网络资源

  • ECS(云服务器):创建和管理云服务器实例、镜像、快照等计算资源

  • Hologres(实时数仓):创建和管理实时数据仓库实例、数据库、表等数据资源

  • CR(容器镜像服务):创建和管理容器镜像仓库、命名空间、镜像等容器资源

  • OSS(对象存储):创建和管理存储空间、对象、生命周期规则等存储资源

  • ESA(边缘安全加速):创建和管理边缘安全加速实例、域名配置、安全策略等安全资源

核心能力

  • 自然语言交互:支持通过自然语言描述需求,并自动转换为资源操作。

  • 统一资源管理:提供统一接口管理云产品,无需关注不同产品的API差异。

  • 智能Schema查询:支持动态获取资源属性和配置要求,并自动补全必填参数。

  • IaC支持:支持将已有资源导出为Terraform HCL代码,实现基础设施即代码。

  • 异步任务管理:支持异步资源操作和任务状态查询。

配置与使用

配置MCP Server

CloudControl MCP Server 是 MCP Server 的一个系统服务。请按照以下步骤进行配置。

  1. 访问OpenAPI MCP 服务,进入查看MCP服务页签并搜索cloudcontrol 服务。

    image

  2. 在服务列表选择 cloudcontrol 服务并单击查看配置方法。以Cursor为例,切换到通义灵码/Cursor/Windsurf/VSCode页签,将配置内容复制到 mcp.json 文件。

    image

    image

  3. 保存配置文件并启动MCP Server。

更多MCP使用信息可参阅OpenAPI MCP Server使用指南

使用方式

配置并启动MCP Server后,即可通过自然语言与CloudControl MCP Server交互。

CloudControl MCP Server通过MCP协议与AI助手集成。可直接通过自然语言与AI助手对话,AI助手将自动调用CloudControl MCP Server的工具执行操作。

示例对话:

请为我在乌兰察布创建一个VPC

image.png

使用场景

以下为通过自然语言与CloudControl MCP Server交互,以完成云资源管理任务的典型场景。

资源清点

查询资源状态

用户自然语言输入:

"帮我看看账号里有哪些 OSS 存储桶"

查询资源Schema

用户自然语言输入:

"我想创建一个 VPC,需要哪些参数?"

查询支持的产品

用户自然语言输入:

"CloudControl 支持哪些云产品?"

产品体验

体验对象存储功能

用户自然语言输入:

"我想体验一下 OSS 对象存储,帮我创建一个测试用的存储桶"

资源创建

创建指定资源

用户自然语言输入:

"在北京地域创建一个 VPC,网段是 172.16.0.0/12,名称叫 my-vpc"

创建ECS实例

用户自然语言输入:

"创建一个 ECS 实例,2核4G,CentOS 7,放在刚才创建的 VPC 里"

原型验证

搭建三层架构

用户自然语言输入:

"帮我搭建一个三层架构,包括网络层、应用层和数据层"

IaC迁移与升级

导出资源为Terraform代码

用户自然语言输入:

"把我账号里的 my-vpc 这个 VPC 导出成 Terraform 代码"

核心API

API

功能描述

cloudcontrol-20220830-ListProducts

查询支持的云产品列表。

cloudcontrol-20220830-ListResourceTypes

查询指定产品支持的资源类型。

cloudcontrol-20220830-GetResourceType

获取指定资源类型的Schema信息,包括属性定义、必填项、权限要求等。

cloudcontrol-20220830-GetResources

查询资源列表或单个资源详情。

cloudcontrol-20220830-CreateResource

创建云资源。

cloudcontrol-20220830-UpdateResource

更新已有资源的属性。

cloudcontrol-20220830-DeleteResource

删除指定的云资源。

cloudcontrol-20220830-GetTask

查询异步任务的执行状态和结果。

IaCService-20210806-GenerateModule

根据资源属性生成Terraform HCL代码。