alibaba-cloud-ops-mcp-server 0.8.5__py3-none-any.whl → 0.9.0__py3-none-any.whl

alibaba_cloud_ops_mcp_server/alibabacloud/api_meta_client.py

@@ -30,12 +30,13 @@ class ApiMetaClient:
 
     @classmethod
     def get_response_from_pop_api(cls, pop_api_name, service=None, api=None, version=None):
+        url = None  # 提前定义，防止 except 中引用未定义变量
         try:
             api_config = cls.config.get(pop_api_name)
             try:
                 formatted_path = api_config[cls.PATH].format(service=service, api=api, version=version)
             except KeyError as e:
-                raise Exception(f'Failed to format path, path: {api_config[cls.PATH]}, error: {e}')
+                raise Exception(f'Failed to format path, path: {api_config.get(cls.PATH)}, error: {e}')
 
             url = f'{cls.BASE_URL}/{formatted_path}'
             response = requests.get(url)
@@ -46,9 +47,16 @@ class ApiMetaClient:
     @classmethod
     def get_service_version(cls, service):
         data = cls.get_response_from_pop_api(cls.GET_PRODUCT_LIST)
-        version = next((item.get(DEFAULT_VERSION) for item in data if item.get(CODE).lower() == service), None)
+        version = next((item.get(DEFAULT_VERSION) for item in data if item.get(CODE).lower() == service.lower()), None)
         return version
 
+    @classmethod
+    def get_all_service_info(cls):
+        data = cls.get_response_from_pop_api(cls.GET_PRODUCT_LIST)
+        filtered_data = [{"code": item["code"], "name": item["name"]} for item in data]
+
+        return filtered_data
+
     @classmethod
     def get_service_style(cls, service):
         data = cls.get_response_from_pop_api(cls.GET_PRODUCT_LIST)
@@ -146,7 +154,8 @@ class ApiMetaClient:
         return combined_params
 
     @classmethod
-    def get_apis_in_service(cls, service, version):
+    def get_apis_in_service(cls, service):
+        version = cls.get_service_version(service)
         data = cls.get_response_from_pop_api(cls.GET_API_OVERVIEW, service=service, version=version)
         apis = list(data[APIS].keys())
         return apis

alibaba_cloud_ops_mcp_server/alibabacloud/static/PROMPT_UNDERSTANDING.md

@@ -0,0 +1,134 @@
+## Optimized Prompt
+
+When a user submits a request, analyze their needs and check if matching tools exist. If yes, use them directly. If not, proceed to the retrieval phase.
+
+---
+
+## Request Flow
+
+1. **Analysis & Selection**
+   - Analyze user intent
+   - Choose between specific tools or common API flow
+   - Verify service support
+
+2. **API Flow** (if no specific tool)
+   - Identify service
+   - Select API via `ListAPIs`
+   - Get params via `GetAPIInfo`
+   - Execute via `CommonAPICaller`
+
+3. **Error Handling**
+   - Service not supported: "Unfortunately, we currently do not support this service"
+   - API failures: Check error code, params, permissions
+   - Param validation: Verify types and formats
+
+---
+
+### Retrieval Phase
+
+1. **Service Selection**
+
+   Supported Services:
+   - ecs: Elastic Compute Service (ECS)
+   - oos: Operations Orchestration Service (OOS)
+   - rds: Relational Database Service (RDS)
+   - vpc: Virtual Private Cloud (VPC)
+   - slb: Server Load Balancer (SLB)
+   - ess: Elastic Scaling (ESS)
+   - ros: Resource Orchestration Service (ROS)
+   - cbn: Cloud Enterprise Network (CBN)
+   - dds: MongoDB Database Service (DDS)
+   - r-kvstore: Cloud database Tair (compatible with Redis) (R-KVStore)
+
+2. **API Process**
+   - Use `ListAPIs` for available APIs
+   - Use `GetAPIInfo` for API details
+   - Use `CommonAPICaller` to execute
+
+---
+
+### Notes
+- Filter for most appropriate result
+- Choose based on user context and common usage
+- Validate parameters before calls
+- Handle errors gracefully
+
+---
+
+### Common Scenarios
+
+1. **Instance Management**
+   ```
+   User: "Start ECS instance i-1234567890abcdef0"
+   Action: Use OOS_StartInstances
+   ```
+
+2. **Monitoring**
+   ```
+   User: "Check ECS CPU usage"
+   Action: Use CMS_GetCpuUsageData
+   ```
+
+3. **Custom API**
+   ```
+   User: "Create VPC in cn-hangzhou"
+   Action: ListAPIs → GetAPIInfo → CommonAPICaller
+   ```
+
+---
+
+## Available Tools
+
+### ECS (OOS/API)
+- RunCommand: Execute commands on instances
+- StartInstances: Start ECS instances
+- StopInstances: Stop ECS instances
+- RebootInstances: Reboot ECS instances
+- DescribeInstances: List instance details
+- DescribeRegions: List available regions
+- DescribeZones: List available zones
+- DescribeAvailableResource: Check resource inventory
+- DescribeImages: List available images
+- DescribeSecurityGroups: List security groups
+- RunInstances: Create new instances
+- DeleteInstances: Delete instances
+- ResetPassword: Change instance password
+- ReplaceSystemDisk: Change instance OS
+
+### VPC (API)
+- DescribeVpcs: List VPCs
+- DescribeVSwitches: List VSwitches
+
+### RDS (OOS/API)
+- DescribeDBInstances: List database instances
+- StartDBInstances: Start RDS instances
+- StopDBInstances: Stop RDS instances
+- RestartDBInstances: Restart RDS instances
+
+### OSS (API)
+- ListBuckets: List OSS buckets
+- PutBucket: Create bucket
+- DeleteBucket: Delete bucket
+- ListObjects: List bucket contents
+
+### CloudMonitor (API)
+- GetCpuUsageData: Get instance CPU usage
+- GetCpuLoadavgData: Get 1m CPU load
+- GetCpuloadavg5mData: Get 5m CPU load
+- GetCpuloadavg15mData: Get 15m CPU load
+- GetMemUsedData: Get memory usage
+- GetMemUsageData: Get memory utilization
+- GetDiskUsageData: Get disk utilization
+- GetDiskTotalData: Get total disk space
+- GetDiskUsedData: Get used disk space
+
+Note: (OOS) = Operations Orchestration Service, (API) = Direct API call
+
+---
+
+### Best Practices
+- Use pre-defined tools when possible
+- Follow API rate limits
+- Implement proper error handling
+- Validate all parameters
+- Use appropriate endpoints

