CloudControl MCP Server
Introduction
CloudControl MCP Server is a Model Context Protocol (MCP) server based on the Alibaba Cloud Control API. It provides a unified interface to manage Alibaba Cloud resources. The MCP Server lets you:
-
Create, update, and delete over 300 types of Alibaba Cloud resources
-
Query resource metadata
-
Export existing resources to Terraform code
-
Quickly experiment with cloud product features
Features
CloudControl MCP Server supports unified resource management of over 300 cloud products through natural language interaction. You can describe your requirements in natural language without needing to memorize complex API parameters or product-specific details. The MCP Server automatically parses your requests, populates the necessary parameters, and runs the corresponding actions.
Typical product examples
-
VPC: Create and manage network resources such as virtual private clouds, vSwitches, route tables, and other network resources.
-
ECS: Create and manage compute resources such as ECS instances, images, and snapshots.
-
Hologres: Create and manage data resources such as real-time data warehouse instances, databases, and tables.
-
Container Registry: Create and manage container resources such as repositories, namespaces, and images.
-
OSS: Create and manage storage resources such as buckets, objects, and lifecycle rules.
-
ESA: Create and manage security resources such as edge security acceleration instances, domain configurations, and security policies.
Core capabilities
-
Natural language interaction: Supports describing requirements in natural language and automatically converting them into resource operations.
-
Unified resource management: Provides a unified interface to manage cloud products, abstracting away the differences between various product APIs.
-
Intelligent schema query: Supports dynamic retrieval of resource attributes and configuration requirements, and autocompletes required parameters.
-
IaC support: Supports exporting existing resources to Terraform HCL code, enabling Infrastructure as Code.
-
Asynchronous task management: Supports asynchronous resource operations and task status queries.
Configuration and usage
Configure MCP Server
CloudControl MCP Server is a system service of the MCP Server. Follow these steps to configure it:
-
Go to OpenAPI MCP Service, navigate to the View MCP Service tab, and search for the
cloudcontrolservice. -
In the service list, select the
cloudcontrolservice and click View Configuration Method. For example, to configure for Cursor, switch to the TONGYI Lingma/Cursor/Windsurf/VSCode tab and copy the configuration content to yourmcp.jsonfile.Example configuration: Under
mcpServers, set thecommandfor thecloudcontrolnode tonpx. Itsargsmust includemcp-remote-alibaba-cloudand the service Endpoint URL. You can also click One-click Configuration to Cursor to complete the setup automatically.{ "mcpServers": { "cloudcontrol": { "command": "npx", "args": [ "mcp-remote-alibaba-cloud", "https://openapi-mcp-xxx/mcp" ] } } } -
Save the configuration file and start the MCP Server.
For more information about using MCP, see the OpenAPI MCP Server User Guide.
Usage
After you configure and start the MCP Server, you can interact with the CloudControl MCP Server using natural language.
The CloudControl MCP Server integrates with an AI assistant through the MCP protocol. You can directly converse with the AI assistant in natural language, and the assistant automatically uses the CloudControl MCP Server tools to perform the requested actions.
Example conversation:
Create a VPC for me in China (Ulanqab).
The AI assistant then calls a series of APIs: GetResourceType to check the resource type, CreateResource to create the VPC (which requires the RegionId field and accepts optional fields such as CidrBlock and VpcName), GetTask to poll for status, and GetResources to retrieve the new VPC's details. Once the task succeeds, the server returns the VPC information, including the region cn-wulanchabu, the CIDR block 172.16.0.0/16, the status Available, and the description Test VPC created via CloudControl API. The task status is Succeeded.
Use cases
The following examples show how to use natural language with the CloudControl MCP Server to manage cloud resources.
Resource inventory
Query resource status
Example prompt:
"Show me all the OSS buckets in my account."
Query resource schema
Example prompt:
"I want to create a VPC. What parameters are required?"
Query supported products
Example prompt:
"What cloud products does CloudControl support?"
Product trial
Try object storage features
Example prompt:
"I want to try OSS. Create a test bucket for me."
Resource creation
Create specific resource
Example prompt:
"Create a VPC in the China (Beijing) region with the CIDR block 172.16.0.0/12 and the name my-vpc."
Create ECS instance
Example prompt:
"Create an ECS instance with 2 vCPUs, 4 GiB of memory, and the CentOS 7 operating system. Place it in the VPC that was just created."
Proof of concept
Build 3-tier architecture
Example prompt:
"Help me build a 3-tier architecture that includes the network tier, application tier, and data tier."
IaC migration and upgrades
Export resources to Terraform
Example prompt:
"Export the VPC named my-vpc in my account to Terraform code."
Core APIs
|
API |
Description |
|
cloudcontrol-20220830-ListProducts |
Queries the list of supported cloud products. |
|
cloudcontrol-20220830-ListResourceTypes |
Queries the resource types supported by a specified product. |
|
cloudcontrol-20220830-GetResourceType |
Retrieves the schema for a specified resource type, including attribute definitions, required properties, and permission requirements. |
|
cloudcontrol-20220830-GetResources |
Queries for a list of resources or the details of a specific resource. |
|
cloudcontrol-20220830-CreateResource |
Creates a cloud resource. |
|
cloudcontrol-20220830-UpdateResource |
Updates the attributes of an existing resource. |
|
cloudcontrol-20220830-DeleteResource |
Deletes a specified cloud resource. |
|
cloudcontrol-20220830-GetTask |
Queries the execution status and result of an asynchronous task. |
|
IaCService-20210806-GenerateModule |
Generates Terraform HCL code based on resource attributes. |