SuperAPI AI 工具集

mcp-core-best-practices

部署与运维

查看项目

更新于 10-15 19:54

技能介绍

用途:该技能文档化阿里云 alibabacloud-core MCP 服务器的标准使用模式。该服务器是通用 OpenAPI MCP Server Core,覆盖所有阿里云 API,无需预先选定具体操作。

主要能力:提供 AlibabaCloud___SearchApis(自然语言检索 API)、ListApis、GetApiDefinition、ListProducts、ListProductRegions、GenerateCLICommand、CallCLI、RunScript、GetTask、RunIaC、GetPresignedUrl,以及 SearchDocuments、GetDocument、GetDocumentTree、GrepDocuments 文档工具。

标准流程:未知 API 先用 SearchApis 检索,再用 GetApiDefinition 查看参数、响应、鉴权与错误码;用 GenerateCLICommand 生成命令。单次已知命令用 CallCLI 执行,命令必须以 aliyun 开头,不支持管道、重定向、shell 变量与本地路径。需要分页、跨资源对比、多区域采集或响应驱动后续调用时用 RunScript,通过注入的 call_cli() 访问 OpenAPI,不能传 aliyun 文本命令;脚本需有模块级 call_cli(),用 result 返回,禁用 import、注释、eval/exec 等敏感名称及 subprocess、网络代码,结果需完整分页。

计费操作:执行前用 --estimate-cost 获取报价并在确认中展示,多步操作可用 --estimate-cost-context 合并报价。跨账号操作须先加载 multi-account-query 技能,并通过 x_assume_account_id 等参数指定成员账号。多资源、有依赖的部署优先用 RunIaC,按 plan/apply/destroy 流程执行,并用 GetTask 轮询至终态。文件传输用 GetPresignedUrl 暂存 OSS。运行中需处理 InvalidParameter、AccessDenied、Throttling、RegionNotSupported 等错误。

限制:MCP 服务器为远程服务,无法访问本地文件系统;部分 OSS API 不受支持;审批被拒或过期即终止,不可自动重试。