alibaba_cloud_ops_mcp_server/alibabacloud/static/__init__.py

@@ -0,0 +1,8 @@
+from importlib import resources
+
+with (
+    resources.files('alibaba_cloud_ops_mcp_server.alibabacloud.static')
+    .joinpath('PROMPT_UNDERSTANDING.md')
+    .open('r', encoding='utf-8') as f
+):
+    PROMPT_UNDERSTANDING = f.read()

alibaba_cloud_ops_mcp_server/server.py

@@ -2,16 +2,30 @@ from mcp.server.fastmcp import FastMCP
 import click
 import logging
 
+from alibaba_cloud_ops_mcp_server.tools.common_api_tools import set_custom_service_list
 from alibaba_cloud_ops_mcp_server.config import config
-from alibaba_cloud_ops_mcp_server.tools import cms_tools, oos_tools, oss_tools, api_tools
+from alibaba_cloud_ops_mcp_server.tools import cms_tools, oos_tools, oss_tools, api_tools, common_api_tools
 
 logger = logging.getLogger(__name__)
 
+SUPPORTED_SERVICES_MAP = {
+    "ecs": "Elastic Compute Service (ECS)",
+    "oos": "Operations Orchestration Service (OOS)",
+    "rds": "Relational Database Service (RDS)",
+    "vpc": "Virtual Private Cloud (VPC)",
+    "slb": "Server Load Balancer (SLB)",
+    "ess": "Elastic Scaling (ESS)",
+    "ros": "Resource Orchestration Service (ROS)",
+    "cbn": "Cloud Enterprise Network (CBN)",
+    "dds": "MongoDB Database Service (DDS)",
+    "r-kvstore": "Cloud database Tair (compatible with Redis) (R-KVStore)"
+}
+
 
 @click.command()
 @click.option(
     "--transport",
-    type=click.Choice(["stdio", "sse"]),
+    type=click.Choice(["stdio", "sse", "streamable-http"]),
     default="stdio",
     help="Transport type",
 )
@@ -21,12 +35,32 @@ logger = logging.getLogger(__name__)
     default=8000,
     help="Port number",
 )
-def main(transport: str, port: int):
+@click.option(
+    "--host",
+    type=str,
+    default="127.0.0.1",
+    help="Host",
+)
+@click.option(
+    "--services",
+    type=str,
+    default=None,
+    help="Comma-separated list of supported services, e.g., 'ecs,vpc,rds'",
+)
+def main(transport: str, port: int, host: str, services: str):
     # Create an MCP server
     mcp = FastMCP(
         name="alibaba-cloud-ops-mcp-server",
-        port=port
+        port=port,
+        host=host
     )
