Skip to content

aliyun/alibaba-cloud-ops-mcp-server

MCP SaaS Integrations

A Model Context Protocol (MCP) server that lets AI assistants manage and deploy applications on Alibaba Cloud resources such as ECS, VPC, RDS, OSS, and monitoring services.

Python Latest v0.9.27 · 2mo ago Security brief →

Features

  • Manage ECS instances (create, start/stop/reboot/delete, run commands, view details)
  • Control VPCs and VSwitches
  • Operate RDS databases (list, start/stop/restart)
  • Handle OSS buckets and objects (list/create/delete/view items)
  • Retrieve Cloud Monitor metrics for ECS instances

Recent releases

View all 5 releases →
v0.9.27 New feature
Notable features
  • Command line configuration injection for flexible MCP server setup
  • Automated deployment command generation for applications
  • Enhanced error handling for deployment reliability
Full changelog

We're excited to announce the release of Alibaba Cloud Ops MCP Server v0.9.27, bringing enhanced configuration flexibility and improved deployment automation capabilities.

🚀 What's New

  1. Command Line Configuration Injection
    Enhanced CLI Support: Added support for config injection through command line parameters when starting the MCP server
    Improved Flexibility: Streamlined configuration management for different deployment scenarios
    Better Developer Experience: Simplified setup process for various environments
  2. Automated Application Deployment
    Auto-Generated Deployment Commands: New application deployment functionality that automatically generates deployment commands
    Enhanced Error Handling: Improved fault tolerance mechanisms for more reliable deployments
v0.9.1 New feature
Notable features
  • Per-request header-based credential control for individual tool calls
  • Multi-tenant architecture support through a single server instance
  • Dynamic account switching without server restart
Full changelog

🚀 v0.9.1 - Header Credentials Support

We're excited to announce the release of Alibaba Cloud Ops MCP Server v0.9.1, bringing a revolutionary enhancement to authentication flexibility with header-based credentials support that enables multi-tenant scenarios and dynamic credential switching.

✨ What's New

🔐 Dynamic Header Credentials Support

This release introduces game-changing header-based authentication that allows MCP Clients to control credentials for each individual tool call, enabling powerful multi-tenant scenarios and seamless account switching.

🎯 Features:

  • Per-Request Credential Control: MCP Clients can specify different credentials for each tool call
  • Multi-Tenant Architecture: Support multiple users/accounts through a single MCP Server instance
  • Dynamic Account Switching: Switch between different Alibaba Cloud accounts without server restart
  • Real-time Credential Management: Use any user's credentials for any tool call instantly

🏢 Multi-Tenant & Dynamic Switching Capabilities

🔄 Dynamic Credential Switching

Each tool call can use completely different credentials, allowing:

  • Account A credentials for ECS operations
  • Account B credentials for RDS management
  • Account C credentials for monitoring data
  • All within the same session and server instance

🔧 How to Use Header Credentials

Supported Header Fields:

  • x-acs-accesskey-id: Your Alibaba Cloud Access Key ID
  • x-acs-accesskey-secret: Your Alibaba Cloud Access Key Secret
  • x-acs-security-token: Your Alibaba Cloud Security Token (for STS scenarios)

Client-side (New Feature)

MCP Clients can now choose between:

Option 1: Server Environment Variables (Existing)

# Server started with environment variables
ALIBABA_CLOUD_ACCESS_KEY_ID=your_key_id \
ALIBABA_CLOUD_ACCESS_KEY_SECRET=your_secret \
alibaba-cloud-ops-mcp-server

Option 2: Client Header Credentials (New)

// MCP Client example
const mcpRequest = {
  headers: {
    'x-acs-accesskey-id': 'your_access_key_id',
    'x-acs-accesskey-secret': 'your_access_key_secret',
    'x-acs-security-token': 'your_security_token' // Optional, for STS
  },
  // ... other MCP request data
};

📦 Installation & Upgrade

# Install the latest version
pip install alibaba-cloud-ops-mcp-server==0.9.1

# Upgrade from previous version
pip install --upgrade alibaba-cloud-ops-mcp-server

🔄 Authentication Methods Comparison

| Method | Scope | Flexibility | Multi-Tenant | Dynamic Switch |
|--------|-------|-------------|--------------|----------------|
| Environment Variables | Server-wide | Static | ❌ | ❌ |
| Header Credentials | Per-request | Dynamic | ✅ | ✅ |


Full Changelog: v0.9.0...v0.9.1

Installation: pip install alibaba-cloud-ops-mcp-server==0.9.1

Upgrade: pip install --upgrade alibaba-cloud-ops-mcp-server

v0.9.0 New feature
Notable features
  • Common API Caller tool for generic access to all OpenAPI endpoints
  • Support for 10 Alibaba Cloud services (ECS, RDS, VPC, SLB, OOS, ESS, ROS, CBN, DDS, r-kvstore)
  • API discovery tools including PromptUnderstanding, ListAPIs, and GetAPIInfo
Full changelog

🚀 v0.9.0 - Common API Caller Support

We're excited to announce v0.9.0 with Common API Caller support, enabling universal access to Alibaba Cloud OpenAPI services through 4 standardized tools.

✨ What's New

🔧 Common API Caller Tools

In addition to existing specialized tools, this release adds 4 universal tools that provide access to all OpenAPI endpoints for supported services:

  • PromptUnderstanding - Convert user queries into Alibaba Cloud expert suggestions
  • ListAPIs - Get API list information by service name
  • GetAPIInfo - Get detailed API metadata for specific service and API
  • CommonAPICaller - Execute actual API calls with specified parameters

📋 Supported Services for Common API Caller

The Common API Caller supports all OpenAPI endpoints for these services:

