Alibaba Cloud Ops MCP Server vs CloudBase AI ToolKit

OOS_RunCommand

批量在多台ECS实例上运行云助手命令，适用于需要同时管理多台ECS实例的场景，如应用程序管理和资源标记操作等。

OOS_StartInstances

批量启动ECS实例，适用于需要同时管理和启动多台ECS实例的场景，例如应用部署和高可用性场景。

OOS_StopInstances

批量停止ECS实例，适用于需要同时管理和停止多台ECS实例的场景。

OOS_RebootInstances

批量重启ECS实例，适用于需要同时管理和重启多台ECS实例的场景。

OOS_RunInstances

批量创建ECS实例，适用于需要同时创建多台ECS实例的场景，例如应用部署和高可用性场景。

OOS_ResetPassword

批量修改ECS实例的密码，请注意，本操作将会重启ECS实例

OOS_ReplaceSystemDisk

批量替换ECS实例的系统盘，更换操作系统

OOS_StartRDSInstances

批量启动RDS实例，适用于需要同时管理和启动多台RDS实例的场景，例如应用部署和高可用性场景。

OOS_StopRDSInstances

批量停止RDS实例，适用于需要同时管理和停止多台RDS实例的场景。

OOS_RebootRDSInstances

批量重启RDS实例，适用于需要同时管理和重启多台RDS实例的场景。

OOS_CodeDeploy

将应用部署到阿里云ECS实例。使用阿里云OOS（运维编排服务）的CodeDeploy功能实现自动化部署。 ## 前置条件（调用此工具前需完成） 1. **识别项目类型**：读取项目配置文件（package.json、pom.xml、requirements.txt等），确定技术栈和部署语言（通过deploy_language参数传入） 2. **构建部署产物**：执行构建命令生成压缩包（tar.gz、zip等），保存到 `.code_deploy/release` 目录 3. **准备ECS实例**：确保目标ECS实例已创建，获取实例ID列表 ## ⚠️ 重要提示：启动和停止命令参数 **正常情况下，不需要提供 application_start 和 application_stop 参数！** - 系统会自动通过规则引擎分析部署文件和 deploy_language，自动生成启动和停止命令 - 自动生成的命令包含所有必要的防御性检查（文件存在性、路径存在性等） - 自动生成的命令正确处理压缩包解压、目录切换、后台运行、日志重定向等 - 对于 Node.js 应用，自动生成的命令会先执行 `npm install` 安装依赖 **只有在以下情况下才需要手动提供这两个参数：** 1. 用户明确指定了自定义的启动/停止命令 2. 用户提供了关于启动/停止命令的特殊要求或说明 **调用建议：直接调用工具，不传 application_start 和 application_stop 参数即可。** ## 自动生成的命令规范（供参考，了解即可） ### 1. 防御性命令设计 自动生成的命令包含存在性检查，避免因路径/文件/命令不存在导致失败： - 压缩包：先检查文件存在再解压 `[ -f app.tar.gz ] && tar -xzf app.tar.gz || exit 1` - 可执行文件：检查文件存在再执行 `[ -f start.sh ] && chmod +x start.sh && ./start.sh || exit 1` - 命令可用性：检查命令是否存在 `command -v npm >/dev/null 2>&1 || exit 1` - 目录切换：先验证路径存在再切换 `[ -d dir ] && cd dir || exit 1` ### 2. 压缩包处理规范 如果产物是压缩包，自动生成的命令会先解压： - 使用非交互式命令：`tar -xzf`、`unzip -o`（自动覆盖，无需确认） - 解压后执行启动命令，确保路径对应 - 示例：`tar -xzf app.tar.gz && [ -d app ] && cd app && nohup java -jar app.jar > /root/app.log 2>&1 &` ### 3. 后台运行与日志 自动生成的启动命令使用后台运行并重定向日志： - 格式：`nohup <command> > /root/app.log 2>&1 &` - 说明：nohup保持后台运行，`>` 重定向标准输出，`2>&1` 合并错误输出，`&` 后台执行 ## 注意事项 - 应用和应用分组会自动检查，已存在则跳过创建 - 未提供ECS实例ID时，工具会返回创建引导链接 - 部署信息自动保存到 `.code_deploy/.application.json` - project_path未提供时，会从file_path推断或使用当前目录 - 部署完成后，以markdown格式展示service_link供用户跳转

OOS_GetLastDeploymentInfo

获取上次部署的应用信息

auth

