Back to MCP Servers

Alibaba Cloud MCP Server

Official Alibaba Cloud MCP server for managing ECS, VPC, RDS, OSS, CloudMonitor, and OOS resources through AI assistants.

Cloud Infrastructure by Alibaba Cloud (aliyun) API Key active
Overview

The Alibaba Cloud Ops MCP Server is the official integration from Aliyun that connects Alibaba Cloud APIs to AI assistants via the Model Context Protocol. It enables agents to manage core cloud resources including ECS compute instances, VPC and VSwitch networking, RDS databases, OSS object storage, and CloudMonitor metrics, as well as orchestrate deployments through OOS (Operation Orchestration Service).

Capabilities span the full lifecycle of cloud operations: provisioning and controlling ECS instances (run, start, stop, reboot, delete, reset password, replace system disk), executing remote commands, querying regions, zones, images, and security groups, listing and operating on OSS buckets and objects, managing RDS instance state, and pulling CPU, memory, load average, and disk metrics from CloudMonitor. It also exposes OOS-based application deployment tools that upload artifacts to OSS and track deployment status, plus local helpers for directory listing, shell execution, and project stack analysis.

The server is distributed as a Python package run via uvx and is published by the official aliyun GitHub organization. It is integrated by default with platforms like Cursor, Cline, ModelScope, Lingma, Smithery, FC-Function AI, Qoder, and Alibaba Cloud Model Studio.

Tools

Tool Description
RunCommand Run a shell command on one or more ECS instances via Cloud Assistant.
StartInstances Start one or more ECS instances.
StopInstances Stop one or more ECS instances.
RebootInstances Reboot one or more ECS instances.
DescribeInstances List ECS instances and their attributes for a region.
DescribeRegions List all available Alibaba Cloud regions.
DescribeZones List availability zones in a region.
DescribeAvailableResource Query available ECS resources for purchase in a zone.
DescribeImages List ECS images available in a region.
DescribeSecurityGroups List security groups in a region.
RunInstances Create and launch new ECS instances.
DeleteInstances Delete ECS instances.
ResetPassword Reset the login password of ECS instances.
ReplaceSystemDisk Replace the system disk of an ECS instance with a new image.
DescribeVpcs List VPCs in a region.
DescribeVSwitches List VSwitches in a VPC or region.
DescribeDBInstances List RDS database instances.
StartDBInstances Start RDS instances.
StopDBInstances Stop RDS instances.
RestartDBInstances Restart RDS instances.
ListBuckets List OSS buckets in the account.
PutBucket Create a new OSS bucket.
DeleteBucket Delete an OSS bucket.
ListObjects List objects in an OSS bucket.
GetCpuUsageData Fetch CPU usage metrics for ECS instances from CloudMonitor.
GetCpuLoadavgData Fetch 1-minute CPU load average for ECS instances.
GetCpuloadavg5mData Fetch 5-minute CPU load average for ECS instances.
GetCpuloadavg15mData Fetch 15-minute CPU load average for ECS instances.
GetMemUsedData Fetch used memory metrics for ECS instances.
GetMemUsageData Fetch memory usage percentage for ECS instances.
GetDiskUsageData Fetch disk usage percentage for ECS instances.
GetDiskTotalData Fetch total disk size for ECS instances.
GetDiskUsedData Fetch used disk space for ECS instances.
OOS_CodeDeploy Deploy an application to ECS via OOS, uploading the artifact to OSS automatically.
OOS_GetDeployStatus Query the status of an OOS deployment execution.
OOS_GetLastDeploymentInfo Retrieve metadata about the most recent OOS deployment.
LOCAL_ListDirectory List files in a local directory on the machine running the MCP server.
LOCAL_RunShellScript Execute a shell script locally where the MCP server runs.
LOCAL_AnalyzeDeployStack Analyze a local project to detect its technology stack for deployment planning.
Setup Guide

