Merge branch yinuo/mcp_2 into master

Title: to #65849001 SDK版本号

to #65849001 SDK版本号
Link: https://code.alibaba-inc.com/idb/alibabacloud-dms-mcp-server/codereview/21531356

Author: tianzhen.wtz

pyproject.toml

@@ -8,7 +8,7 @@ authors = [
 ]
 requires-python = ">=3.12"
 dependencies = [
-    "alibabacloud-dms-enterprise20181101>=1.71.0",
+    "alibabacloud-dms-enterprise20181101>=1.72.0",
     "alibabacloud-tea-openapi==0.4.0rc3",
     "httpx>=0.28.1",
     "mcp[cli]>=1.6.0",

src/alibabacloud_dms_mcp_server/server.py

@@ -28,10 +28,26 @@ def create_client() -> dms_enterprise20181101Client:
 
 @mcp.tool(name="addInstance",
           description="""
-
+          Add an instance to DMS. If the instance already exists, it will return the existing instance information.
+          Parameters:
+            db_user (str): The username used to connect to the database.
+            db_password (str): The password used to connect to the database.
+            instance_resource_id (str, optional): The resource id of the instance, typically assigned by the cloud provider.
+            host (str, optional): The hostname of the database instance.
+            port (str, optional): The connection port number.
+            region (str, optional): The region where the instance is located (e.g., "cn-hangzhou").
+            Returns:
+                Dict[str, Any]: A dictionary containing instance details with these keys:
+                    - instance_id: Unique instance identifier in DMS.
+                    - host: The hostname of the database instance.
+                    - port: The connection port number.
             """)
-async def addInstance(db_user: str, db_password: str, instance_resource_id: Optional[str] = None,
-                      host: Optional[str] = None, port: Optional[str] = None, region: Optional[str] = None) -> Dict[str, Any]:
+async def addInstance(db_user: str,
+                      db_password: str,
+                      instance_resource_id: Optional[str] = None,
+                      host: Optional[str] = None,
+                      port: Optional[str] = None,
+                      region: Optional[str] = None) -> Dict[str, Any]:
     if not db_user or not isinstance(db_user, str):
         logging.error("Invalid db_user parameter: %s", db_user)
         return "db_user must be a non-empty string"
@@ -69,8 +85,8 @@ async def addInstance(db_user: str, db_password: str, instance_resource_id: Opti
           description="""
           Retrieve detailed instance information from DMS.     
           Parameters:
-            host (str): The hostname or IP address of the database instance
-            port (int): Connection port number (valid range: 1-65535)
+            host (str): The hostname of the database instance.
+            port (str): The connection port number.
             sid (Optional[str]): Required for Oracle like databases. Defaults to None.
             Returns:
                 Dict[str, Any]: A dictionary containing instance details with these keys:
@@ -79,7 +95,9 @@ async def addInstance(db_user: str, db_password: str, instance_resource_id: Opti
                     - InstanceType: Database Engine type
                     - InstanceAlias: Instance alias in DMS
             """)
-async def getInstance(host: str, port: str, sid: Optional[str] = None) -> Dict[str, Any]:
+async def getInstance(host: str,
+                      port: str,
+                      sid: Optional[str] = None) -> Dict[str, Any]:
     """
           Retrieve detailed instance information from DMS.
           Parameters:
@@ -344,7 +362,7 @@ async def getMetaTableDetailInfo(table_guid: str) -> Dict[str, Any]:
           description="""
              Execute SQL script against a database in DMS and return structured results.
           Parameters:
-            database_id (int): Required DMS databaseId. Obtained via getDatabase tool.
+            database_id (str): Required DMS databaseId. Obtained via getDatabase tool.
             script (str): SQL script to execute.
           Returns:
             Dict[str, Any] containing: