@cloudbase/cloudbase-mcp 2.25.3 → 2.25.4

package/dist/index.js

@@ -2772,7 +2772,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.25.3" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.25.4" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -2853,7 +2853,7 @@ function createWrappedHandler(name, handler, server) {
                 requestId: (typeof error === 'object' && error && 'requestId' in error) ? error.requestId : '',
                 ide: server.ide || process.env.INTEGRATION_IDE || ''
             });
-            const mcpVersion =  true ? "2.25.3" : 0;
+            const mcpVersion =  true ? "2.25.4" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息
@@ -7840,6 +7840,7 @@ const QUERY_GATEWAY_ACTIONS = [
     "listRoutes",
     "getRoute",
     "listCustomDomains",
+    "getPrivilege",
 ];
 const MANAGE_GATEWAY_ACTIONS = [
     "createRoute",
@@ -7847,6 +7848,8 @@ const MANAGE_GATEWAY_ACTIONS = [
     "deleteRoute",
     "bindCustomDomain",
     "deleteCustomDomain",
+    "enableService",
+    "authSwitch",
 ];
 /** DomainType of the environment default HTTP service (gateway) domain. */
 const HTTP_SERVICE_DOMAIN_TYPE = "HTTPSERVICE";
@@ -7943,6 +7946,28 @@ function registerGatewayTools(server) {
             candidates.find((item) => item.Enable !== false) ??
             candidates[0]);
     };
+    const getGatewayPrivilege = async () => {
+        const cloudbase = await getManager();
+        const result = await cloudbase
+            .commonService("tcb", "2018-06-08")
+            .call({
+            Action: "DescribeCloudBaseGWPrivilege",
+            Param: {
+                ServiceId: await resolveEnvId(),
+            },
+        });
+        (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, result);
+        return result ?? {};
+    };
+    const buildPrivilegeDescription = (privilege) => {
+        const serviceStatus = privilege.EnableService === true ? "已开启" : "未开启";
+        const authStatus = privilege.EnableAuth === undefined
+            ? "未知"
+            : privilege.EnableAuth === true
+                ? "已开启"
+                : "未开启";
+        return `HTTP 网关${serviceStatus}，访问鉴权${authStatus}`;
+    };
     const resolveDefaultHttpDomain = async () => {
         // Match console DescribeHTTPServiceRoute usage: filter DomainType=HTTPSERVICE.
         // Envs often also expose an IsDefault STATIC_STORE domain (*.tcloudbaseapp.com);
@@ -8115,6 +8140,28 @@ function registerGatewayTools(server) {
                     },
                 ]);
             }
+            case "getPrivilege": {
+                const privilege = await getGatewayPrivilege();
+                const enableService = privilege.EnableService === true;
+                const enableAuth = privilege.EnableAuth === true;
+                return buildEnvelope({
+                    action: input.action,
+                    enableService,
+                    enableAuth,
+                    raw: privilege,
+                }, buildPrivilegeDescription(privilege) +
+                    (enableService
+                        ? ""
+                        : "；若路由创建成功但访问报 HTTPSERVICE_NONACTIVATED（403），请先开启 HTTP 网关"), enableService
+                    ? undefined
+                    : [
+                        {
+                            tool: "manageGateway",
+                            action: "enableService",
+                            reason: "开启 HTTP 网关总开关（EnableService），开启后路由即可通过默认域访问",
+                        },
+                    ]);
+            }
             default:
                 throw new Error(`不支持的操作类型: ${input.action}`);
         }
@@ -8145,6 +8192,28 @@ function registerGatewayTools(server) {
                     throw err;
                 }
                 (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, result);