+
+    if services:
+        service_keys = [s.strip().lower() for s in services.split(",")]
+        service_list = [(key, SUPPORTED_SERVICES_MAP.get(key, key)) for key in service_keys]
+        set_custom_service_list(service_list)
+        for tool in common_api_tools.tools:
+            mcp.add_tool(tool)
     for tool in oos_tools.tools:
         mcp.add_tool(tool)
     for tool in cms_tools.tools:

alibaba_cloud_ops_mcp_server/tools/api_tools.py

@@ -2,6 +2,7 @@ import os
 from mcp.server.fastmcp import FastMCP, Context
 from pydantic import Field
 import logging
+import json
 
 import inspect
 import types
@@ -23,15 +24,50 @@ type_map = {
     'number': float
 }
 
+REGION_ENDPOINT_SERVICE = ['ecs', 'oos', 'vpc', 'slb']
+
+DOUBLE_ENDPOINT_SERVICE = {
+    'rds': ['cn-qingdao', 'cn-beijing', 'cn-hangzhou', 'cn-shanghai', 'cn-shenzhen', 'cn-heyuan', 'cn-guangzhou', 'cn-hongkong'],
+    'ess': ['cn-qingdao', 'cn-beijing', 'cn-hangzhou', 'cn-shanghai', 'cn-nanjing', 'cn-shenzhen'],
+    'ros': ['cn-qingdao'],
+    'dds': ['cn-qingdao', 'cn-beijing', 'cn-wulanchabu', 'cn-hangzhou', 'cn-shanghai', 'cn-shenzhen', 'cn-heyuan', 'cn-guangzhou'],
+    'r-kvstore': ['cn-qingdao', 'cn-beijing', 'cn-wulanchabu', 'cn-hangzhou', 'cn-shanghai', 'cn-shenzhen', 'cn-heyuan']
+}
+
+CENTRAL_ENDPOINTS_SERVICE = ['cbn']
+
+
+def _get_service_endpoint(service: str, region_id: str):
+    region_id = region_id.lower()
+    use_region_endpoint = service in REGION_ENDPOINT_SERVICE or (
+            service in DOUBLE_ENDPOINT_SERVICE and region_id in DOUBLE_ENDPOINT_SERVICE[service]
+    )
+
+    if use_region_endpoint:
+        return f'{service}.{region_id}.aliyuncs.com'
+    elif service in CENTRAL_ENDPOINTS_SERVICE or service in DOUBLE_ENDPOINT_SERVICE:
+        return f'{service}.aliyuncs.com'
+    else:
+        return f'{service}.{region_id}.aliyuncs.com'
+
 
 def create_client(service: str, region_id: str) -> OpenApiClient:
     config = create_config()
     if isinstance(service, str):
         service = service.lower()
-    config.endpoint = f'{service}.{region_id}.aliyuncs.com'
+    config.endpoint = _get_service_endpoint(service, region_id.lower())
     return OpenApiClient(config)
 
 
+# 类型为String的JSON数组参数
+ECS_LIST_PARAMETERS = {
+    'HpcClusterIds', 'DedicatedHostClusterIds', 'DedicatedHostIds', 
+    'InstanceIds', 'DeploymentSetIds', 'KeyPairNames', 'SecurityGroupIds', 
+    'diskIds', 'repeatWeekdays', 'timePoints', 'DiskIds', 'SnapshotLinkIds', 
+    'EipAddresses', 'PublicIpAddresses', 'PrivateIpAddresses'
+}
+
+
 def _tools_api_call(service: str, api: str, parameters: dict, ctx: Context):
     service = service.lower()
     api_meta, _ = ApiMetaClient.get_api_meta(service, api)
@@ -39,8 +75,16 @@ def _tools_api_call(service: str, api: str, parameters: dict, ctx: Context):
     method = 'POST' if api_meta.get('methods', [])[0] == 'post' else 'GET'
     path = api_meta.get('path', '/')
     style = ApiMetaClient.get_service_style(service)
+    
+    # 处理特殊参数格式
+    processed_parameters = parameters.copy()
+    if service == 'ecs':
+        for param_name, param_value in parameters.items():
+            if param_name in ECS_LIST_PARAMETERS and isinstance(param_value, list):
+                processed_parameters[param_name] = json.dumps(param_value)
+    
     req = open_api_models.OpenApiRequest(
-        query=OpenApiUtilClient.query(parameters)
+        query=OpenApiUtilClient.query(processed_parameters)
     )
     params = open_api_models.Params(
         action=api,
@@ -53,7 +97,7 @@ def _tools_api_call(service: str, api: str, parameters: dict, ctx: Context):
         req_body_type='formData',
         body_type='json'
     )