| Service | Description |
|---------|-------------|
| ecs | Elastic Compute Service |
| oos | Operations Orchestration Service |
| rds | Relational Database Service |
| vpc | Virtual Private Cloud |
| slb | Server Load Balancer |
| ess | Elastic Scaling |
| ros | Resource Orchestration Service |
| cbn | Cloud Enterprise Network |
| dds | MongoDB Database Service |
| r-kvstore | Cloud Database Tair (Redis-compatible) |

🚀 Quick Start

From Local Development

ALIBABA_CLOUD_ACCESS_KEY_ID=<Your AccessKeyId> ALIBABA_CLOUD_ACCESS_KEY_SECRET=<Your AccessKeySecret> uv run src/alibaba_cloud_ops_mcp_server/server.py --services "ecs,oos,rds,vpc,slb,ess,ros,cbn,dds,r-kvstore" --transport sse

From Package

ALIBABA_CLOUD_ACCESS_KEY_ID=<Your AccessKeyId> ALIBABA_CLOUD_ACCESS_KEY_SECRET=<Your AccessKeySecret> uvx alibaba-cloud-ops-mcp-server@latest --services "ecs,oos,rds,vpc,slb,ess,ros,cbn,dds,r-kvstore" --transport sse

🔧 MCP Client Configuration

Add this to your MCP client configuration:

{
  "mcpServers": {
    "alibaba-cloud-ops-mcp-server": {
      "timeout": 600,
      "command": "uvx",
      "args": [
        "alibaba-cloud-ops-mcp-server@latest",
        "--services",
        "ecs,oos,rds,vpc,slb,ess,ros,cbn,dds,r-kvstore"
      ],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "Your Access Key ID",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "Your Access Key SECRET"
      }
    }
  }
}

📦 Installation & Upgrade

pip install alibaba-cloud-ops-mcp-server==0.9.0

🙏 Contributors

Thanks to @zhaoshuaibo-china for implementing the Common API Caller system.


Full Changelog: v0.8.9...v0.9.0

Documentation: README_mcp_args.md

v0.7.2 New feature
Notable features
  • ECS instance management with 30+ operations for compute management
  • VPC management capabilities for network infrastructure
  • CloudMonitor metrics for performance and system monitoring
Full changelog

🎉 Alibaba Cloud Ops MCP Server v0.7.2 - Initial Release

We're excited to announce the initial release of Alibaba Cloud Ops MCP Server, a powerful Model Context Protocol (MCP) server that enables seamless integration with Alibaba Cloud services through AI assistants and tools.

✨ What's New

This is the first official release of the Alibaba Cloud Ops MCP Server, providing comprehensive support for managing and monitoring your Alibaba Cloud infrastructure through natural language interactions.

🚀 Key Features

| Product | Tool | Function | Implematation | Status |
| --- | --- | --- | --- | --- |
| ECS | RunCommand | Run Command | OOS | Done |
| | StartInstances | Start Instances | OOS | Done |
| | StopInstances | Stop Instances | OOS | Done |
| | RebootInstances | Reboot Instances | OOS | Done |
| | DescribeInstances | View Instances | API | Done |
| | DescribeRegions | View Regions | API | Done |
| | DescribeZones | View Zones | API | Done |
| | DescribeAvailableResource | View Resource Inventory | API | Done |
| | DescribeImages | View Images | API | Done |
| | DescribeSecurityGroups | View Security Groups | API | Done |
| | RunInstances | Create Instances | OOS | Done |
| | DeleteInstances | Delete Instances | API | Done |
| | ResetPassword | Modify Password | OOS | Done |
| | ReplaceSystemDisk | Replace Operating System | OOS | Done |
| VPC | DescribeVpcs | View VPCs | API | Done |
| | DescribeVSwitches | View VSwitches | API | Done |
| CloudMonitor | GetCpuUsageData | Get CPU Usage Data for ECS Instances | API | Done |
| | GetCpuLoadavgData | Get CPU One-Minute Average Load Metric Data | API | Done |
| | GetCpuloadavg5mData | Get CPU Five-Minute Average Load Metric Data | API | Done |
| | GetCpuloadavg15mData | Get CPU Fifteen-Minute Average Load Metric Data | API | Done |
| | GetMemUsedData | Get Memory Usage Metric Data | API | Done |
| | GetMemUsageData | Get Memory Utilization Metric Data | API | Done |
| | GetDiskUsageData | Get Disk Utilization Metric Data | API | Done |
| | GetDiskTotalData | Get Total Disk Partition Capacity Metric Data | API | Done |
| | GetDiskUsedData | Get Disk Partition Usage Metric Data | API | Done |

📦 Installation

pip install alibaba-cloud-ops-mcp-server

🚀 Quick Start

From Local Development Environment

ALIBABA_CLOUD_ACCESS_KEY_ID=<Your AccessKeyId> ALIBABA_CLOUD_ACCESS_KEY_SECRET=<Your AccessKeySecret> uv run src/alibaba_cloud_ops_mcp_server/server.py --transport sse

From Package

ALIBABA_CLOUD_ACCESS_KEY_ID=<Your AccessKeyId> ALIBABA_CLOUD_ACCESS_KEY_SECRET=<Your AccessKeySecret> uvx alibaba-cloud-ops-mcp-server@latest --transport sse

📋 Requirements

  • Python 3.11 or higher
  • Valid Alibaba Cloud credentials (AccessKey ID and Secret)

📚 Documentation

🤝 Contributing

We welcome contributions! This project is licensed under the Apache License 2.0.

🔮 What's Next

This initial release establishes the foundation for Alibaba Cloud MCP integration. Future releases will expand service support, add more advanced features, and improve performance.


Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
117
Forks
35
Languages
Python Dockerfile

Install & Platforms

Install via
shell-script

Beta — feedback welcome: [email protected]