+                // 探测 HTTP 网关总开关：未开启时提示 HTTPSERVICE_NONACTIVATED 风险并引导开启。
+                // 探测失败不阻断路由创建结果，仅追加弱提示。
+                let privilegeHint = "";
+                let privilegeNextActions = [];
+                try {
+                    const privilege = await getGatewayPrivilege();
+                    if (privilege.EnableService !== true) {
+                        privilegeHint =
+                            "⚠️ HTTP 网关总开关未开启，路由创建成功后访问仍将返回 HTTPSERVICE_NONACTIVATED（403）；请先调用 manageGateway(action=\"enableService\", enable=true) 开启，再等待 30 秒到 3 分钟访问。";
+                        privilegeNextActions = [
+                            {
+                                tool: "manageGateway",
+                                action: "enableService",
+                                reason: "开启 HTTP 网关总开关（EnableService），否则访问路由会报 HTTPSERVICE_NONACTIVATED（403）",
+                            },
+                        ];
+                    }
+                }
+                catch {
+                    privilegeHint =
+                        "（无法确认 HTTP 网关开关状态；若访问报 HTTPSERVICE_NONACTIVATED，请用 queryGateway(action=\"getPrivilege\") 查询后用 manageGateway(action=\"enableService\") 开启）";
+                }
                 return buildEnvelope({
                     action: input.action,
                     model: "httpServiceRoute",
@@ -8167,7 +8236,12 @@ function registerGatewayTools(server) {
                         : payload.resolved.enablePathTransmission === false
                             ? "；路径透传关闭（网关会剥掉触发路径前缀后再转发给后端）"
                             : "；路径透传未显式设置（平台默认 false，会剥掉触发路径前缀）") +
-                    `。注意：路由配置传播通常需要等待 30 秒到 3 分钟，请勿立即访问。该操作只创建网关入口，不会自动放开上游权限；若上游是云函数且需要匿名或浏览器直接访问，请继续检查函数资源权限。`, routeMutationNextActions(payload.resolved.upstreamResourceName));
+                    `。注意：路由配置传播通常需要等待 30 秒到 3 分钟，请勿立即访问。该操作只创建网关入口，不会自动放开上游权限；若上游是云函数且需要匿名或浏览器直接访问，请继续检查函数资源权限。` +
+                    (privilegeHint ? ` ${privilegeHint}` : ""), [
+                    ...privilegeNextActions,
+                    ...(routeMutationNextActions(payload.resolved.upstreamResourceName) ??
+                        []),
+                ]);
             }
             case "updateRoute": {
                 const cloudbase = await getManager();
@@ -8258,6 +8332,60 @@ function registerGatewayTools(server) {
                     raw: result,
                 }, "自定义域名删除成功");
             }
+            case "enableService": {
+                if (typeof input.enable !== "boolean") {
+                    throw new Error('action=enableService 时必须提供 enable 参数（boolean），如 enable=true 开启 HTTP 网关总开关、enable=false 关闭；禁止省略或传非布尔值。');
+                }
+                const cloudbase = await getManager();
+                const result = await cloudbase.access.switchAuth(input.enable);
+                (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, result);
+                const serviceText = input.enable ? "开启" : "关闭";
+                return buildEnvelope({
+                    action: input.action,
+                    enable: input.enable,
+                    raw: result,
+                }, `HTTP 网关总开关${serviceText}成功`, [
+                    {
+                        tool: "queryGateway",
+                        action: "getPrivilege",
+                        reason: "复核 HTTP 网关总开关与访问鉴权状态",
+                    },
+                ]);
+            }
+            case "authSwitch": {
+                if (typeof input.enable !== "boolean") {
+                    throw new Error('action=authSwitch 时必须提供 enable 参数（boolean），如 enable=true 开启访问鉴权、enable=false 关闭；禁止省略或传非布尔值。');
+                }
+                const cloudbase = await getManager();
+                const result = await cloudbase
+                    .commonService("tcb", "2018-06-08")
+                    .call({
+                    Action: "ModifyCloudBaseGWPrivilege",
+                    Param: {
+                        ServiceId: await resolveEnvId(),
+                        EnableService: input.enable,
+                        Options: [
+                            {
+                                Key: "authswitch",
+                                Value: input.enable ? "true" : "false",
+                            },
+                        ],
+                    },
+                });
+                (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, result);
+                const serviceText = input.enable ? "开启" : "关闭";
+                return buildEnvelope({
+                    action: input.action,
+                    enable: input.enable,
+                    raw: result,
+                }, `HTTP 访问服务鉴权${serviceText}成功`, [
+                    {
+                        tool: "queryGateway",
+                        action: "getPrivilege",
+                        reason: "复核 HTTP 网关总开关与访问鉴权状态",
+                    },
+                ]);
+            }
             default:
                 throw new Error(`不支持的操作类型: ${input.action}`);
         }