-    client = create_client(service, parameters.get('RegionId', 'cn-hangzhou'))
+    client = create_client(service, processed_parameters.get('RegionId', 'cn-hangzhou'))
     runtime = util_models.RuntimeOptions()
     return client.call_api(params, req, runtime)
 
@@ -75,9 +119,15 @@ def _create_function_schemas(service, api, api_meta):
         description = schema.get('description', '')
         example = schema.get('example', '')
         type_ = schema.get('type', '')
-        description = f'{description} 请注意，提供参数要严格按照参数的类型和参数示例的提示，如果提到参数为String，且为一个 JSON 数组字符串，应在数组内使用单引号包裹对应的参数以避免转义问题，并在最外侧用双引号包裹以确保其是字符串，否则可能会导致参数解析错误。参数类型: {type_},参数示例：{example}'
+        description = f'{description} 参数类型: {type_},参数示例：{example}'
         required = schema.get('required', False)
-        python_type = type_map.get(type_, str)
+        
+        # 只有在service为ecs时，才对特定参数进行特殊处理
+        if service.lower() == 'ecs' and name in ECS_LIST_PARAMETERS and type_ == 'string':
+            python_type = list
+        else:
+            python_type = type_map.get(type_, str)
+            
         field_info = (
             python_type,
             field(
@@ -90,14 +140,14 @@ def _create_function_schemas(service, api, api_meta):
         schemas[api]['RegionId'] = (
             str,
             field(
-                default=None,
+                default='cn-hangzhou',
                 metadata={'description': '地域ID', 'required': False}
             )
         )
     return schemas
 
 
-def _create_tool_function_with_signature(service: str, function_name: str, fields: dict, description: str):
+def _create_tool_function_with_signature(service: str, api: str, fields: dict, description: str):
     """
     Dynamically creates a lambda function with a custom signature based on the provided fields.
     """
@@ -121,14 +171,14 @@ def _create_tool_function_with_signature(service: str, function_name: str, field
         defaults[name] = field_default
 
     signature = inspect.Signature(parameters)
-
+    function_name = f'{service.upper()}_{api}'
     def func_code(*args, **kwargs):
         bound_args = signature.bind(*args, **kwargs)
         bound_args.apply_defaults()
 
         return _tools_api_call(
             service=service,
-            api=function_name,
+            api=api,
             parameters=bound_args.arguments,
             ctx=None
         )
@@ -154,7 +204,8 @@ def _create_and_decorate_tool(mcp: FastMCP, service: str, api: str):
     fields = _create_function_schemas(service, api, api_meta).get(api, {})
     description = api_meta.get('summary', '')
     dynamic_lambda = _create_tool_function_with_signature(service, api, fields, description)
-    decorated_function = mcp.tool(name=api)(dynamic_lambda)
+    function_name = f'{service.upper()}_{api}'
+    decorated_function = mcp.tool(name=function_name)(dynamic_lambda)
 
     return decorated_function
 

alibaba_cloud_ops_mcp_server/tools/cms_tools.py

@@ -36,7 +36,7 @@ def _get_cms_metric_data(region_id: str, instance_ids: List[str], metric_name: s
     return describe_metric_last_resp.body.datapoints
 
 @tools.append
-def GetCpuUsageData(
+def CMS_GetCpuUsageData(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
 ):
@@ -45,7 +45,7 @@ def GetCpuUsageData(
 
 
 @tools.append
-def GetCpuLoadavgData(
+def CMS_GetCpuLoadavgData(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
 ):
@@ -54,7 +54,7 @@ def GetCpuLoadavgData(
 
 
 @tools.append
-def GetCpuloadavg5mData(
+def CMS_GetCpuloadavg5mData(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
 ):
@@ -63,7 +63,7 @@ def GetCpuloadavg5mData(
     
 
 @tools.append
-def GetCpuloadavg15mData(
+def CMS_GetCpuloadavg15mData(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
 ):
@@ -71,7 +71,7 @@ def GetCpuloadavg15mData(
     return _get_cms_metric_data(RegionId, InstanceIds, 'load_15m')
 
 @tools.append
-def GetMemUsedData(
+def CMS_GetMemUsedData(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
 ):
@@ -80,7 +80,7 @@ def GetMemUsedData(
 
 
 @tools.append
-def GetMemUsageData(
+def CMS_GetMemUsageData(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
 ):
@@ -89,7 +89,7 @@ def GetMemUsageData(
 
 
 @tools.append
-def GetDiskUsageData(
+def CMS_GetDiskUsageData(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
 ):
@@ -98,7 +98,7 @@ def GetDiskUsageData(
 
 
 @tools.append
-def GetDiskTotalData(
+def CMS_GetDiskTotalData(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
 ):
@@ -107,7 +107,7 @@ def GetDiskTotalData(
 
 
 @tools.append
-def GetDiskUsedData(
+def CMS_GetDiskUsedData(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
 ):

alibaba_cloud_ops_mcp_server/tools/common_api_tools.py

@@ -0,0 +1,74 @@
+import logging
+import os
+from pydantic import Field
+from alibabacloud_tea_openapi import models as open_api_models
+from alibabacloud_tea_util import models as util_models
+from alibabacloud_tea_openapi.client import Client as OpenApiClient
+from alibabacloud_openapi_util.client import Client as OpenApiUtilClient
+from alibaba_cloud_ops_mcp_server.alibabacloud.api_meta_client import ApiMetaClient
+from alibaba_cloud_ops_mcp_server.alibabacloud.static import PROMPT_UNDERSTANDING
+from alibaba_cloud_ops_mcp_server.tools.api_tools import create_client, _tools_api_call
+
+END_STATUSES = ['Success', 'Failed', 'Cancelled']
+
+tools = []
+
+_CUSTOM_SERVICE_LIST = None
+
+logger = logging.getLogger(__name__)
+
+
+def set_custom_service_list(service_list):
+    global _CUSTOM_SERVICE_LIST
+    _CUSTOM_SERVICE_LIST = service_list
+
+
+@tools.append
+def PromptUnderstanding() -> str:
+    """
+    Always use this tool first to understand the user's query and convert it into suggestions from Alibaba Cloud experts.
+    """
+    global _CUSTOM_SERVICE_LIST
+
+    content = PROMPT_UNDERSTANDING
+    if _CUSTOM_SERVICE_LIST:
+        import re
+        pattern = r'Supported Services\s*:\s*\n(?:\s{3}- .+?\n)+'
+        replacement = f"Supported Services:\n   - " + "\n   - ".join([f"{k}: {v}" for k, v in _CUSTOM_SERVICE_LIST])
+        content = re.sub(pattern, replacement, content, flags=re.DOTALL)
+
+    return content
+
+
+@tools.append
+def ListAPIs(
+        service: str = Field(description='AlibabaCloud service code')
+):
+    """
+    Use PromptUnderstanding tool first to understand the user's query, Get the corresponding API list information through the service name to prepare for the subsequent selection of the appropriate API to call
+    """
+    return ApiMetaClient.get_apis_in_service(service)
+
+
+@tools.append
+def GetAPIInfo(
+        service: str = Field(description='AlibabaCloud service code'),
+        api: str = Field(description='AlibabaCloud api name'),
+):
+    """
+    Use PromptUnderstanding tool first to understand the user's query, After specifying the service name and API name, get the detailed API META of the corresponding API
+    """
+    data, version = ApiMetaClient.get_api_meta(service, api)
+    return data.get('parameters')
+
+
+@tools.append
+def CommonAPICaller(
+        service: str = Field(description='AlibabaCloud service code'),
+        api: str = Field(description='AlibabaCloud api name'),
+        parameters: dict = Field(description='AlibabaCloud ECS instance ID List', default={}),
+):
+    """
+    Use PromptUnderstanding tool first to understand the user's query, Perform the actual call by specifying the Service, API, and Parameters
+    """
+    return _tools_api_call(service, api, parameters, None)

alibaba_cloud_ops_mcp_server/tools/oos_tools.py

@@ -46,7 +46,7 @@ def _start_execution_sync(region_id: str, template_name: str, parameters: dict):
             return list_executions_resp.body
         time.sleep(1)
 @tools.append
-def RunCommand(
+def OOS_RunCommand(
      RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
      InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
      CommandType: str = Field(description='The type of command executed on the ECS instance, optional value：RunShellScript，RunPythonScript，RunPerlScript，RunBatScript，RunPowerShellScript', default='RunShellScript'),
@@ -73,7 +73,7 @@ def RunCommand(
     
 
 @tools.append
-def StartInstances(
+def OOS_StartInstances(
      RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
      InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
 ):
@@ -92,7 +92,7 @@ def StartInstances(
 
 
 @tools.append
-def StopInstances(
+def OOS_StopInstances(
      RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
      InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
      ForeceStop: bool = Field(description='Is forced shutdown required', default=False),
@@ -113,7 +113,7 @@ def StopInstances(
 
 
 @tools.append
-def RebootInstances(
+def OOS_RebootInstances(
      RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
      InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
      ForeceStop: bool = Field(description='Is forced shutdown required', default=False),
@@ -134,7 +134,7 @@ def RebootInstances(
 
 
 @tools.append
-def RunInstances(
+def OOS_RunInstances(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     ImageId: str = Field(description='Image ID'),
     InstanceType: str = Field(description='Instance Type'),
@@ -157,7 +157,7 @@ def RunInstances(
 
 
 @tools.append
-def ResetPassword(
+def OOS_ResetPassword(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
     Password: str = Field(description='The password of the ECS instance must be 8-30 characters and must contain only the following characters: lowercase letters, uppercase letters, numbers, and special characters only.（）~！@#$%^&*-_+=（40：<>，？/'),
@@ -176,7 +176,7 @@ def ResetPassword(
     return _start_execution_sync(region_id=RegionId, template_name='ACS-ECS-BulkyResetPassword', parameters=parameters)
 
 @tools.append
-def ReplaceSystemDisk(
+def OOS_ReplaceSystemDisk(
         RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
         InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
         ImageId: str = Field(description='Image ID')
@@ -196,7 +196,7 @@ def ReplaceSystemDisk(
 
 
 @tools.append
-def StartRDSInstances(
+def OOS_StartRDSInstances(
         RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
         InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
 ):
@@ -215,7 +215,7 @@ def StartRDSInstances(
 
 
 @tools.append
-def StopRDSInstances(
+def OOS_StopRDSInstances(
         RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
         InstanceIds: List[str] = Field(description='AlibabaCloud RDS instance ID List')
 ):
@@ -234,7 +234,7 @@ def StopRDSInstances(
 
 
 @tools.append
-def RebootRDSInstances(
+def OOS_RebootRDSInstances(
         RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
         InstanceIds: List[str] = Field(description='AlibabaCloud RDS instance ID List')
 ):

alibaba_cloud_ops_mcp_server/tools/oss_tools.py

@@ -35,7 +35,7 @@ def create_client(region_id: str) -> oss.Client:
 
 
 @tools.append
-def ListBuckets(
+def OSS_ListBuckets(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     Prefix: str = Field(description='AlibabaCloud OSS Bucket Name prefix', default=None)
 ):
@@ -50,7 +50,7 @@ def ListBuckets(
 
 
 @tools.append
-def ListObjects(
+def OSS_ListObjects(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     BucketName: str = Field(description='AlibabaCloud OSS Bucket Name'),
     Prefix: str = Field(description='AlibabaCloud OSS Bucket Name prefix', default=None)
@@ -71,7 +71,7 @@ def ListObjects(
 
 
 @tools.append
-def PutBucket(
+def OSS_PutBucket(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     BucketName: str = Field(description='AlibabaCloud OSS Bucket Name'),
     StorageClass: str = Field(description='The Storage Type of AlibabaCloud OSS Bucket, The value range is as follows: '
@@ -99,7 +99,7 @@ def PutBucket(
 
 
 @tools.append
-def DeleteBucket(
+def OSS_DeleteBucket(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
     BucketName: str = Field(description='AlibabaCloud OSS Bucket Name')
 ):

{alibaba_cloud_ops_mcp_server-0.8.5.dist-info → alibaba_cloud_ops_mcp_server-0.9.0.dist-info}/METADATA

@@ -1,16 +1,17 @@
 Metadata-Version: 2.4
 Name: alibaba-cloud-ops-mcp-server
-Version: 0.8.5
+Version: 0.9.0
 Summary: A MCP server for Alibaba Cloud
 Author-email: Zheng Dayu <dayu.zdy@alibaba-inc.com>
 License-File: LICENSE
 Requires-Python: >=3.10
 Requires-Dist: alibabacloud-cms20190101>=3.1.4
+Requires-Dist: alibabacloud-credentials>=1.0.0
 Requires-Dist: alibabacloud-ecs20140526>=6.1.0
 Requires-Dist: alibabacloud-oos20190601>=3.4.1
 Requires-Dist: alibabacloud-oss-v2>=1.1.0
 Requires-Dist: click>=8.1.8
-Requires-Dist: mcp[cli]>=1.6.0
+Requires-Dist: mcp[cli]>=1.9.0
 Description-Content-Type: text/markdown
 
 # Alibaba Cloud Ops MCP Server
@@ -54,19 +55,24 @@ To use `alibaba-cloud-ops-mcp-server` MCP Server with any other MCP Client, you
 }
 ```
 
+[For detailed parameter description, see MCP startup parameter document](./README_mcp_args.md)
+
 ## MCP Maketplace Integration
 
 * [Cline](https://cline.bot/mcp-marketplace)
+* [Cursor](https://docs.cursor.com/tools) [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=alibaba-cloud-ops-mcp-server&config=eyJ0aW1lb3V0Ijo2MDAsImNvbW1hbmQiOiJ1dnggYWxpYmFiYS1jbG91ZC1vcHMtbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX0lEIjoiWW91ciBBY2Nlc3MgS2V5IElEIiwiQUxJQkFCQV9DTE9VRF9BQ0NFU1NfS0VZX1NFQ1JFVCI6IllvdXIgQWNjZXNzIEtleSBTRUNSRVQifX0%3D)
 * [ModelScope](https://www.modelscope.cn/mcp/servers/@aliyun/alibaba-cloud-ops-mcp-server?lang=en_US)
 * [Lingma](https://lingma.aliyun.com/)
 * [Smithery AI](https://smithery.ai/server/@aliyun/alibaba-cloud-ops-mcp-server)
 * [FC-Function AI](https://cap.console.aliyun.com/template-detail?template=237)
+* [Alibaba Cloud Model Studio](https://bailian.console.aliyun.com/?tab=mcp#/mcp-market/detail/alibaba-cloud-ops)
 
 ## Know More
 
-* [Alibaba Cloud MCP Server is ready to use out of the box!！](https://developer.aliyun.com/article/1661348)
-* [Setup Alibaba Cloud MCP Server on Bailian](https://developer.aliyun.com/article/1662120)
+* [Alibaba Cloud Ops MCP Server is ready to use out of the box!！](https://developer.aliyun.com/article/1661348)
+* [Setup Alibaba Cloud Ops MCP Server on Bailian](https://developer.aliyun.com/article/1662120)
 * [Build your own Alibaba Cloud OpenAPI MCP Server with 10 lines of code](https://developer.aliyun.com/article/1662202)
+* [Alibaba Cloud Ops MCP Server is officially available on the Alibaba Cloud Model Studio Platform MCP Marketplace](https://developer.aliyun.com/article/1665019)
 
 ## Tools
 

alibaba_cloud_ops_mcp_server-0.9.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+alibaba_cloud_ops_mcp_server/__init__.py,sha256=BaluUNyRz8Qw-X7Y0ywDezwbkqiSvWlSYn2452XeGcA,213
+alibaba_cloud_ops_mcp_server/config.py,sha256=Nq6AT8bqSVa6zu9xjInaSjFcxA-GC7MLlCsV1q53yO0,514
+alibaba_cloud_ops_mcp_server/server.py,sha256=tvRVQi1d7oPc-OsBHf6Za1Qht_bhNm2nf4B2aQ84Fyw,2246
+alibaba_cloud_ops_mcp_server/alibabacloud/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+alibaba_cloud_ops_mcp_server/alibabacloud/api_meta_client.py,sha256=t2TSc0Gzcy_uEcaCgiHHuLoMiEGu3-NCtYmwYjyPWsY,7973
+alibaba_cloud_ops_mcp_server/alibabacloud/exception.py,sha256=7PdhgqgXEGrTPL1cj98h9EH-RrM6-2TT89PDtcmlpmU,1230
+alibaba_cloud_ops_mcp_server/alibabacloud/utils.py,sha256=jWQtP59P4ejh7N6xiYSDq1WgCd3Les0aSZr2pLGzkls,299
+alibaba_cloud_ops_mcp_server/alibabacloud/static/PROMPT_UNDERSTANDING.md,sha256=494HcCQQCc_iqDrRKhk7eWXB4I0dMtqCseT78KphDHg,3553
+alibaba_cloud_ops_mcp_server/alibabacloud/static/__init__.py,sha256=wJrYamaIb7e_kA4ILZpdP1f1TUUTXMGqEhA4IbSZ2Ts,230
+alibaba_cloud_ops_mcp_server/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+alibaba_cloud_ops_mcp_server/tools/api_tools.py,sha256=G3IsVOuvOGFupteJmESJowlbGGj2po2uJpcx53gzvRA,7702
+alibaba_cloud_ops_mcp_server/tools/cms_tools.py,sha256=GFSBDTddvQ7M9fDGm69jvH6Yt4nui5uOVjwD61CZKT4,4191
+alibaba_cloud_ops_mcp_server/tools/common_api_tools.py,sha256=ccQAWqS1I9F-fdOdjLcXN-dIhNqSbZV8T5ODuGXlfXM,2711
+alibaba_cloud_ops_mcp_server/tools/oos_tools.py,sha256=l228yl_SGg_rNdrBSDeqWYI8ZE1XUAHhsPLArvfE4A8,10116
+alibaba_cloud_ops_mcp_server/tools/oss_tools.py,sha256=c7D1fAjFBqHl0oMy0O6i7onoXeAN9cpdBdLtXKrxVQE,4615
+alibaba_cloud_ops_mcp_server-0.9.0.dist-info/METADATA,sha256=uDR__noYnkGhBgvSiLicUYGUAdUOwshyTKlCz5WNenM,5966
+alibaba_cloud_ops_mcp_server-0.9.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+alibaba_cloud_ops_mcp_server-0.9.0.dist-info/entry_points.txt,sha256=ESGAWXKEp184forhs7VzTD4P1AUdZz6vCW6hRUKITGw,83
+alibaba_cloud_ops_mcp_server-0.9.0.dist-info/licenses/LICENSE,sha256=gQgVkp2ttRCjodiPpXZZR-d7JnrYIYNiHk1YDUYgpa4,11331
+alibaba_cloud_ops_mcp_server-0.9.0.dist-info/RECORD,,

alibaba_cloud_ops_mcp_server-0.8.5.dist-info/RECORD

@@ -1,17 +0,0 @@
-alibaba_cloud_ops_mcp_server/__init__.py,sha256=BaluUNyRz8Qw-X7Y0ywDezwbkqiSvWlSYn2452XeGcA,213
-alibaba_cloud_ops_mcp_server/config.py,sha256=Nq6AT8bqSVa6zu9xjInaSjFcxA-GC7MLlCsV1q53yO0,514
-alibaba_cloud_ops_mcp_server/server.py,sha256=23NqZsE8JFQm9xffK-w2aScRXAZNnhgLs1wPG9fzHyI,1032
-alibaba_cloud_ops_mcp_server/alibabacloud/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-alibaba_cloud_ops_mcp_server/alibabacloud/api_meta_client.py,sha256=inOmW1no1YsR6_ezOZfgJtzGKo5nRTDufkf2qUTuNOs,7605
-alibaba_cloud_ops_mcp_server/alibabacloud/exception.py,sha256=7PdhgqgXEGrTPL1cj98h9EH-RrM6-2TT89PDtcmlpmU,1230
-alibaba_cloud_ops_mcp_server/alibabacloud/utils.py,sha256=jWQtP59P4ejh7N6xiYSDq1WgCd3Les0aSZr2pLGzkls,299
-alibaba_cloud_ops_mcp_server/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-alibaba_cloud_ops_mcp_server/tools/api_tools.py,sha256=lydogpHEYgqzLAgUP4szBy-67z7lWXiqwUaTvt_IQVM,5807
-alibaba_cloud_ops_mcp_server/tools/cms_tools.py,sha256=t70H7MnYo0cuIY00_6V3cGz2btSRtJFm8qW8WWwzyCc,4155
-alibaba_cloud_ops_mcp_server/tools/oos_tools.py,sha256=-e7ikaf708vAueOUFoWp3xMbpaj6JUGaB1KbK-YniV8,10076
-alibaba_cloud_ops_mcp_server/tools/oss_tools.py,sha256=IJDcs4BvPgF5A85oBZJ5xrJDSim_fCzRaxnCHjd0hvw,4599
-alibaba_cloud_ops_mcp_server-0.8.5.dist-info/METADATA,sha256=OXzSM42BSBX5eh0BjtYhO7fCq9V0pbhLSR52WyS7BFE,5100
-alibaba_cloud_ops_mcp_server-0.8.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-alibaba_cloud_ops_mcp_server-0.8.5.dist-info/entry_points.txt,sha256=ESGAWXKEp184forhs7VzTD4P1AUdZz6vCW6hRUKITGw,83
-alibaba_cloud_ops_mcp_server-0.8.5.dist-info/licenses/LICENSE,sha256=gQgVkp2ttRCjodiPpXZZR-d7JnrYIYNiHk1YDUYgpa4,11331
-alibaba_cloud_ops_mcp_server-0.8.5.dist-info/RECORD,,