alibabacloud-rds-openapi-mcp-server

English | 中文

MCP server for RDS Services via OPENAPI

1. Install uv from Astral or the GitHub README
2. Install Python using uv python install 3.12
3. Alibaba Cloud credentials with access to Alibaba Cloud RDS services

Install the MCP environment according to Cherry-Studio's documentation, then configure and use RDS MCP. Add the following configuration to the MCP client configuration file:

"mcpServers": {
  "rds-openapi-mcp-server": {
    "command": "uvx",
    "args": [
      "alibabacloud-rds-openapi-mcp-server@latest"
    ],
    "env": {
      "ALIBABA_CLOUD_ACCESS_KEY_ID": "access_id",
      "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "access_key",
      "ALIBABA_CLOUD_SECURITY_TOKEN": "sts_security_token" // optional, required when using STS Token 
    }
  }
}

Set you env and run mcp server.

# set env
export SERVER_TRANSPORT=sse;
export ALIBABA_CLOUD_ACCESS_KEY_ID=$you_access_id;
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=$you_access_key;
export ALIBABA_CLOUD_SECURITY_TOKEN=$you_sts_security_token; # optional, required when using STS Token 

# run mcp server
uvx alibabacloud-rds-openapi-mcp-server@latest

After run mcp server, you will see the following output:

INFO:     Started server process [91594]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)

And then configure the Cline.

remote_server = "http://127.0.0.1:8000/sse";

Download from Github

git clone https://github.com/aliyun/alibabacloud-rds-openapi-mcp-server.git

Add the following configuration to the MCP client configuration file:

"mcpServers": {
  "rds-openapi-mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/alibabacloud-rds-openapi-mcp-server/src/alibabacloud_rds_openapi_mcp_server",
      "run",
      "server.py"
    ],
    "env": {
      "ALIBABA_CLOUD_ACCESS_KEY_ID": "access_id",
      "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "access_key",
      "ALIBABA_CLOUD_SECURITY_TOKEN": "sts_security_token"  // optional, required when using STS Token
    }
  }
}

• create_db_instance: Create an RDS instance.
• describe_db_instances: Queries instances.
• describe_db_instance_attribute: Queries the details of an instance.
• describe_db_instance_performance: Queries the performance data of an instance.
• describe_error_logs: Queries the error log of an instance.
• describe_db_instance_net_info: Batch retrieves network configuration details for multiple RDS instances.
• describe_db_instance_ip_allowlist: Batch retrieves IP allowlist configurations for multiple RDS instances.
• describe_db_instance_databases: Batch retrieves database information for multiple RDS instances.
• describe_db_instance_accounts: Batch retrieves account information for multiple RDS instances.
• describe_available_classes: Query available instance classes and storage ranges.
• describe_available_zones: Query available zones for RDS instances.
• describe_bills: Query the consumption summary of all product instances or billing items for a user within a specific billing period.
• describe_vpcs: Query VPC list.
• describe_vswitches: Query VSwitch list.
• describe_slow_log_records: Query slow log records for an RDS instance.
• describe_db_instance_parameters: Batch retrieves parameter information for multiple RDS instances.
• modify_parameter: Modify RDS instance parameters.
• modify_db_instance_spec: Modify RDS instance specifications.
• get_current_time: Get the current time.

None at this time

# Role  
You are a professional Alibaba Cloud RDS Copilot, specializing in providing customers with efficient technical support and solutions for RDS (Relational Database Service). Your goal is to help customers resolve issues quickly through clear problem decomposition, precise tool invocation, and accurate time calculations.

## Skills  

### Skill 1: Problem Decomposition and Analysis  
- Deeply deconstruct user questions to identify core requirements and potential steps/commands involved.  
- Provide clear task breakdowns to ensure each step contributes to the final solution.
- Please organize your answers in a table format as much as possible.

### Skill 2: RDS MCP Tool Invocation  
- Proficiently invoke the RDS MCP tool to retrieve database information or execute operations.  
- Tool invocation must follow task decomposition and align with logical reasoning and customer needs.  
- Select appropriate MCP modules (e.g., monitoring data queries, performance diagnostics, backup/recovery) based on user requirements.  

### Skill 3: Time Interpretation and Calculation  
- Accurately parse relative time concepts like "today," "yesterday," or "the last hour."  
- Convert relative time expressions into precise time ranges or timestamps using the current time to support data queries or operations.  

## Constraints  
- **Task Decomposition First**: Always provide detailed task breakdowns.  
- **Tool Dependency Clarity**: All MCP tool invocations must be justified by clear task requirements and logical reasoning.  
- **Time Precision**: Calculate exact time ranges for time-sensitive queries.  
- **Professional Focus**: Discuss only Alibaba Cloud RDS-related technical topics.  
- **Safety Awareness**: Ensure no operations negatively impact customer databases.

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the Apache 2.0 License.