用途:该技能是面向智能体的火山引擎 Redis 云资源操作工作流,封装 MCP 客户端脚本、启动脚本、凭证指引与工具选择说明,用于查询和管理火山引擎 Redis 资源。仅限火山引擎 Redis;OSS Redis 命令执行、自建 Redis 排障、应用缓存逻辑、Kubernetes 中的 Redis 或其他云厂商 Redis 应使用其他工具。
主要能力:支持实例清单、详情、状态查询,按地域、实例 ID、名称、标签、VPC、子网过滤;地域、可用区、VPC、子网、EIP、规格、分片、节点、端点、带宽、拓扑信息;慢日志、热 key、大 key、key 扫描任务、计划事件与运维元数据;备份、PITR、跨地域备份、备份计划与下载 URL;参数组、实例参数、ACL、账号与白名单操作;以及创建或修改实例、账号、白名单、公网端点、名称和参数。
使用方式:先区分只读或变更操作,确认 region_id 与 instance_id;仅有名称时先调用 describe_db_instances 再取实例 ID。启动 MCP 前确认凭证:AUTHORIZATION 或 VOLCENGINE_ACCESS_KEY 与 VOLCENGINE_SECRET_KEY,临时凭证另加 VOLCENGINE_SESSION_TOKEN;未提供地域时使用 VOLCENGINE_REGION,否则先询问地域。自定义调用使用 scripts/mcp_client.py,冒烟测试运行 uv run scripts/call_redis_mcp_example.py。变更操作需先汇总目标资源与变更内容并取得用户确认。
限制:上游 MCP 服务器工具 schema 为准;不要打印完整密钥、AK/SK、会话令牌或授权载荷;探索性调用保持较小分页;日志与 key 分析需时间窗口;备份下载 URL 与公网端点属敏感输出;凭证或地域环境变量变更后需重启后台服务;READY 仅表示 HTTP 端点存活,不代表工具调用可用。失败时按缺失凭证、STS 过期、缺失地域、无实例、多实例、权限拒绝、启动失败、schema 错误、限流等分类处理,只读调用可重试一次,变更调用除非幂等明确否则不重试。