Skip to content

Releases: aliyun/alibaba-cloud-ops-mcp-server

v0.9.1

25 Jun 12:15
3ee9f5e

Choose a tag to compare

🚀 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

25 Jun 11:59
eabf785

Choose a tag to compare

🚀 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.8.9

25 Jun 11:58
461b1b3

Choose a tag to compare

What's Changed

Full Changelog: v0.8.8...v0.8.9

v0.7.2

25 Jun 11:41
050c461

Choose a tag to compare

🎉 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.