CloudControl MCP Server

Updated at:

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:

  1. Go to OpenAPI MCP Service, navigate to the View MCP Service tab, and search for the cloudcontrol service.

  2. In the service list, select the cloudcontrol service 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 your mcp.json file.

    Example configuration: Under mcpServers, set the command for the cloudcontrol node to npx. Its args must include mcp-remote-alibaba-cloud and 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"
          ]
        }
      }
    }
  3. 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.