alibaba-cloud-ops-mcp-server 0.7.3__py3-none-any.whl → 0.7.5__py3-none-any.whl

alibaba_cloud_ops_mcp_server/config.py

@@ -18,7 +18,10 @@ config = {
     'Vpc': [
         'DescribeVpcs',
         'DescribeVSwitches'
-    ]
+    ],
+    'rds': [
+        'DescribeDBInstances'
+    ],
 }
 
 

alibaba_cloud_ops_mcp_server/oos_tools.py

@@ -50,8 +50,8 @@ def _start_execution_sync(region_id: str, template_name: str, parameters: dict):
 def 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='ECS实例上执行的命令类型，可选值：RunShellScript，RunPythonScript，RunPerlScript，RunBatScript，RunPowerShellScript', default='RunShellScript'),
-     Command: str = Field(description='ECS实例上执行的命令内容'),
+     CommandType: str = Field(description='The type of command executed on the ECS instance, optional value：RunShellScript，RunPythonScript，RunPerlScript，RunBatScript，RunPowerShellScript', default='RunShellScript'),
+     Command: str = Field(description='Content of the command executed on the ECS instance'),
 ):
     """批量在多台ECS实例上运行云助手命令，适用于需要同时管理多台ECS实例的场景，如应用程序管理和资源标记操作等。"""
     
@@ -96,7 +96,7 @@ def StartInstances(
 def 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='是否强制关机', default=False),
+     ForeceStop: bool = Field(description='Is forced shutdown required', default=False),
 ):
     """批量停止ECS实例，适用于需要同时管理和停止多台ECS实例的场景。"""
     
@@ -117,7 +117,7 @@ def StopInstances(
 def 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='是否强制关机', default=False),
+     ForeceStop: bool = Field(description='Is forced shutdown required', default=False),
 ):
     """批量重启ECS实例，适用于需要同时管理和重启多台ECS实例的场景。"""
     