CloudBase（腾讯云开发）开发阶段登录与环境绑定。登录后即可访问云资源；环境(env)是云函数、数据库、静态托管等资源的隔离单元，绑定环境后其他 MCP 工具才能操作该环境。支持：查询状态、发起登录、API Key登录、绑定环境(set_env)、退出登录。auth(status) 会返回 credential_scope（account=账号级 / single_env=环境级 API Key）与当前 region；环境级 API Key 只能看到绑定的 envId，查不到其他地域环境是权限边界而非环境不存在。可选 site/region/lang 参数：site=站点(domestic/intl)，region=地域，lang=输出语言(zh/en)。

queryEnv

查询 CloudBase 环境相关信息，支持查询环境列表、指定环境详情、安全域名、资源用量与监控指标。（曾用名：envQuery、listEnvs、getEnvInfo、getEnvAuthDomains）当 action=list 时，会按 DescribeEnvs 语义做列表/筛选，标准返回字段为 EnvId、Alias、Status、EnvType、Region、PackageId、PackageName、IsDefault，并支持通过 fields 白名单裁剪这些字段；aliasExact=true 时会按别名精确筛选，避免把前缀相近的环境误当作候选；即使传入 envId，action=list 也只返回摘要，不会返回完整资源明细或 expiry。账号级登录可传 region（ap-shanghai/ap-guangzhou/ap-singapore）查询对应地域，对齐 CLI `tcb env list -r <region>`；环境级凭证（API Key / 托管授权 token）只能看到绑定的 envId，返回 credential_scope=single_env，此时 region 不参与查询会在 ignored_params 中如实说明（AppliedFilters.region 为 null），不要误判为环境不存在或地域过滤失效。如需查询某个已知 EnvId 对应环境的详细信息（包括资源字段和计费信息），必须使用 action=info 并传入目标环境的 envId 参数。action=info 会在可用时补充 BillingInfo（如 ExpireTime、PayMode、IsAutoRenew 等计费字段）。 📊 action=usage 对齐 tcb env usage/info：透传 Manager SDK describeEnvAccountCircle + describeCreditsUsageDetail，返回计费周期与各模块资源点用量（FLEXDB/SCF/COS 等）。envId 必填；type 可选过滤模块；未传 startDate/endDate 时自动使用当前计费周期。 📈 action=metrics 对齐 TCB DescribeCurveData（manager.monitor.describeCurveData，不是云监控 GetMonitorData）：查询环境/网关 QPS、云函数调用与错误、数据库 CPU/内存/磁盘、云托管 CPU/QPS 等时序。envId 与 metricName 必填；startTime/endTime 格式 YYYY-MM-DD HH:mm:ss，须成对传入，不传则默认最近 24 小时；period 仅 300/3600/86400。GatewayTraceEnvQPS 未传 resourceID 时自动填环境级 all|:|all|:|all|:|all；云托管 Tke* 指标必须传服务名 resourceID。禁止用 callCloudApi 猜测监控 Action。 🔍 action=info 还会派生三个用于后端选型的字段： - `EnvInfo.RuntimeMode`：'postgresql' 或 'nosql'，表示新业务建议默认使用的后端（PG 已开通时为 postgresql，否则为 nosql）。 - `EnvInfo.RuntimeBackends`：`{postgresql, nosql, mysql}` 三个布尔值，描述当前环境实际并存的后端。 - `EnvInfo.RuntimeModeHints`：每个后端对应的 API/工具/skill 提示。 🌐 action=info 还会在不改写 `StaticStorages[].StaticDomain`（云 API 名义域名）的前提下，投影网关路由 Enable 状态：`StaticStorages[].staticDomainRouteEnabled` 与 `EnvInfo.staticDomainRouteEnabled`（与 queryHosting websiteConfig 同源）。`false` 表示默认静态域名根路由已禁用（访问会返回 GATEWAY_ROUTE_DISABLED），勿把名义域名当成可达 URL。 AI 在写业务/权限/存储代码前必须先看这三项：PG 模式下新业务推荐 `app.rdb()` + RLS（`managePgDatabase action=execute` 跑 `CREATE POLICY`）+ pgstore；已存在的 NoSQL 集合 / 旧 storage / `managePermissions(resourceType="noSqlDatabase")` 在 PG 环境下仍然有效。真正不适用的是 MySQL：当 `RuntimeBackends.mysql === false` 时，`manageMysqlDatabase` / `queryMysqlDatabase` / `relational-database-mcp-cloudbase` skill 都不该使用。