aliyun/alibabacloud-rds-instances-manage

Alibabacloud RDS Instances Manage

本 Skill 让大模型通过命令行调用阿里云 RDS OpenAPI 与只读 SQL 能力，用于查询/管理 RDS 实例。

何时使用

• 用户询问某地域的 RDS 实例列表、实例详情、监控、慢日志、参数、账号、数据库、白名单等
• 用户需要对实例执行只读 SQL（如 explain、show create table、query_sql）或查看大表/碎片
• 用户需要创建/修改实例、账号、参数、规格、重启、公网连接等 OpenAPI 操作

前置条件

1. 安装：已安装本包（任选其一）
   • 从项目根目录：uv pip install -e . 或 pip install -e .
   • 或使用：uvx alibabacloud-rds-openapi-mcp-server 时，需在本地安装后使用 alibabacloud-rds-instances-manage 命令
2. 凭证：必须提供阿里云 AK/SK 环境变量
   • ALIBABA_CLOUD_ACCESS_KEY_ID
   • ALIBABA_CLOUD_ACCESS_KEY_SECRET
   • （可选）ALIBABA_CLOUD_SECURITY_TOKEN（STS）
   • （可选）MCP_TOOLSETS，默认 rds，可设为 rds,rds_custom_read 等

配置 entries（推荐）

在 OpenClaw、Claude Code 等平台中，建议在 skill 的 entries 里为本 skill 配置 env，把 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET 写进去，这样运行时无需再单独配置环境变量，便于后续使用。

OpenClaw：在 ~/.openclaw/openclaw.json 的 skills.entries 中为 alibabacloud-rds-instances-manage 增加一项，并写入 env：

{
  "skills": {
    "entries": {
      "alibabacloud-rds-instances-manage": {
        "enabled": true,
        "env": {
          "ALIBABA_CLOUD_ACCESS_KEY_ID": "你的 AccessKey ID",
          "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "你的 AccessKey Secret"
        }
      }
    }
  }
}

可选：若使用 STS，可在同一 env 中增加 ALIBABA_CLOUD_SECURITY_TOKEN；若需指定工具集，可增加 MCP_TOOLSETS（如 "rds,rds_custom_read"）。

Claude Code / 其他平台：在对应技能的配置中找到「entries」或「环境变量」项，为 alibabacloud-rds-instances-manage 配置上述两个 env 即可。

标准流程

1. 列出可用工具（若不确定工具名）

   alibabacloud-rds-instances-manage list
   

   输出为 JSON 数组，每项含 name、description。

2. 执行工具

   alibabacloud-rds-instances-manage run <工具名> '<JSON 参数>'
   

   • 参数为 JSON 对象，键为工具文档中的参数名（如 region_id、db_instance_id）。
   • 示例：查询杭州地域实例

     alibabacloud-rds-instances-manage run describe_db_instances '{"region_id":"cn-hangzhou"}'
     

   • 示例：查询实例详情

     alibabacloud-rds-instances-manage run describe_db_instance_attribute '{"region_id":"cn-hangzhou","db_instance_id":"rm-xxxxx"}'
     

   • 示例：执行只读 SQL

     alibabacloud-rds-instances-manage run query_sql '{"region_id":"cn-hangzhou","db_instance_id":"rm-xxxxx","db_name":"mydb","sql":"SELECT 1"}'
     

3. 解析结果

   • 成功：标准输出为工具返回的 JSON 或文本的 JSON 包装。
   • 失败：标准错误为 {"error":"..."}，退出码非 0。

常用工具速查

| 能力 | 工具名 | 典型参数 | |------|--------|----------| | 实例列表 | describe_db_instances | region_id | | 实例详情 | describe_db_instance_attribute | region_id, db_instance_id | | 可用区 | describe_available_zones | region_id, engine, 等 | | 可用规格 | describe_available_classes | region_id, zone_id, engine, engine_version, 等 | | 监控指标 | describe_db_instance_performance / describe_monitor_metrics | region_id, db_instance_id, 时间等 | | 慢日志 | describe_slow_log_records | region_id, db_instance_id, 时间等 | | 参数 | describe_db_instance_parameters | region_id, db_instance_id | | 修改参数 | modify_parameter | region_id, dbinstance_id, parameters 等 | | 只读 SQL | query_sql | region_id, db_instance_id, db_name, sql | | 执行计划 | explain_sql | region_id, db_instance_id, db_name, sql | | 建表语句 | show_create_table | region_id, db_instance_id, db_name, table_name | | 当前时间 | get_current_time | 无参数 {} |

完整工具列表与参数见 tools_reference.md。

注意事项

• 所有写操作（创建/修改/重启等）会真实变更资源，调用前应确认参数与权限。
• SQL 类工具（如 query_sql）仅支持只读；写操作请通过 OpenAPI 工具完成。
• 时间参数建议使用 get_current_time 获取当前时间后再计算范围。