@@ -8266,12 +8394,14 @@ function registerGatewayTools(server) {
         title: "查询 CloudBase 网关",
         description: "CloudBase HTTP 网关统一只读入口（Domain/Route）。查询域名下路径路由及其上游：" +
             "WEB_SCF/SCF=云函数，CBR=云托管，STATIC_STORE=静态托管，LH=轻量应用服务器。" +
-            "主键为 Domain + Path；listRoutes / getRoute / listCustomDomains。" +
+            "主键为 Domain + Path；listRoutes / getRoute / listCustomDomains / getPrivilege。" +
+            "getPrivilege 查询 HTTP 网关总开关（enableService）与访问鉴权（enableAuth）状态。" +
             "实现自定义域名访问前，先 listCustomDomains：若已有自定义域名，优先 createRoute 挂路由（无需证书 ID）；仅在没有可用自定义域名时才 bindCustomDomain。",
         inputSchema: {
             action: zod_1.z
                 .enum(QUERY_GATEWAY_ACTIONS)
-                .describe("只读操作类型：listRoutes、getRoute、listCustomDomains。" +
+                .describe("只读操作类型：listRoutes、getRoute、listCustomDomains、getPrivilege。" +
+                "getPrivilege 无需其他参数，直接返回 HTTP 网关总开关与访问鉴权状态。" +
                 "自定义域名访问场景先 listCustomDomains 确认是否已有域名可复用。"),
             targetName: zod_1.z
                 .string()
@@ -8304,11 +8434,13 @@ function registerGatewayTools(server) {
             "createRoute 只建网关入口，不改上游权限。" +
             "enablePathTransmission：默认 false 剥触发路径前缀；true 透传完整路径（CBR 多路由、WEB_SCF 自管子路径常需 true；STATIC_STORE 自定义触发路径映射站点根通常 false）。" +
             "⚠️ 自定义域名访问：若环境已有自定义域名（先 queryGateway listCustomDomains），优先 createRoute 并显式传入该 domain，无需 certificateId；" +
-            "仅首次绑定全新自定义域名时用 bindCustomDomain（需 certificateId）。CORS/安全域名用 envDomainManagement。",
+            "仅首次绑定全新自定义域名时用 bindCustomDomain（需 certificateId）。CORS/安全域名用 envDomainManagement。" +
+            "enableService/authSwitch：HTTP 网关总开关与访问鉴权开关；createRoute 后若访问报 HTTPSERVICE_NONACTIVATED，通常是总开关未开启（用 queryGateway getPrivilege 查询、enableService 开启）。",
         inputSchema: {
             action: zod_1.z
                 .enum(MANAGE_GATEWAY_ACTIONS)
-                .describe("写操作：createRoute/updateRoute/deleteRoute 管理路由；bindCustomDomain/deleteCustomDomain 管理自定义域名。" +
+                .describe("写操作：createRoute/updateRoute/deleteRoute 管理路由；bindCustomDomain/deleteCustomDomain 管理自定义域名；" +
+                "enableService/authSwitch 开关 HTTP 网关总开关与访问鉴权（需配合 enable 参数）。" +
                 "createRoute/updateRoute 必须提供 upstreamResourceType。" +
                 "已有自定义域名时优先 createRoute(domain=已有域名) 实现访问，不必再次 bindCustomDomain / 传入 certificateId；" +
                 "bindCustomDomain 仅用于首次绑定新域名。"),
@@ -8374,6 +8506,11 @@ function registerGatewayTools(server) {
                 .optional()
                 .describe("证书 ID。仅首次 bindCustomDomain 必填。" +
                 "在已有自定义域名上 createRoute / updateRoute / deleteRoute 不需要 certificateId。"),
+            enable: zod_1.z
+                .boolean()
+                .optional()
+                .describe("开关目标状态（仅 enableService / authSwitch 使用，必填）：" +
+                "enable=true 开启，enable=false 关闭。省略或非布尔值会返回参数错误。"),
         },
         annotations: {
             readOnlyHint: false,
@@ -10410,6 +10547,22 @@ function buildLoginConfigNextStep(loginMethods) {
         },
     };
 }
+/**
+ * 短信验证码默认通道提示：开启 phone 登录后即可用云开发默认短信通道收发验证码，
+ * 不需要配置短信签名/模板/自定义 Provider。仅当需要自定义模板、签名或更换短信服务商时，
+ * 才需要配置 SmsVerificationConfig / 自定义短信通道。
+ */
+function buildSmsHint(loginMethods) {
+    if (!loginMethods.phone) {
+        return undefined;
+    }
+    return {
+        defaultChannelReady: true,
+        message: "短信验证码登录已开启，可直接使用云开发默认短信通道收发验证码，无需配置短信签名/模板/自定义 Provider。" +
+            "前端调用 auth.getVerification({ phone_number }) 发送验证码、auth.signInWithSms({ verificationInfo, verificationCode, phoneNum }) 登录。" +
+            "仅当需要自定义短信模板/签名或更换短信服务商时，才需要配置 SmsVerificationConfig 或接入自定义短信通道。",
+    };
+}
 function extractProviders(value) {
     const payload = normalizePlainObject(value, "providersResult");
     const providers = payload?.Providers ?? payload?.ProviderList ?? payload?.Data ?? [];
@@ -10590,12 +10743,14 @@ function registerAppAuthTools(server) {
                 const loginMethods = buildLoginMethods(result);
                 const nextStep = buildLoginConfigNextStep(loginMethods);
                 const webSdkHint = buildWebSdkHint(loginMethods);
+                const smsHint = buildSmsHint(loginMethods);
                 return buildSupabaseLikeAuthResponse({
                     success: true,
                     envId,
                     loginMethods,
                     ...(nextStep ? { next_step: nextStep } : {}),
                     ...(webSdkHint ? { webSdkHint } : {}),
+                    ...(smsHint ? { smsHint } : {}),
                 });
             }
             case "listProviders": {
@@ -10671,7 +10826,7 @@ function registerAppAuthTools(server) {
     }));
     server.registerTool?.("manageAppAuth", {
         title: "管理 CloudBase 应用认证配置",
-        description: "CloudBase 应用侧认证配置写入口。用于修改登录方式、provider、client 配置，确保 publishable key，以及创建或删除 API key、自定义登录密钥。⚠️ 本工具为管理端配置工具，不执行用户登录。当任务要求编写客户端登录代码时（例如「用 JS SDK 登录」），应先通过本工具完成配置（如启用 usernamePassword、获取 publishable key），再在项目代码中编写 @cloudbase/js-sdk 客户端登录代码（如 auth.signInWithPassword()），而非使用本工具完成登录。若前端要接受普通用户名样式标识符，应先执行 action=patchLoginStrategy 并传入 patch={ usernamePassword: true }，再实现对应前端登录逻辑。⚠️ action=createApiKey 返回体中的 created 字段表示是否真正新建：created=false 说明复用了环境中已存在的 key，此时 keyName/expireIn 入参不会生效，返回的 keyName/expireAt 均为服务端真实值，并会附带 warnings，切勿把它当作临时凭证分发。",
+        description: "CloudBase 应用侧认证配置写入口。用于修改登录方式、provider、client 配置，确保 publishable key，以及创建或删除 API key、自定义登录密钥。⚠️ 本工具为管理端配置工具，不执行用户登录。当任务要求编写客户端登录代码时（例如「用 JS SDK 登录」），应先通过本工具完成配置（如启用 usernamePassword、获取 publishable key），再在项目代码中编写 @cloudbase/js-sdk 客户端登录代码（如 auth.signInWithPassword()），而非使用本工具完成登录。若前端要接受普通用户名样式标识符，应先执行 action=patchLoginStrategy 并传入 patch={ usernamePassword: true }，再实现对应前端登录逻辑。⚠️ 短信验证码登录（patch={ phone: true }）使用云开发默认短信通道，开启后即可收发验证码，不需要配置短信签名/模板/自定义 Provider；仅当需要自定义模板/签名或更换短信服务商时才需配置 SmsVerificationConfig 或自定义短信通道。⚠️ action=createApiKey 返回体中的 created 字段表示是否真正新建：created=false 说明复用了环境中已存在的 key，此时 keyName/expireIn 入参不会生效，返回的 keyName/expireAt 均为服务端真实值，并会附带 warnings，切勿把它当作临时凭证分发。",
         inputSchema: {
             action: zod_1.z.enum(MANAGE_APP_AUTH_ACTIONS),
             patch: zod_1.z
@@ -10737,12 +10892,14 @@ function registerAppAuthTools(server) {
                 const loginMethods = buildLoginMethods(confirmed);
                 const nextStep = buildLoginConfigNextStep(loginMethods);
                 const webSdkHint = buildWebSdkHint(loginMethods);
+                const smsHint = buildSmsHint(loginMethods);
                 return buildSupabaseLikeAuthResponse({
                     success: true,
                     envId,
                     loginMethods,
                     ...(nextStep ? { next_step: nextStep } : {}),
                     ...(webSdkHint ? { webSdkHint } : {}),
+                    ...(smsHint ? { smsHint } : {}),
                 });
             }
             case "addProvider": {
@@ -10977,7 +11134,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.25.3" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.25.4" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -11489,7 +11646,7 @@ const TRIGGER_SCHEMA = zod_1.z.object({
 const CREATE_FUNCTION_SCHEMA = zod_1.z.object({
     name: zod_1.z.string().describe("函数名称"),
     type: zod_1.z.enum(["Event", "HTTP"]).optional().describe("函数类型"),
-    protocolType: zod_1.z.enum(["HTTP", "WS"]).optional().describe("HTTP 云函数协议类型"),
+    protocolType: zod_1.z.enum(["WS"]).optional().describe("HTTP 函数访问协议，当前仅支持 WebSockets，取值为 WS（配合 protocolParams.wsParams 使用）。普通 HTTP 函数不要传此字段；传其他值（如 HTTP）会报 InvalidParameterValue.ProtocolType。"),
     protocolParams: zod_1.z
         .object({
         wsParams: zod_1.z
@@ -15459,7 +15616,7 @@ function registerSetupTools(server) {
     server.registerTool("downloadTemplate", {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。
-**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置\n- cursor: Cursor AI编辑器\n- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.25.3" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置\n- cursor: Cursor AI编辑器\n- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.25.4" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/cloudbase-mcp",
-  "version": "2.25.3",
+  "version": "2.25.4",
   "packageManager": "pnpm@10.8.0",
   "description": "CloudBase MCP Server — operate Tencent CloudBase (database, auth, functions, storage, hosting) from AI coding tools via the Model Context Protocol. Part of CloudBase AI Toolkit.",
   "main": "./dist/index.cjs",