Alibaba Cloud Ops

This Alibaba Cloud Operations MCP Server lets you control Alibaba Cloud services such as ECS, VPC, RDS, OSS, CloudMonitor, and OOS through the Amazon Q MCP client. It enables you to run cloud operations from a single MCP interface, automate tasks, and validate configurations in a unified workflow.

How to use

You will use the MCP client to connect to this server and perform cloud operations across Alibaba Cloud services. Start by ensuring your MCP client is configured to reach the server, then run the server’s startup command from your MCP workflow. The server exposes endpoints for a range of Alibaba Cloud services and will respond to operational requests initiated from the MCP client.

To run a local instance, start the server using the standard MCP command flow and verify that the server reports it is ready to accept connections. You can validate the setup by running the built-in verify script and then starting the server script to ensure it initializes correctly.

How to install

# Prerequisites
# - Python 3.10+
# - uv (Python package and project manager)
# - Alibaba Cloud access credentials

# 1. Install uv
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or use pip
pip install uv

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 2. Clone the project
git clone https://github.com/your-username/alicloud-ops-mcp.git
cd alicloud-ops-mcp

# 3. One-click install
# Run the installation script (recommended)
./install.sh

# Or manual install
uv sync
cp .env.example .env
# Edit .env to fill in your Alibaba Cloud credentials

# 4. Configure environment variables
# Edit .env and set your credentials and region
# Example
ALIBABA_CLOUD_ACCESS_KEY_ID="your_access_key_id"
ALIBABA_CLOUD_ACCESS_KEY_SECRET="your_access_key_secret"
ALIBABA_CLOUD_REGION="cn-beijing"

# 5. Verify installation
# Run the verification script
uv run python verify_setup.py

# Test starting the server
uv run python complete_fastmcp_server.py

Additional setup and configuration

{
  "mcpServers": {
    "alibaba-cloud-ops-mcp-server": {
      "timeout": 30000,
      "command": "uv",
      "args": [
        "--directory",
        "/绝对路径/to/alicloud-ops-mcp",
        "run",
        "python",
        "complete_fastmcp_server.py"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

MCP JSON configuration for Amazon Q CLI

Integrate the MCP server into your Amazon Q CLI workflow by adding the following configuration to your MCP.json file. This config uses the server in a standard stdio MCP setup, pointing to the local project directory and the main server script.

{
  "mcpServers": {
    "alibaba-cloud-ops-mcp-server": {
      "timeout": 30000,
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/alicloud-ops-mcp",
        "run",
        "python",
        "complete_fastmcp_server.py"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Environment variables

You need Alibaba Cloud credentials and a target region to operate. Define these in the environment section or in your .env file. The example values are placeholders you should replace with your own credentials.

ALIBABA_CLOUD_ACCESS_KEY_ID="your_access_key_id"
ALIBABA_CLOUD_ACCESS_KEY_SECRET="your_access_key_secret"
ALIBABA_CLOUD_REGION="cn-beijing"

Troubleshooting and notes

If you encounter permission issues or the server cannot start, ensure you are using the MCP command to launch the server and that the project path is correct. Make the startup script executable and verify the absolute path you provide in the MCP configuration.

Common checks include validating the MCP command path, confirming the environment file exists, and running the verification script to confirm you have a valid setup.

Security and maintenance

Keep your Alibaba Cloud credentials secure. Do not commit .env files to version control. Rotate credentials periodically and use least-privilege access keys. Regularly update dependencies via the package manager you use (uv) and re-run the environment verification after updates.

Available tools

api_tools

General API utilities used across Alibaba Cloud service tools in the MCP server.

cms_tools

CloudMonitor related tooling for metrics and alerts.

oss_tools

OSS client utilities for object storage operations.

oos_tools

OOS orchestration and automation task tools.

common_api_tools

Shared APIs and helpers used by multiple service tools.