playbooks

home / mcp / alibaba cloud ops mcp server

Alibaba Cloud Ops MCP Server

Provides MCP access to Alibaba Cloud APIs for managing ECS, RDS, OSS, Cloud Monitor, and related resources.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "aliyun-alibaba-cloud-ops-mcp-server": {
      "url": "https://example-mcp-endpoint.local/mcp",
      "headers": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "AKIDEXAMPLE",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLE"
      }
    }
  }
}

Alibaba Cloud Ops MCP Server provides seamless Model Context Protocol integration with Alibaba Cloud APIs, enabling your AI assistants to operate resources such as ECS, Cloud Monitor, and OOS across Alibaba Cloud.

How to use

You connect a client to the Alibaba Cloud Ops MCP Server to perform cloud operations through a consistent MCP interface. Start the MCP server process locally or remotely, then configure your MCP client to target this server. Once connected, you can issue supported operations such as listing ECS instances, starting or stopping instances, managing VPCs, and querying monitoring data. All actions are exposed through the MCP endpoints described in the server’s toolset.

How to install

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

Additional configuration and usage notes

Prepare the server by installing the runtime and then run the MCP server via the standard MCP launcher. You can provide credentials to access Alibaba Cloud APIs through environment variables. The following configuration snippet shows how to register the server under MCP config with a local runtime.

{
  "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"
      }
    }
  }
}

Notes on security and readiness

The server is designed to be ready to use out of the box and accepts credentials through environment variables. Treat your access keys as sensitive data and rotate them periodically. When running in shared or production environments, follow your organization’s security guidelines for secret management and least-privilege access.

Tools and capabilities (high level)

The server exposes a comprehensive set of cloud operations across Alibaba Cloud products. You can perform actions such as managing ECS instances, VPCs, RDS, OSS buckets, and Cloud Monitor metrics. The full list of exposed operations includes actions like RunCommand, StartInstances, StopInstances, RebootInstances, DescribeInstances, DescribeRegions, DescribeZones, DescribeImages, DescribeSecurityGroups, RunInstances, DeleteInstances, ResetPassword, ReplaceSystemDisk, DescribeVpcs, DescribeVSwitches, DescribeDBInstances, StartDBInstances, StopDBInstances, RestartDBInstances, OSS bucket and object management, and Cloud Monitor metric queries for CPU, memory, and disk usage.

Troubleshooting and tips

If you encounter connectivity or authentication issues, verify that your ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET are correctly set in the server’s environment. Ensure the uvx runtime is installed and that the server process is running with the configured timeout. Check your MCP client configuration to confirm it references the correct server name and startup parameters.

Available tools

RunCommand

Execute a command on a remote ECS instance via Alibaba Cloud RunCommand integration.

StartInstances

Start one or more ECS instances.

StopInstances

Stop one or more ECS instances.

RebootInstances

Reboot one or more ECS instances.

DescribeInstances

List and view details of ECS instances.

DescribeRegions

List available regions for resources.

DescribeZones

List availability zones within a region.

DescribeAvailableResource

Query resource inventory to understand what is available for use.

DescribeImages

List available machine images.

DescribeSecurityGroups

View security group configurations.

RunInstances

Create new ECS instances.

DeleteInstances

Terminate ECS instances.

ResetPassword

Modify the password on an ECS instance.

ReplaceSystemDisk

Replace the OS disk for an ECS instance.

DescribeVpcs

View VPC configurations.

DescribeVSwitches

View VSwitch configurations.

DescribeDBInstances

List RDS instances.

StartDBInstances

Start an RDS instance.

StopDBInstances

Stop an RDS instance.

RestartDBInstances

Restart an RDS instance.

ListBuckets

List OSS buckets.

PutBucket

Create an OSS bucket.

DeleteBucket

Delete an OSS bucket.

ListObjects

View objects in an OSS bucket.

GetCpuUsageData

Get CPU usage data for ECS instances.

GetCpuLoadavgData

Get 1-minute CPU load average.

GetCpuloadavg5mData

Get 5-minute CPU load average.

GetCpuloadavg15mData

Get 15-minute CPU load average.

GetMemUsedData

Get memory usage data.

GetMemUsageData

Get memory utilization data.

GetDiskUsageData

Get disk utilization data.

GetDiskTotalData

Get total disk capacity data.

GetDiskUsedData

Get disk usage data.