@@ -137,12 +137,12 @@ def RebootInstances(
 @tools.append
 def RunInstances(
     RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
-    ImageId: str = Field(description='镜像ID'),
-    InstanceType: str = Field(description='实例规格'),
-    SecurityGroupId: str = Field(description='安全组ID'),
-    VSwitchId: str = Field(description='交换机ID'),
-    Amount: int = Field(description='创建数量', default=1),
-    InstanceName: str = Field(description='实例名称', default=''),
+    ImageId: str = Field(description='Image ID'),
+    InstanceType: str = Field(description='Instance Type'),
+    SecurityGroupId: str = Field(description='SecurityGroup ID'),
+    VSwitchId: str = Field(description='VSwitch ID'),
+    Amount: int = Field(description='Number of ECS instances', default=1),
+    InstanceName: str = Field(description='Instance Name', default=''),
 ):
     """批量创建ECS实例，适用于需要同时创建多台ECS实例的场景，例如应用部署和高可用性场景。"""
 
@@ -161,7 +161,7 @@ def RunInstances(
 def 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='ECS实例的密码,8-30个字符且只能包含以下限制条件中的字符：小写字母，大写字母，数字，只可包含特殊字符（）~！@#$%^&*-_+=（40：<>，？/'),
+    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：<>，？/'),
 ):
     """批量修改ECS实例的密码，请注意，本操作将会重启ECS实例"""
     parameters = {
@@ -180,7 +180,7 @@ def ResetPassword(
 def 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='镜像ID')
+        ImageId: str = Field(description='Image ID')
 ):
     """批量替换ECS实例的系统盘，更换操作系统"""
     parameters = {
@@ -194,3 +194,61 @@ def ReplaceSystemDisk(
         'imageId': ImageId
     }
     return _start_execution_sync(region_id=RegionId, template_name='ACS-ECS-BulkyReplaceSystemDisk', parameters=parameters)
+
+
+@tools.append
+def StartRDSInstances(
+        RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
+        InstanceIds: List[str] = Field(description='AlibabaCloud ECS instance ID List'),
+):
+    """批量启动RDS实例，适用于需要同时管理和启动多台RDS实例的场景，例如应用部署和高可用性场景。"""
+
+    parameters = {
+        'regionId': RegionId,
+        'resourceType': 'ALIYUN::RDS::Instance',
+        'targets': {
+            'ResourceIds': InstanceIds,
+            'RegionId': RegionId,
+            'Type': 'ResourceIds'
+        }
+    }
+    return _start_execution_sync(region_id=RegionId, template_name='ACS-RDS-BulkyStartInstances', parameters=parameters)
+
+
+@tools.append
+def StopRDSInstances(
+        RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
+        InstanceIds: List[str] = Field(description='AlibabaCloud RDS instance ID List')
+):
+    """批量停止RDS实例，适用于需要同时管理和停止多台RDS实例的场景。"""
+
+    parameters = {
+        'regionId': RegionId,
+        'resourceType': 'ALIYUN::RDS::Instance',
+        'targets': {
+            'ResourceIds': InstanceIds,
+            'RegionId': RegionId,
+            'Type': 'ResourceIds'
+        }
+    }
+    return _start_execution_sync(region_id=RegionId, template_name='ACS-RDS-BulkyStopInstances', parameters=parameters)
+
+
+@tools.append
+def RebootRDSInstances(
+        RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
+        InstanceIds: List[str] = Field(description='AlibabaCloud RDS instance ID List')
+):
+    """批量重启RDS实例，适用于需要同时管理和重启多台RDS实例的场景。"""
+
+    parameters = {
+        'regionId': RegionId,
+        'resourceType': 'ALIYUN::RDS::Instance',
+        'targets': {
+            'ResourceIds': InstanceIds,
+            'RegionId': RegionId,
+            'Type': 'ResourceIds'
+        }
+    }
+    return _start_execution_sync(region_id=RegionId, template_name='ACS-RDS-BulkyRestartInstances',
+                                 parameters=parameters)

alibaba_cloud_ops_mcp_server/oss_tools.py

@@ -0,0 +1,107 @@
+# oss_tools.py
+import os
+import alibabacloud_oss_v2 as oss
+
+from pydantic import Field
+from alibabacloud_oss_v2 import Credentials
+from alibabacloud_oss_v2.credentials import EnvironmentVariableCredentialsProvider
+
+
+tools = []
+
+
+class CredentialsProvider(EnvironmentVariableCredentialsProvider):
+    def __init__(self) -> None:
+        super().__init__()
+        access_key_id = os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID']
+        access_key_secret = os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
+        session_token = os.getenv('ALIBABA_CLOUD_SESSION_TOKEN', None)
+
+        self._credentials = Credentials(
+            access_key_id, access_key_secret, session_token)
+
+    def get_credentials(self) -> Credentials:
+        return self._credentials
+
+
+def create_client(region_id: str) -> oss.Client:
+    credentials_provider = CredentialsProvider()
+    cfg = oss.config.load_default()
+    cfg.credentials_provider = credentials_provider
+    cfg.region = region_id
+    return oss.Client(cfg)
+
+
+@tools.append
+def ListBuckets(
+    RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
+    Prefix: str = Field(description='AlibabaCloud OSS Bucket Name prefix', default=None)
+):
+    """列出指定区域的所有OSS存储空间。"""
+    client = create_client(region_id=RegionId)
+    paginator = client.list_buckets_paginator()
+    results = []
+    for page in paginator.iter_page(oss.ListBucketsRequest(prefix=Prefix)):
+        for bucket in page.buckets:
+            results.append(bucket.__str__())
+    return results
+
+
+@tools.append
+def 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)
+):
+    """获取指定OSS存储空间中的所有文件信息。"""
+    if not BucketName:
+        raise ValueError("Bucket name is required")
+    client = create_client(region_id=RegionId)
+    paginator = client.list_objects_v2_paginator()
+    results = []
+    for page in paginator.iter_page(oss.ListObjectsV2Request(
+            bucket=BucketName,
+            prefix=Prefix
+        )):
+        for object in page.contents:
+            results.append(object.__str__())
+    return results
+
+
+@tools.append
+def 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: '
+                                          'Standard (default): standard storage, '
+                                          'IA: infrequent access, Archive: archive storage, '
+                                          'ColdArchive: cold archive storage, '
+                                          'DeepColdArchive: deep cold archive storage', default='Standard'),
+    DataRedundancyType: str = Field(description='The data disaster recovery type of AlibabaCloud OSS Bucket, '
+                                                'LRS (default): Locally redundant LRS, which stores your data '
+                                                'redundantly on different storage devices in the same availability zone. '
+                                                'ZRS: Intra-city redundant ZRS, which uses a multi-availability zone '
+                                                '(AZ) mechanism to store your data redundantly in three availability '
+                                                'zones in the same region.', default='LRS')
+):
+    """创建一个新的OSS存储空间。"""
+    client = create_client(region_id=RegionId)
+    result = client.put_bucket(oss.PutBucketRequest(
+        bucket=BucketName,
+        create_bucket_configuration=oss.CreateBucketConfiguration(
+            storage_class=StorageClass,
+            data_redundancy_type=DataRedundancyType
+        )
+    ))
+    return result.__str__()
+
+
+@tools.append
+def DeleteBucket(
+    RegionId: str = Field(description='AlibabaCloud region ID', default='cn-hangzhou'),
+    BucketName: str = Field(description='AlibabaCloud OSS Bucket Name')
+):
+    """删除指定的OSS存储空间。"""
+    client = create_client(region_id=RegionId)
+    result = client.delete_bucket(oss.DeleteBucketRequest(bucket=BucketName))
+    return result.__str__()

