Releases: aliyun/alibaba-cloud-ops-mcp-server
v0.9.1
🚀 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 IDx-acs-accesskey-secret: Your Alibaba Cloud Access Key Secretx-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-serverOption 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
🚀 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 suggestionsListAPIs- Get API list information by service nameGetAPIInfo- Get detailed API metadata for specific service and APICommonAPICaller- 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 sseFrom 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
What's Changed
- Update UnitTest by @zhaoshuaibo-china in #28
- Support Host by @zhaoshuaibo-china in #30
Full Changelog: v0.8.8...v0.8.9
v0.7.2
🎉 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 sseFrom 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
- English documentation: README.md
- 中文文档: README_zh.md
🤝 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.