Prerequisites

  • An Alibaba Cloud account with an AccessKey ID and AccessKey Secret. Create one in the RAM console.
  • The uv package manager installed locally.
  • The RAM user or role must have permissions for the cloud products you intend to manage (ECS, VPC, RDS, OSS, CloudMonitor, OOS).

Install and Configure

The server is published as the Python package alibaba-cloud-ops-mcp-server and is launched via uvx. Add the following block to your MCP client config (Claude Desktop, Cursor, Cline, etc.):

{
  "mcpServers": {
    "alibaba-cloud-ops-mcp-server": {
      "timeout": 600,
      "command": "uvx",
      "args": ["alibaba-cloud-ops-mcp-server@latest"],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "Your Access Key ID",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "Your Access Key SECRET"
      }
    }
  }
}

Required Environment Variables

  • ALIBABA_CLOUD_ACCESS_KEY_ID: AccessKey ID of your RAM user.
  • ALIBABA_CLOUD_ACCESS_KEY_SECRET: AccessKey Secret of your RAM user.

Restart your MCP client after editing the config. The server is also available out of the box on Qoder, Cursor, Cline, ModelScope, Lingma, Smithery AI, FC-Function AI, and Alibaba Cloud Model Studio.

Use Cases
  • Provision and manage ECS fleets from natural language: launch new instances, reset passwords, or replace system disks across regions.
  • Run remote shell commands on ECS instances via Cloud Assistant to perform routine maintenance, patching, or diagnostics.
  • Inspect CloudMonitor metrics (CPU, memory, disk, load average) to triage performance issues on ECS instances.
  • Manage OSS buckets and objects for storage cleanup, listing artifacts, or provisioning new buckets for projects.
  • Deploy applications to ECS via OOS, with automatic artifact upload to OSS and deployment status tracking.
  • Control RDS database lifecycle (start, stop, restart) and list instances for cost optimization or scheduled maintenance windows.
Example Prompts
  • "List all ECS instances in cn-hangzhou and stop any that have been idle (under 5% CPU) for the past 24 hours."
  • "Create three ECS instances in cn-shanghai using image aliyun_3_x64 with instance type ecs.g6.large in security group sg-xxx."
  • "Show me CPU and memory usage for instance i-bp1abc123 over the last 6 hours."
  • "Run df -h on all production ECS instances and summarize disk pressure."
  • "List my OSS buckets and tell me which ones are in the cn-beijing region."
  • "Deploy the project at ./my-app to ECS instance i-bp1xyz and report the deployment status."
Pros
  • Official Aliyun project: Maintained under the aliyun GitHub organization, ensuring API coverage stays aligned with Alibaba Cloud services.
  • Broad service coverage: Includes ECS, VPC, RDS, OSS, CloudMonitor, and OOS in a single server rather than requiring separate integrations.
  • Built-in deployment workflow: OOS_CodeDeploy automates artifact upload to OSS and orchestrates deployment to ECS, not just raw API calls.
  • Wide client support: Works with Cursor, Cline, Claude Desktop, ModelScope, Smithery, and Alibaba Cloud Model Studio.
Limitations
  • Long-lived AccessKey required: Uses static ACCESS_KEY_ID and ACCESS_KEY_SECRET env vars rather than STS tokens or role-based auth, which is risky if exposed.
  • Powerful destructive tools: Exposes DeleteInstances, DeleteBucket, ResetPassword, and ReplaceSystemDisk to the model without built-in confirmation guardrails.
  • Limited service depth: Many Alibaba Cloud products (SLB, Container Service, MaxCompute, Function Compute, etc.) are not covered, and within covered services some operations like RDS create or VPC create are missing.
Alternatives
  • AWS MCP servers by AWS Labs for managing AWS resources.
  • Cloudflare MCP server for Cloudflare workers, KV, R2, and DNS.
  • Tencent Cloud and other community-built cloud provider MCP servers on Smithery for multi-cloud setups.