alibaba_cloud_ops_mcp_server/server.py

@@ -17,6 +17,7 @@ from alibaba_cloud_ops_mcp_server.config import config
 
 from alibaba_cloud_ops_mcp_server import oos_tools
 from alibaba_cloud_ops_mcp_server import cms_tools
+from alibaba_cloud_ops_mcp_server import oss_tools
 
 logger = logging.getLogger(__name__)
 
@@ -184,6 +185,8 @@ def main(transport: str):
         mcp.add_tool(tool)
     for tool in cms_tools.tools:
         mcp.add_tool(tool)
+    for tool in oss_tools.tools:
+        mcp.add_tool(tool)
     for service_code, apis in config.items():
         for api_name in apis:
             create_and_decorate_tool(mcp, service_code, api_name)

{alibaba_cloud_ops_mcp_server-0.7.3.dist-info → alibaba_cloud_ops_mcp_server-0.7.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alibaba-cloud-ops-mcp-server
-Version: 0.7.3
+Version: 0.7.5
 Summary: A MCP server for Alibaba Cloud
 Author-email: Zheng Dayu <dayu.zdy@alibaba-inc.com>
 License-File: LICENSE
@@ -8,6 +8,7 @@ Requires-Python: >=3.11
 Requires-Dist: alibabacloud-cms20190101>=3.1.4
 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
 Description-Content-Type: text/markdown
@@ -23,29 +24,17 @@ Install [uv](https://github.com/astral-sh/uv)
 curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
 
-## Start
-
-Start from local development environment
-
-```bash
-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
-```
-
-Start from package
-
-```bash
-ALIBABA_CLOUD_ACCESS_KEY_ID=<Your AccessKeyId> ALIBABA_CLOUD_ACCESS_KEY_SECRET=<Your AccessKeySecret> uvx alibaba-cloud-ops-mcp-server@latest --transport sse
-```
-
 ## Configuration
 
 Use [VS Code](https://code.visualstudio.com/) + [Cline](https://cline.bot/) to config MCP Server.
 
 To use `alibaba-cloud-ops-mcp-server` MCP Server with any other MCP Client, you can manually add this configuration and restart for changes to take effect:
+
 ```json
 {
   "mcpServers": {
     "alibaba-cloud-ops-mcp-server": {
+      "timeout": 600,
       "command": "uvx",
       "args": [
         "alibaba-cloud-ops-mcp-server@latest"
@@ -79,6 +68,14 @@ To use `alibaba-cloud-ops-mcp-server` MCP Server with any other MCP Client, you
 | | ReplaceSystemDisk | Replace Operating System | OOS | Done |
 | VPC | DescribeVpcs | View VPCs | API | Done |
 | | DescribeVSwitches | View VSwitches | API | Done |
+| RDS | DescribeDBInstances | List RDS Instances | API | Done |
+|  | StartDBInstances | Start the RDS instance | OOS | Done |
+|  | StopDBInstances | Stop the RDS instance | OOS | Done |
+|  | RestartDBInstances | Restart the RDS instance | OOS | Done |
+| OSS | ListBuckets | List Bucket | API | Done |
+|  | PutBucket | Create Bucket | API | Done |
+|  | DeleteBucket | Delete Bucket | API | Done |
+|  | ListObjects | View object information in the bucket | 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 |

alibaba_cloud_ops_mcp_server-0.7.5.dist-info/RECORD

@@ -0,0 +1,12 @@
+alibaba_cloud_ops_mcp_server/__init__.py,sha256=BaluUNyRz8Qw-X7Y0ywDezwbkqiSvWlSYn2452XeGcA,213
+alibaba_cloud_ops_mcp_server/api_meta_client.py,sha256=pxJztmkmcqqI3djECziAIMc3ZxsS8crqSc6AbneOX2I,7315
+alibaba_cloud_ops_mcp_server/cms_tools.py,sha256=5IhPtkHSwqLsy7D3lGznovQ94e-XBy6HBE7qLDMoYaQ,4464
+alibaba_cloud_ops_mcp_server/config.py,sha256=Nq6AT8bqSVa6zu9xjInaSjFcxA-GC7MLlCsV1q53yO0,514
+alibaba_cloud_ops_mcp_server/oos_tools.py,sha256=NDu18_R3SqB-Fv1SpnljV0b2Py6G9HXcoqvbV0MWL7Y,10105
+alibaba_cloud_ops_mcp_server/oss_tools.py,sha256=6d_vacAJllwkr74bsWgle8yMzqb_Xr1CPAIr_htFP-I,4451
+alibaba_cloud_ops_mcp_server/server.py,sha256=9qk122yEAZgzJ9iBTBns90McguU4pQFIgjOPD1CzH8c,6723
+alibaba_cloud_ops_mcp_server-0.7.5.dist-info/METADATA,sha256=k0CwST7Lkzm367bqEq1UlMpT8HzUyuvGHwftQv3kASI,3450
+alibaba_cloud_ops_mcp_server-0.7.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+alibaba_cloud_ops_mcp_server-0.7.5.dist-info/entry_points.txt,sha256=ESGAWXKEp184forhs7VzTD4P1AUdZz6vCW6hRUKITGw,83
+alibaba_cloud_ops_mcp_server-0.7.5.dist-info/licenses/LICENSE,sha256=gQgVkp2ttRCjodiPpXZZR-d7JnrYIYNiHk1YDUYgpa4,11331
+alibaba_cloud_ops_mcp_server-0.7.5.dist-info/RECORD,,

alibaba_cloud_ops_mcp_server-0.7.3.dist-info/RECORD

@@ -1,11 +0,0 @@
-alibaba_cloud_ops_mcp_server/__init__.py,sha256=BaluUNyRz8Qw-X7Y0ywDezwbkqiSvWlSYn2452XeGcA,213
-alibaba_cloud_ops_mcp_server/api_meta_client.py,sha256=pxJztmkmcqqI3djECziAIMc3ZxsS8crqSc6AbneOX2I,7315
-alibaba_cloud_ops_mcp_server/cms_tools.py,sha256=5IhPtkHSwqLsy7D3lGznovQ94e-XBy6HBE7qLDMoYaQ,4464
-alibaba_cloud_ops_mcp_server/config.py,sha256=MJRa5MLJgftSBitrbzTX8fPAV3-7_7FVxNqPvQyJiac,463
-alibaba_cloud_ops_mcp_server/oos_tools.py,sha256=zXniXIPjTKYYMaP2oS9KtuSAWeLixeGhjqIMNgR4Hqg,7864
-alibaba_cloud_ops_mcp_server/server.py,sha256=MCXk-nVDEuSuTO9E3duRa_r77ALz0KoJzQI94eHCZVw,6612
-alibaba_cloud_ops_mcp_server-0.7.3.dist-info/METADATA,sha256=Jj6menkyRV4-faFtwkDRGrdBVoB3HF-5_CPSqxm52w4,3341
-alibaba_cloud_ops_mcp_server-0.7.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-alibaba_cloud_ops_mcp_server-0.7.3.dist-info/entry_points.txt,sha256=ESGAWXKEp184forhs7VzTD4P1AUdZz6vCW6hRUKITGw,83
-alibaba_cloud_ops_mcp_server-0.7.3.dist-info/licenses/LICENSE,sha256=gQgVkp2ttRCjodiPpXZZR-d7JnrYIYNiHk1YDUYgpa4,11331
-alibaba_cloud_ops_mcp_server-0.7.3.dist-info/RECORD,,