From 1704727f1c30ce7887d1ec3fdbe7a26a95af4dcd Mon Sep 17 00:00:00 2001 From: CodeBuddy Attribution Bot Date: Wed, 29 Apr 2026 09:52:53 +0800 Subject: [PATCH] =?UTF-8?q?fix(attribution):=20callCloudApi=20MCP=20?= =?UTF-8?q?=E5=B7=A5=E5=85=B7=E7=9A=84=20schema/prompt=20=E6=9C=AA?= =?UTF-8?q?=E6=B8=85=E6=99=B0=E6=A0=87=E6=B3=A8=20CreateUser=20=E5=BF=85?= =?UTF-8?q?=E5=A1=AB=E5=8F=82=E6=95=B0=EF=BC=88EnvId=EF=BC=89=EF=BC=8C?= =?UTF-8?q?=E4=B8=94=E5=8F=82=E6=95=B0=E5=91=BD=E5=90=8D=E7=BA=A6=E5=AE=9A?= =?UTF-8?q?=E4=B8=8D=20(issue=5Fmojd35i1=5Fptw5mr)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- mcp/src/tools/capi.ts | 22 +++++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/mcp/src/tools/capi.ts b/mcp/src/tools/capi.ts index c1f6fca0..20a0d8de 100644 --- a/mcp/src/tools/capi.ts +++ b/mcp/src/tools/capi.ts @@ -189,7 +189,11 @@ export function registerCapiTools(server: ExtendedMcpServer) { **云函数**: \`DescribeFunctions\`、\`CreateFunction\`、\`UpdateFunctionCode\`、\`DeleteFunction\` **数据库**: \`CreateMySQLInstance\`、\`DescribeMySQLInstances\`、\`DestroyMySQLInstance\` -销毁环境时，常见做法是至少带上 \`EnvId\` 和 \`BypassCheck: true\`，如果环境已经处于隔离期再按文档补 \`IsForce: true\`。`, +销毁环境时，常见做法是至少带上 \`EnvId\` 和 \`BypassCheck: true\`，如果环境已经处于隔离期再按文档补 \`IsForce: true\`。 + +**重要提示**： +1. tcb 绝大多数 Action 都要求传 \`EnvId\`（环境 ID）作为必填参数，只有 CreateEnv、CheckTcbService 等少数 Action 例外。调用时若未传 EnvId 将直接报错。 +2. params 必须是**扁平的键值对**，键名与官方 API 定义完全一致（区分大小写），**不要**将参数嵌套在子对象中。例如 \`CreateUser\` 的正确参数是 \`{ "EnvId": "env-xxx", "Name": "zhangsan", "Type": "internalUser" }\`，而非 \`{ "User": { "UserName": "zhangsan" } }\`。`, inputSchema: { service: z .enum(ALLOWED_SERVICES) @@ -204,7 +208,7 @@ export function registerCapiTools(server: ExtendedMcpServer) { .record(z.any()) .optional() .describe( - "Action 对应的参数对象，键名需与官方 API 定义一致。某些 Action 需要携带 EnvId 等信息；如不确定参数结构，请先查官方文档。tcb 示例：`{ \"service\": \"tcb\", \"action\": \"DestroyEnv\", \"params\": { \"EnvId\": \"env-xxx\", \"BypassCheck\": true } }`，如果环境已经处于隔离期，可再补 `IsForce: true`；更新环境别名则可用 `{ \"service\": \"tcb\", \"action\": \"ModifyEnv\", \"params\": { \"EnvId\": \"env-xxx\", \"Alias\": \"demo\" } }`。若你的场景是通过 HTTP 协议直接集成 auth/functions/cloudrun/storage/mysqldb 等 CloudBase 业务 API，请优先使用 OpenAPI / Swagger 或 searchKnowledgeBase(mode=\"openapi\")，而不是优先使用 callCloudApi。", + "Action 对应的参数对象，必须是扁平的键值对结构（不要嵌套子对象），键名需与官方 API 定义一致（区分大小写）。tcb 绝大多数 Action 都要求 \`EnvId\` 作为必填参数（仅 CreateEnv、CheckTcbService 等少数例外）。如不确定参数结构，请先查官方文档。tcb 示例：\n- 销毁环境：\`{ \"service\": \"tcb\", \"action\": \"DestroyEnv\", \"params\": { \"EnvId\": \"env-xxx\", \"BypassCheck\": true } }\`\n- 创建用户：\`{ \"service\": \"tcb\", \"action\": \"CreateUser\", \"params\": { \"EnvId\": \"env-xxx\", \"Name\": \"zhangsan\", \"NickName\": \"张三\", \"Phone\": \"13800138000\", \"Email\": \"zhangsan@example.com\", \"Type\": \"internalUser\", \"UserStatus\": \"ACTIVE\" } }\`\n- 修改环境别名：\`{ \"service\": \"tcb\", \"action\": \"ModifyEnv\", \"params\": { \"EnvId\": \"env-xxx\", \"Alias\": \"demo\" } }\`\n\n注意：CreateUser 的用户名字段是 \`Name\`（不是 UserName），用户类型字段是 \`Type\`（不是 UserType），用户状态字段是 \`UserStatus\`（不是 Status）。若你的场景是通过 HTTP 协议直接集成 auth/functions/cloudrun/storage/mysqldb 等 CloudBase 业务 API，请优先使用 OpenAPI / Swagger 或 searchKnowledgeBase(mode=\"openapi\")，而不是优先使用 callCloudApi。", ), }, annotations: { @@ -259,11 +263,23 @@ export function registerCapiTools(server: ExtendedMcpServer) { } } + // Auto-inject EnvId for tcb actions that require it but the caller didn't provide it + let finalParams = params ?? {}; + if (service === "tcb" && !finalParams.EnvId) { + const tcbEntry = findTcbActionEntry(action); + if (tcbEntry?.requiredKeys.includes("EnvId")) { + const envId = cloudBaseOptions?.envId || process.env.CLOUDBASE_ENV_ID; + if (envId) { + finalParams = { ...finalParams, EnvId: envId }; + } + } + } + let result: unknown; try { result = await cloudbase.commonService(service).call({ Action: action, - Param: params ?? {}, + Param: finalParams, }); } catch (error) { throw new Error(buildCapiErrorMessage(service, action, error));