Merge branch feat/env_database into master

Title: to #65849001 Update README

to #65849001 Update README
Link: https://code.alibaba-inc.com/idb/alibabacloud-dms-mcp-server/codereview/21901269

Author: tianzhen.wtz

README.md

@@ -41,6 +41,12 @@ DMS MCP Server currently supports two usage modes.
 #### Scenario Example:  
 You are a company DBA who needs to manage and access various types of database instances (e.g., MySQL, Oracle, PostgreSQL) in production, test, and development environments. With DMS MCP Server, you can achieve unified access and centralized management of these heterogeneous databases.  
 
+**Typical Question Examples:**  
+- Get a list of all databases named `test`.  
+- Retrieve details of the `test_db` database from the `myHost:myPort` instance.  
+- What tables are in the `test_db` database?  
+- Use a tool to query data from the `test_db` database and answer: "What is today's user traffic?"
+
 ### Mode Two: Single Database Mode  
 - Directly specify the target database by configuring the `CONNECTION_STRING` parameter in the server (format: `dbName@host:port`).  
 - Suitable for scenarios that focus on accessing a single database.  
@@ -51,6 +57,12 @@ CONNECTION_STRING = mydb@192.168.1.100:3306
 ```
 Afterward, every time the service starts, the DMS MCP Server will directly access this specified database without needing to switch instances.
 
+**Typical Question Examples:**  
+- What tables do I have?  
+- Show the field structure of the `test_table` table.  
+- Retrieve the first 20 rows from the `test_table` table.  
+- Use a tool to answer: "What is today's user traffic?"
+
 ---
 ## Tool List  
 | Tool Name           | Description                                  | Applicable Mode                |

doc/README-zh-cn.md

@@ -17,7 +17,7 @@
 ---
 
 ## 核心特性
-为AI提供统一的**数据接入层**与**元数据访问层**，通过标准化接口解决：  
+为大模型提供统一的**数据接入层**与**元数据访问层**，通过标准化接口解决：  
 - 数据源碎片化导致的MCP Server维护成本  
 - 异构协议间的兼容性问题  
 - 账号权限不受控、操作无审计带来的安全问题  
@@ -39,6 +39,13 @@ DMS MCP Server 现在支持两种使用模式。
 #### 场景示例：
 你是公司的DBA，需要在生产、测试和开发等多个环境中管理和访问 MySQL、Oracle 和 PostgreSQL 等多种数据库实例。通过DMS MCP Server，可以实现对这些异构数据库的统一接入与集中管理。
 
+**典型提问示例：**  
+- 获取所有名称为test的数据库列表
+- 获取 myHost:myPort 实例中 test_db 数据库的详细信息。
+- test_db 数据库下有哪些表？ 
+- 使用工具， 查询test_db 库的数据，回答“今天的用户访问量是多少？”
+
+
 ### 模式二：单数据库模式
 - 通过在SERVER中配置 CONNECTION_STRING 参数（格式为 dbName@host:port），直接指定需要访问的数据库。
 - 适用于专注一个数据库访问的场景。
@@ -49,6 +56,12 @@ CONNECTION_STRING = mydb@192.168.1.100:3306
 ```
 之后每次启动服务时，DMS MCP Server都会直接访问这个指定的数据库，无需切换实例。
 
+**典型提问示例：**  
+- 我有哪些表？
+- 查看test_table 表的字段结构
+- 获取test_table 表的前20条数据
+- 使用工具，回答“今天的用户访问量是多少？”
+
 ---
 
 ## 工具清单
@@ -103,8 +116,8 @@ CONNECTION_STRING = mydb@192.168.1.100:3306
 - 具有阿里云DMS访问权限的AK SK或者STS Token
 
 ---
-## 预配置
-在通过DMS访问数据库实例之前，需要将实例添加到DMS中。
+## 准备工作
+在通过DMS MCP访问托管在DMS的数据库实例之前，需要将对应的数据库实例录入至DMS中，并为实例开启 [安全托管](https://help.aliyun.com/zh/dms/product-overview/security-hosting)。
 
 可以通过以下两种方式进行实例的添加：
 

src/alibabacloud_dms_mcp_server/server.py

@@ -255,7 +255,7 @@ async def list_tables(  # Renamed from listTable to follow convention
         raise
 
 async def get_meta_table_detail_info(
-        table_guid: str = Field(description="Unique table identifier (format: dmsTableId.schemaName.tableName)")
+        table_guid: str = Field(description="Unique table identifier (format: dmsTableId.schemaName.tableName),Example: IDB_1567890.mySchema.myTable")
 ) -> TableDetail:
     client = create_client()
     req = dms_enterprise_20181101_models.GetMetaTableDetailInfoRequest(table_guid=table_guid)
@@ -537,7 +537,7 @@ def _register_full_toolset(self):
         self.mcp.tool(name="searchDatabase", description="Search databases in DMS based on their name.",
                       annotations={"title": "搜索DMS数据库", "readOnlyHint": True})(search_database)
         self.mcp.tool(name="getDatabase",
-                      description="Retrieve detailed information about a specific database from DMS.",
+                      description="Obtain detailed information about a specific database in DMS when the host and port are provided.",
                       annotations={"title": "获取DMS数据库详情", "readOnlyHint": True})(get_database)
         self.mcp.tool(name="listTables",
                       description="Search for database tables in DMS based on databaseId and tableName.",