@cloudbase/cloudbase-mcp 2.20.0 → 2.20.2

package/dist/index.cjs

@@ -2854,8 +2854,8 @@ function registerEnvTools(server) {
     });
     // envQuery - 环境查询（合并 listEnvs + getEnvInfo + getEnvAuthDomains）
     server.registerTool?.("envQuery", {
-        title: "环境查询",
-        description: "查询云开发环境相关信息，支持查询环境列表、指定环境详情和安全域名。（原工具名：listEnvs/getEnvInfo/getEnvAuthDomains，为兼容旧AI规则可继续使用这些名称）当 action=list 时，会按 DescribeEnvs 语义做列表/筛选，标准返回字段为 EnvId、Alias、Status、EnvType、Region、PackageId、PackageName、IsDefault，并支持通过 fields 白名单裁剪这些字段；aliasExact=true 时会按别名精确筛选，避免把前缀相近的环境误当作候选；即使传入 envId，action=list 也只返回摘要，不会返回完整资源明细或 expiry。如需查询某个已知 EnvId 对应环境的详细信息（包括资源字段和计费信息），必须使用 action=info 并传入目标环境的 envId 参数。action=info 会在可用时补充 BillingInfo（如 ExpireTime、PayMode、IsAutoRenew 等计费字段）。",
+        title: "CloudBase 环境查询",
+        description: "查询 CloudBase 环境相关信息，支持查询环境列表、指定环境详情和安全域名。（原工具名：listEnvs/getEnvInfo/getEnvAuthDomains，为兼容旧AI规则可继续使用这些名称）当 action=list 时，会按 DescribeEnvs 语义做列表/筛选，标准返回字段为 EnvId、Alias、Status、EnvType、Region、PackageId、PackageName、IsDefault，并支持通过 fields 白名单裁剪这些字段；aliasExact=true 时会按别名精确筛选，避免把前缀相近的环境误当作候选；即使传入 envId，action=list 也只返回摘要，不会返回完整资源明细或 expiry。如需查询某个已知 EnvId 对应环境的详细信息（包括资源字段和计费信息），必须使用 action=info 并传入目标环境的 envId 参数。action=info 会在可用时补充 BillingInfo（如 ExpireTime、PayMode、IsAutoRenew 等计费字段）。",
         inputSchema: {
             action: zod_1.z
                 .enum(["list", "info", "domains"])
@@ -3059,8 +3059,8 @@ function registerEnvTools(server) {
     });
     // envDomainManagement - 环境域名管理（合并 createEnvDomain + deleteEnvDomain）
     server.registerTool?.("envDomainManagement", {
-        title: "环境域名管理（安全域名 / CORS 白名单）",
-        description: "管理云开发环境的安全域名（安全域名 / CORS 白名单），支持添加和删除操作。（原工具名：createEnvDomain/deleteEnvDomain，为兼容旧AI规则可继续使用这些名称）当浏览器 Web 应用需要从本地 Vite / dev server 直接访问 CloudBase 资源时，应先用 envQuery(action=domains) 检查当前实际浏览器 origin 对应的 host:port 是否已在白名单中，再按该实际值添加。新增或删除后通常需要继续轮询 envQuery(action=domains) 确认状态收敛；安全域名一般约 10 分钟生效。⚠️ 重要：此工具仅用于 CORS/请求来源验证，不涉及 SSL 证书。如需绑定自定义域名供公网 HTTPS 访问，请使用 manageGateway(action=\"bindCustomDomain\")。",
+        title: "CloudBase 环境域名管理（安全域名 / CORS 白名单）",
+        description: "管理 CloudBase 环境的安全域名（安全域名 / CORS 白名单），支持添加和删除操作。（原工具名：createEnvDomain/deleteEnvDomain，为兼容旧AI规则可继续使用这些名称）当浏览器 Web 应用需要从本地 Vite / dev server 直接访问 CloudBase 资源时，应先用 envQuery(action=domains) 检查当前实际浏览器 origin 对应的 host:port 是否已在白名单中，再按该实际值添加。新增或删除后通常需要继续轮询 envQuery(action=domains) 确认状态收敛；安全域名一般约 10 分钟生效。⚠️ 重要：此工具仅用于 CORS/请求来源验证，不涉及 SSL 证书。如需绑定自定义域名供公网 HTTPS 访问，请使用 manageGateway(action=\"bindCustomDomain\")。",
         inputSchema: {
             action: zod_1.z
                 .enum(["create", "delete"])
@@ -28294,6 +28294,22 @@ const MANAGE_APP_AUTH_ACTIONS = [
     "createCustomLoginKeys",
 ];
 const APP_AUTH_KEY_TYPES = ["publish_key", "api_key"];
+const APP_AUTH_PROVIDER_TYPES = [
+    "OAUTH",
+    "OIDC",
+    "SAML",
+    "WX_MICRO_APP",
+    "WX_QRCODE_MICRO_APP",
+    "WX_CLOUDBASE_MICRO_APP",
+    "WX_MP",
+    "WX_OPEN",
+    "WX_WORK_INTERNAL",
+    "WX_WORK_AGENT",
+    "WX_WORK_THIRD_PARTY",
+    "WX_WORK_THIRD_PARTY_ASSOCIATION",
+    "CUSTOM",
+    "EMAIL",
+];
 const SUPABASE_LIKE_SDK_HINTS = {
     phoneOtp: "auth.signInWithOtp({ phone })",
     emailOtp: "auth.signInWithOtp({ email })",
@@ -28539,8 +28555,8 @@ function registerAppAuthTools(server) {
         };
     };
     server.registerTool?.("queryAppAuth", {
-        title: "查询应用认证配置",
-        description: "应用侧认证配置只读入口。用于查询登录方式、provider、publishable key、API key、client 配置和静态域名等认证准备状态。⚠️ 本工具为管理端配置查询工具，不执行用户登录。当任务要求编写客户端登录代码时（例如「用 JS SDK 登录」），应先通过本工具确认配置状态，再在项目代码中编写 @cloudbase/js-sdk 客户端登录代码（如 auth.signInWithPassword()），而非使用本工具完成登录。若业务要接受普通用户名样式标识符，先查询 action=getLoginConfig；若 usernamePassword=false，下一步应立即调用 manageAppAuth(action=patchLoginStrategy, patch={ usernamePassword: true })，不要直接写 email 登录 API。",
+        title: "查询 CloudBase 应用认证配置",
+        description: "CloudBase 应用侧认证配置只读入口。用于查询登录方式、provider、publishable key、API key、client 配置和静态域名等认证准备状态。⚠️ 本工具为管理端配置查询工具，不执行用户登录。当任务要求编写客户端登录代码时（例如「用 JS SDK 登录」），应先通过本工具确认配置状态，再在项目代码中编写 @cloudbase/js-sdk 客户端登录代码（如 auth.signInWithPassword()），而非使用本工具完成登录。若业务要接受普通用户名样式标识符，先查询 action=getLoginConfig；若 usernamePassword=false，下一步应立即调用 manageAppAuth(action=patchLoginStrategy, patch={ usernamePassword: true })，不要直接写 email 登录 API。",
         inputSchema: {
             action: zod_1.z.enum(QUERY_APP_AUTH_ACTIONS),
             providerId: zod_1.z.string().optional().describe("provider 标识，如 email、google"),
@@ -28650,8 +28666,8 @@ function registerAppAuthTools(server) {
         }
     }));
     server.registerTool?.("manageAppAuth", {
-        title: "管理应用认证配置",
-        description: "应用侧认证配置写入口。用于修改登录方式、provider、client 配置，确保 publishable key，以及创建或删除 API key、自定义登录密钥。⚠️ 本工具为管理端配置工具，不执行用户登录。当任务要求编写客户端登录代码时（例如「用 JS SDK 登录」），应先通过本工具完成配置（如启用 usernamePassword、获取 publishable key），再在项目代码中编写 @cloudbase/js-sdk 客户端登录代码（如 auth.signInWithPassword()），而非使用本工具完成登录。若前端要接受普通用户名样式标识符，应先执行 action=patchLoginStrategy 并传入 patch={ usernamePassword: true }，再实现对应前端登录逻辑。",
+        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 }，再实现对应前端登录逻辑。",
         inputSchema: {
             action: zod_1.z.enum(MANAGE_APP_AUTH_ACTIONS),
             patch: zod_1.z
@@ -28659,7 +28675,10 @@ function registerAppAuthTools(server) {
                 .optional()
                 .describe("patchLoginStrategy 使用的简化登录策略 patch，如 { usernamePassword: true }"),
             providerId: zod_1.z.string().optional().describe("provider 标识，如 email、google；addProvider 时也可作为自定义 provider Id"),
-            providerType: zod_1.z.string().optional().describe("addProvider 时的 provider 协议类型，如 OAUTH、OIDC、EMAIL"),
+            providerType: zod_1.z
+                .enum(APP_AUTH_PROVIDER_TYPES)
+                .optional()
+                .describe("addProvider 时的 provider 协议类型"),
             displayName: zod_1.z
                 .union([zod_1.z.string(), zod_1.z.record(zod_1.z.any())])
                 .optional()
@@ -38645,8 +38664,8 @@ function registerAgentTools(server) {
     const cloudBaseOptions = server.cloudBaseOptions;
     const getManager = () => (0, cloudbase_manager_js_1.getCloudBaseManager)({ cloudBaseOptions });
     server.registerTool?.("queryAgents", {
-        title: "查询 Agent",
-        description: "Agent 域统一只读入口。支持列表、详情与日志查询。",
+        title: "查询 CloudBase Agent",
+        description: "CloudBase Agent 域统一只读入口。支持列表、详情与日志查询。",
         inputSchema: {
             action: zod_1.z.enum(QUERY_AGENT_ACTIONS),
             agentId: zod_1.z.string().optional(),
@@ -38708,8 +38727,8 @@ function registerAgentTools(server) {
         }
     });
     server.registerTool?.("manageAgents", {
-        title: "管理 Agent",
-        description: "Agent 域统一写入口。支持创建、更新和删除远端 Agent。",
+        title: "管理 CloudBase Agent",
+        description: "CloudBase Agent 域统一写入口。支持创建、更新和删除远端 Agent。",
         inputSchema: {
             action: zod_1.z.enum(MANAGE_AGENT_ACTIONS),
             agentId: zod_1.z.string().optional(),
@@ -89803,8 +89822,8 @@ function registerFunctionTools(server) {
         }
     };
     server.registerTool?.("queryFunctions", {
-        title: "查询云函数域资源",
-        description: "函数域统一只读入口。通过更自解释的 action 查询 CloudBase 云函数列表、函数详情、执行日志、层、触发器和代码下载地址。" +
+        title: "查询 CloudBase 云函数",
+        description: "CloudBase 云函数统一只读入口。通过更自解释的 action 查询 CloudBase 云函数列表、函数详情、执行日志、层、触发器和代码下载地址。" +
             "\n\n**分页说明**：`listFunctions`、`listLayers` 支持 `limit` 和 `offset` 参数。" +
             "\n- `limit`: 分页数量，默认值由后端决定" +
             "\n- `offset`: 分页偏移，从 0 开始" +
@@ -89864,8 +89883,8 @@ function registerFunctionTools(server) {
         },
     }, async (input) => withEnvelope(() => handleQueryFunctions(input)));
     server.registerTool?.("manageFunctions", {
-        title: "管理云函数域资源",
-        description: "函数域统一写入口。支持创建函数、更新代码、更新配置、调用函数、管理定时跑 / 定时任务 / scheduled job 的 timer 触发器和层绑定。" +
+        title: "管理 CloudBase 云函数",
+        description: "CloudBase 云函数统一写入口。支持创建函数、更新代码、更新配置、调用函数、管理定时跑 / 定时任务 / scheduled job 的 timer 触发器和层绑定。" +
             "如果要创建 cron 定时任务，先用 createFunction 创建函数，再用 createFunctionTrigger 创建 timer 触发器（支持7段cron表达式），deleteFunctionTrigger 删除触发器。" +
             "危险操作需要显式 confirm=true。",
         inputSchema: {
@@ -109107,10 +109126,10 @@ classDiagram
                 .default(false)
                 .describe("是否立即发布模型"),
             dbInstanceType: zod_1.z
-                .string()
+                .enum(["MYSQL", "FLEXDB"])
                 .optional()
                 .default("MYSQL")
-                .describe("数据库实例类型"),
+                .describe("数据库实例类型，可选值：MYSQL=MySQL 数据库，FLEXDB=文档型数据库（NoSQL）"),
         },
         annotations: {
             readOnlyHint: false,
@@ -117456,6 +117475,10 @@ const cloudbase_manager_js_1 = __webpack_require__(3431);
 const cloud_mode_js_1 = __webpack_require__(89684);
 const notification_js_1 = __webpack_require__(32720);
 const tool_result_js_1 = __webpack_require__(9835);
+const HOSTING_CDN_SWITCH_VALUES = ['on', 'off'];
+const HOSTING_REFERER_TYPES = ['blacklist', 'whitelist'];
+const HOSTING_CACHE_RULE_TYPES = ['fileType', 'path'];
+const HOSTING_IP_FILTER_TYPES = ['blacklist', 'whitelist'];
 const routingRuleSchema = zod_1.z.object({
     keyPrefixEquals: zod_1.z.string().optional().describe('匹配前缀规则，例如 app/ 或 assets/。与 httpErrorCodeReturnedEquals 二选一或按 CloudBase 规则组合使用。'),
     httpErrorCodeReturnedEquals: zod_1.z.string().optional().describe('匹配 HTTP 错误码，例如 404。SPA 回退常用 404。'),
@@ -117464,25 +117487,25 @@ const routingRuleSchema = zod_1.z.object({
 });
 const domainConfigSchema = zod_1.z.object({
     Refer: zod_1.z.object({
-        Switch: zod_1.z.string().describe('Referer 防盗链开关，例如 on/off。'),
+        Switch: zod_1.z.enum(HOSTING_CDN_SWITCH_VALUES).describe('Referer 防盗链开关：on=开启，off=关闭。'),
         RefererRules: zod_1.z.array(zod_1.z.object({
-            RefererType: zod_1.z.string().describe('Referer 规则类型。'),
+            RefererType: zod_1.z.enum(HOSTING_REFERER_TYPES).describe('Referer 规则类型：blacklist=黑名单，whitelist=白名单。'),
             Referers: zod_1.z.array(zod_1.z.string()).describe('Referer 规则值列表。'),
             AllowEmpty: zod_1.z.boolean().describe('是否允许空 Referer。'),
         })).optional().describe('Referer 规则列表。'),
     }).optional().describe('Referer 防盗链配置。'),
     Cache: zod_1.z.array(zod_1.z.object({
-        RuleType: zod_1.z.string().describe('缓存规则类型，例如 fileType/path。'),
+        RuleType: zod_1.z.enum(HOSTING_CACHE_RULE_TYPES).describe('缓存规则类型：fileType=文件类型，path=路径。'),
         RuleValue: zod_1.z.string().describe('规则匹配值。'),
         CacheTtl: zod_1.z.number().describe('缓存 TTL，单位秒。'),
     })).optional().describe('CDN 缓存规则列表。'),
     IpFilter: zod_1.z.object({
-        Switch: zod_1.z.string().describe('IP 访问控制开关，例如 on/off。'),
-        FilterType: zod_1.z.string().optional().describe('过滤类型，例如 blacklist/whitelist。'),
+        Switch: zod_1.z.enum(HOSTING_CDN_SWITCH_VALUES).describe('IP 访问控制开关：on=开启，off=关闭。'),
+        FilterType: zod_1.z.enum(HOSTING_IP_FILTER_TYPES).optional().describe('过滤类型：blacklist=黑名单，whitelist=白名单。'),
         Filters: zod_1.z.array(zod_1.z.string()).optional().describe('IP 规则列表。'),
     }).optional().describe('IP 访问控制配置。'),
     IpFreqLimit: zod_1.z.object({
-        Switch: zod_1.z.string().describe('IP 频控开关，例如 on/off。'),
+        Switch: zod_1.z.enum(HOSTING_CDN_SWITCH_VALUES).describe('IP 频控开关：on=开启，off=关闭。'),
         Qps: zod_1.z.number().optional().describe('每个 IP 的 QPS 上限。'),
     }).optional().describe('IP 频控配置。'),
 });
@@ -117793,7 +117816,7 @@ function registerHostingTools(server) {
     const cloudBaseOptions = server.cloudBaseOptions;
     const getManager = () => (0, cloudbase_manager_js_1.getCloudBaseManager)({ cloudBaseOptions });
     server.registerTool('queryHosting', {
-        title: '查询静态托管',
+        title: '查询 CloudBase 静态托管',
         description: '查询 CloudBase 静态托管的只读信息。适合 AI 先做发现再决定下一步：action=websiteConfig 查询首页/错误页/路由规则与站点域名信息；action=status 查询托管服务状态；action=findFiles 按前缀查找文件；action=listFiles 列出全部托管文件；action=domainStatus 查询自定义域名的当前状态与配置。该工具不会产生任何副作用。',
         inputSchema: queryHostingInputSchema,
         annotations: {
@@ -117932,7 +117955,7 @@ function registerHostingTools(server) {
         }
     });
     server.registerTool('manageHosting', {
-        title: '管理静态托管',
+        title: '管理 CloudBase 静态托管',
         description: '管理 CloudBase 静态托管的变更操作。action=upload 上传本地构建产物；action=delete 删除托管文件或目录（必须 confirm=true）；action=setWebsiteDocument 设置首页/错误页/路由规则；action=enableService 开通静态托管；action=bindDomain / unbindDomain / updateDomain 管理自定义域名；action=downloadFile / downloadDirectory 下载托管内容到本地。若任务只是查看配置、文件或域名状态，请改用 queryHosting。',
         inputSchema: manageHostingInputSchema,
         annotations: {
@@ -134908,7 +134931,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.20.0" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.20.2" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -193513,7 +193536,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.20.0" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.20.2" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -193594,7 +193617,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.20.0" : 0;
+            const mcpVersion =  true ? "2.20.2" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息
@@ -209553,7 +209576,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.20.0" : 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.20.2" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -226979,8 +227002,8 @@ function registerGatewayTools(server) {
         }
     };
     server.registerTool?.("queryGateway", {
-        title: "查询网关域资源",
-        description: "网关域统一只读入口。通过 action 查询网关域名、访问入口和目标暴露情况。",
+        title: "查询 CloudBase 网关",
+        description: "CloudBase 网关统一只读入口。通过 action 查询网关域名、访问入口和目标暴露情况。",
         inputSchema: {
             action: zod_1.z
                 .enum(QUERY_GATEWAY_ACTIONS)
@@ -227002,8 +227025,8 @@ function registerGatewayTools(server) {
         },
     }, async (input) => withEnvelope(() => handleQueryGateway(input)));
     server.registerTool?.("manageGateway", {
-        title: "管理网关域资源（含自定义域名绑定）",
-        description: "网关域统一写入口。通过 action 创建目标访问入口，后续承接更通用的网关配置能力。为已存在的 HTTP 云函数补默认域名访问时，通常使用 createAccess 并提供 targetType=\"function\"、targetName、type=\"HTTP\" 与期望 path。注意 createAccess 只创建网关入口，不会自动修改函数资源权限。⚠️ 如需绑定带 SSL 证书的自定义域名供公网 HTTPS 访问，使用 action=\"bindCustomDomain\"（需要 domain 和 certificateId 参数）；如需配置 CORS/安全域名（无证书），请使用 envDomainManagement 工具。",
+        title: "管理 CloudBase 网关",
+        description: "CloudBase 网关统一写入口。通过 action 创建目标访问入口，后续承接更通用的网关配置能力。为已存在的 HTTP 云函数补默认域名访问时，通常使用 createAccess 并提供 targetType=\"function\"、targetName、type=\"HTTP\" 与期望 path。注意 createAccess 只创建网关入口，不会自动修改函数资源权限。⚠️ 如需绑定带 SSL 证书的自定义域名供公网 HTTPS 访问，使用 action=\"bindCustomDomain\"（需要 domain 和 certificateId 参数）；如需配置 CORS/安全域名（无证书），请使用 envDomainManagement 工具。",
         inputSchema: {
             action: zod_1.z
                 .enum(MANAGE_GATEWAY_ACTIONS)
@@ -250601,8 +250624,8 @@ function registerStorageTools(server) {
     const getManager = () => (0, cloudbase_manager_js_1.getCloudBaseManager)({ cloudBaseOptions });
     // Tool 1: queryStorage - 查询存储信息（只读操作）
     server.registerTool("queryStorage", {
-        title: "查询存储信息",
-        description: "查询云存储信息，支持列出目录文件、获取文件信息、获取临时下载链接等只读操作。返回的文件信息包括文件名、大小、修改时间、下载链接等。注意：action=url 返回的 temporaryUrl 是临时签名链接，有效期由 maxAge 参数决定（默认1小时），不要当作永久公网地址使用。工具还会基于 DescribeEnvs 返回的 Storages[0].CdnDomain 推导出 publicUrl，⚠️ 警告：publicUrl 仅在存储桶 ACL 为公有读（所有用户可读）时才能被匿名访问；默认私有读写存储桶返回的 publicUrl 会 403，此时请继续使用 temporaryUrl 或先通过控制台/SDK 将目标路径设置为公有读。",
+        title: "查询 CloudBase 存储信息",
+        description: "查询 CloudBase 云存储信息，支持列出目录文件、获取文件信息、获取临时下载链接等只读操作。返回的文件信息包括文件名、大小、修改时间、下载链接等。注意：action=url 返回的 temporaryUrl 是临时签名链接，有效期由 maxAge 参数决定（默认1小时），不要当作永久公网地址使用。工具还会基于 DescribeEnvs 返回的 Storages[0].CdnDomain 推导出 publicUrl，⚠️ 警告：publicUrl 仅在存储桶 ACL 为公有读（所有用户可读）时才能被匿名访问；默认私有读写存储桶返回的 publicUrl 会 403，此时请继续使用 temporaryUrl 或先通过控制台/SDK 将目标路径设置为公有读。",
         inputSchema: queryStorageInputSchema,
         annotations: {
             readOnlyHint: true,
@@ -250730,8 +250753,8 @@ function registerStorageTools(server) {
     });
     // Tool 2: manageStorage - 管理存储文件（写操作）
     server.registerTool("manageStorage", {
-        title: "管理存储文件",
-        description: "管理云存储文件，仅用于 COS/Storage 对象，不用于静态网站托管。支持上传文件/目录、下载文件/目录、删除文件/目录等操作。删除操作需要设置force=true进行确认，防止误删除重要文件。注意：上传后返回的 temporaryUrl 是临时签名链接，1小时后过期，不要当作永久公网地址写入配置或持久化存储。工具还会基于 DescribeEnvs 返回的 Storages[0].CdnDomain 推导 publicUrl，⚠️ 警告：publicUrl 仅在存储桶 ACL 为公有读（所有用户可读）时才能被匿名访问；默认私有读写存储桶返回的 publicUrl 会 403，此时请继续使用 temporaryUrl 或先通过控制台/SDK 将目标路径设置为公有读。",
+        title: "管理 CloudBase 存储文件",
+        description: "管理 CloudBase 云存储文件，仅用于 COS/Storage 对象，不用于静态网站托管。支持上传文件/目录、下载文件/目录、删除文件/目录等操作。删除操作需要设置force=true进行确认，防止误删除重要文件。注意：上传后返回的 temporaryUrl 是临时签名链接，1小时后过期，不要当作永久公网地址写入配置或持久化存储。工具还会基于 DescribeEnvs 返回的 Storages[0].CdnDomain 推导 publicUrl，⚠️ 警告：publicUrl 仅在存储桶 ACL 为公有读（所有用户可读）时才能被匿名访问；默认私有读写存储桶返回的 publicUrl 会 403，此时请继续使用 temporaryUrl 或先通过控制台/SDK 将目标路径设置为公有读。",
         inputSchema: manageStorageInputSchema,
         annotations: {
             readOnlyHint: false,

package/dist/index.js

@@ -1123,8 +1123,8 @@ function registerEnvTools(server) {
     });
     // envQuery - 环境查询（合并 listEnvs + getEnvInfo + getEnvAuthDomains）
     server.registerTool?.("envQuery", {
-        title: "环境查询",
-        description: "查询云开发环境相关信息，支持查询环境列表、指定环境详情和安全域名。（原工具名：listEnvs/getEnvInfo/getEnvAuthDomains，为兼容旧AI规则可继续使用这些名称）当 action=list 时，会按 DescribeEnvs 语义做列表/筛选，标准返回字段为 EnvId、Alias、Status、EnvType、Region、PackageId、PackageName、IsDefault，并支持通过 fields 白名单裁剪这些字段；aliasExact=true 时会按别名精确筛选，避免把前缀相近的环境误当作候选；即使传入 envId，action=list 也只返回摘要，不会返回完整资源明细或 expiry。如需查询某个已知 EnvId 对应环境的详细信息（包括资源字段和计费信息），必须使用 action=info 并传入目标环境的 envId 参数。action=info 会在可用时补充 BillingInfo（如 ExpireTime、PayMode、IsAutoRenew 等计费字段）。",
+        title: "CloudBase 环境查询",
+        description: "查询 CloudBase 环境相关信息，支持查询环境列表、指定环境详情和安全域名。（原工具名：listEnvs/getEnvInfo/getEnvAuthDomains，为兼容旧AI规则可继续使用这些名称）当 action=list 时，会按 DescribeEnvs 语义做列表/筛选，标准返回字段为 EnvId、Alias、Status、EnvType、Region、PackageId、PackageName、IsDefault，并支持通过 fields 白名单裁剪这些字段；aliasExact=true 时会按别名精确筛选，避免把前缀相近的环境误当作候选；即使传入 envId，action=list 也只返回摘要，不会返回完整资源明细或 expiry。如需查询某个已知 EnvId 对应环境的详细信息（包括资源字段和计费信息），必须使用 action=info 并传入目标环境的 envId 参数。action=info 会在可用时补充 BillingInfo（如 ExpireTime、PayMode、IsAutoRenew 等计费字段）。",
         inputSchema: {
             action: zod_1.z
                 .enum(["list", "info", "domains"])
@@ -1328,8 +1328,8 @@ function registerEnvTools(server) {
     });
     // envDomainManagement - 环境域名管理（合并 createEnvDomain + deleteEnvDomain）
     server.registerTool?.("envDomainManagement", {
-        title: "环境域名管理（安全域名 / CORS 白名单）",
-        description: "管理云开发环境的安全域名（安全域名 / CORS 白名单），支持添加和删除操作。（原工具名：createEnvDomain/deleteEnvDomain，为兼容旧AI规则可继续使用这些名称）当浏览器 Web 应用需要从本地 Vite / dev server 直接访问 CloudBase 资源时，应先用 envQuery(action=domains) 检查当前实际浏览器 origin 对应的 host:port 是否已在白名单中，再按该实际值添加。新增或删除后通常需要继续轮询 envQuery(action=domains) 确认状态收敛；安全域名一般约 10 分钟生效。⚠️ 重要：此工具仅用于 CORS/请求来源验证，不涉及 SSL 证书。如需绑定自定义域名供公网 HTTPS 访问，请使用 manageGateway(action=\"bindCustomDomain\")。",
+        title: "CloudBase 环境域名管理（安全域名 / CORS 白名单）",
+        description: "管理 CloudBase 环境的安全域名（安全域名 / CORS 白名单），支持添加和删除操作。（原工具名：createEnvDomain/deleteEnvDomain，为兼容旧AI规则可继续使用这些名称）当浏览器 Web 应用需要从本地 Vite / dev server 直接访问 CloudBase 资源时，应先用 envQuery(action=domains) 检查当前实际浏览器 origin 对应的 host:port 是否已在白名单中，再按该实际值添加。新增或删除后通常需要继续轮询 envQuery(action=domains) 确认状态收敛；安全域名一般约 10 分钟生效。⚠️ 重要：此工具仅用于 CORS/请求来源验证，不涉及 SSL 证书。如需绑定自定义域名供公网 HTTPS 访问，请使用 manageGateway(action=\"bindCustomDomain\")。",
         inputSchema: {
             action: zod_1.z
                 .enum(["create", "delete"])
@@ -1703,7 +1703,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.20.0" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.20.2" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -1784,7 +1784,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.20.0" : 0;
+            const mcpVersion =  true ? "2.20.2" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息
@@ -5680,10 +5680,10 @@ classDiagram
                 .default(false)
                 .describe("是否立即发布模型"),
             dbInstanceType: zod_1.z
-                .string()
+                .enum(["MYSQL", "FLEXDB"])
                 .optional()
                 .default("MYSQL")
-                .describe("数据库实例类型"),
+                .describe("数据库实例类型，可选值：MYSQL=MySQL 数据库，FLEXDB=文档型数据库（NoSQL）"),
         },
         annotations: {
             readOnlyHint: false,
@@ -7042,8 +7042,8 @@ function registerGatewayTools(server) {
         }
     };
     server.registerTool?.("queryGateway", {
-        title: "查询网关域资源",
-        description: "网关域统一只读入口。通过 action 查询网关域名、访问入口和目标暴露情况。",
+        title: "查询 CloudBase 网关",
+        description: "CloudBase 网关统一只读入口。通过 action 查询网关域名、访问入口和目标暴露情况。",
         inputSchema: {
             action: zod_1.z
                 .enum(QUERY_GATEWAY_ACTIONS)
@@ -7065,8 +7065,8 @@ function registerGatewayTools(server) {
         },
     }, async (input) => withEnvelope(() => handleQueryGateway(input)));
     server.registerTool?.("manageGateway", {
-        title: "管理网关域资源（含自定义域名绑定）",
-        description: "网关域统一写入口。通过 action 创建目标访问入口，后续承接更通用的网关配置能力。为已存在的 HTTP 云函数补默认域名访问时，通常使用 createAccess 并提供 targetType=\"function\"、targetName、type=\"HTTP\" 与期望 path。注意 createAccess 只创建网关入口，不会自动修改函数资源权限。⚠️ 如需绑定带 SSL 证书的自定义域名供公网 HTTPS 访问，使用 action=\"bindCustomDomain\"（需要 domain 和 certificateId 参数）；如需配置 CORS/安全域名（无证书），请使用 envDomainManagement 工具。",
+        title: "管理 CloudBase 网关",
+        description: "CloudBase 网关统一写入口。通过 action 创建目标访问入口，后续承接更通用的网关配置能力。为已存在的 HTTP 云函数补默认域名访问时，通常使用 createAccess 并提供 targetType=\"function\"、targetName、type=\"HTTP\" 与期望 path。注意 createAccess 只创建网关入口，不会自动修改函数资源权限。⚠️ 如需绑定带 SSL 证书的自定义域名供公网 HTTPS 访问，使用 action=\"bindCustomDomain\"（需要 domain 和 certificateId 参数）；如需配置 CORS/安全域名（无证书），请使用 envDomainManagement 工具。",
         inputSchema: {
             action: zod_1.z
                 .enum(MANAGE_GATEWAY_ACTIONS)
@@ -7348,8 +7348,8 @@ function registerStorageTools(server) {
     const getManager = () => (0, cloudbase_manager_js_1.getCloudBaseManager)({ cloudBaseOptions });
     // Tool 1: queryStorage - 查询存储信息（只读操作）
     server.registerTool("queryStorage", {
-        title: "查询存储信息",
-        description: "查询云存储信息，支持列出目录文件、获取文件信息、获取临时下载链接等只读操作。返回的文件信息包括文件名、大小、修改时间、下载链接等。注意：action=url 返回的 temporaryUrl 是临时签名链接，有效期由 maxAge 参数决定（默认1小时），不要当作永久公网地址使用。工具还会基于 DescribeEnvs 返回的 Storages[0].CdnDomain 推导出 publicUrl，⚠️ 警告：publicUrl 仅在存储桶 ACL 为公有读（所有用户可读）时才能被匿名访问；默认私有读写存储桶返回的 publicUrl 会 403，此时请继续使用 temporaryUrl 或先通过控制台/SDK 将目标路径设置为公有读。",
+        title: "查询 CloudBase 存储信息",
+        description: "查询 CloudBase 云存储信息，支持列出目录文件、获取文件信息、获取临时下载链接等只读操作。返回的文件信息包括文件名、大小、修改时间、下载链接等。注意：action=url 返回的 temporaryUrl 是临时签名链接，有效期由 maxAge 参数决定（默认1小时），不要当作永久公网地址使用。工具还会基于 DescribeEnvs 返回的 Storages[0].CdnDomain 推导出 publicUrl，⚠️ 警告：publicUrl 仅在存储桶 ACL 为公有读（所有用户可读）时才能被匿名访问；默认私有读写存储桶返回的 publicUrl 会 403，此时请继续使用 temporaryUrl 或先通过控制台/SDK 将目标路径设置为公有读。",
         inputSchema: queryStorageInputSchema,
         annotations: {
             readOnlyHint: true,
@@ -7477,8 +7477,8 @@ function registerStorageTools(server) {
     });
     // Tool 2: manageStorage - 管理存储文件（写操作）
     server.registerTool("manageStorage", {
-        title: "管理存储文件",
-        description: "管理云存储文件，仅用于 COS/Storage 对象，不用于静态网站托管。支持上传文件/目录、下载文件/目录、删除文件/目录等操作。删除操作需要设置force=true进行确认，防止误删除重要文件。注意：上传后返回的 temporaryUrl 是临时签名链接，1小时后过期，不要当作永久公网地址写入配置或持久化存储。工具还会基于 DescribeEnvs 返回的 Storages[0].CdnDomain 推导 publicUrl，⚠️ 警告：publicUrl 仅在存储桶 ACL 为公有读（所有用户可读）时才能被匿名访问；默认私有读写存储桶返回的 publicUrl 会 403，此时请继续使用 temporaryUrl 或先通过控制台/SDK 将目标路径设置为公有读。",
+        title: "管理 CloudBase 存储文件",
+        description: "管理 CloudBase 云存储文件，仅用于 COS/Storage 对象，不用于静态网站托管。支持上传文件/目录、下载文件/目录、删除文件/目录等操作。删除操作需要设置force=true进行确认，防止误删除重要文件。注意：上传后返回的 temporaryUrl 是临时签名链接，1小时后过期，不要当作永久公网地址写入配置或持久化存储。工具还会基于 DescribeEnvs 返回的 Storages[0].CdnDomain 推导 publicUrl，⚠️ 警告：publicUrl 仅在存储桶 ACL 为公有读（所有用户可读）时才能被匿名访问；默认私有读写存储桶返回的 publicUrl 会 403，此时请继续使用 temporaryUrl 或先通过控制台/SDK 将目标路径设置为公有读。",
         inputSchema: manageStorageInputSchema,
         annotations: {
             readOnlyHint: false,
@@ -8632,6 +8632,22 @@ const MANAGE_APP_AUTH_ACTIONS = [
     "createCustomLoginKeys",
 ];
 const APP_AUTH_KEY_TYPES = ["publish_key", "api_key"];
+const APP_AUTH_PROVIDER_TYPES = [
+    "OAUTH",
+    "OIDC",
+    "SAML",
+    "WX_MICRO_APP",
+    "WX_QRCODE_MICRO_APP",
+    "WX_CLOUDBASE_MICRO_APP",
+    "WX_MP",
+    "WX_OPEN",
+    "WX_WORK_INTERNAL",
+    "WX_WORK_AGENT",
+    "WX_WORK_THIRD_PARTY",
+    "WX_WORK_THIRD_PARTY_ASSOCIATION",
+    "CUSTOM",
+    "EMAIL",
+];
 const SUPABASE_LIKE_SDK_HINTS = {
     phoneOtp: "auth.signInWithOtp({ phone })",
     emailOtp: "auth.signInWithOtp({ email })",
@@ -8877,8 +8893,8 @@ function registerAppAuthTools(server) {
         };
     };
     server.registerTool?.("queryAppAuth", {
-        title: "查询应用认证配置",
-        description: "应用侧认证配置只读入口。用于查询登录方式、provider、publishable key、API key、client 配置和静态域名等认证准备状态。⚠️ 本工具为管理端配置查询工具，不执行用户登录。当任务要求编写客户端登录代码时（例如「用 JS SDK 登录」），应先通过本工具确认配置状态，再在项目代码中编写 @cloudbase/js-sdk 客户端登录代码（如 auth.signInWithPassword()），而非使用本工具完成登录。若业务要接受普通用户名样式标识符，先查询 action=getLoginConfig；若 usernamePassword=false，下一步应立即调用 manageAppAuth(action=patchLoginStrategy, patch={ usernamePassword: true })，不要直接写 email 登录 API。",
+        title: "查询 CloudBase 应用认证配置",
+        description: "CloudBase 应用侧认证配置只读入口。用于查询登录方式、provider、publishable key、API key、client 配置和静态域名等认证准备状态。⚠️ 本工具为管理端配置查询工具，不执行用户登录。当任务要求编写客户端登录代码时（例如「用 JS SDK 登录」），应先通过本工具确认配置状态，再在项目代码中编写 @cloudbase/js-sdk 客户端登录代码（如 auth.signInWithPassword()），而非使用本工具完成登录。若业务要接受普通用户名样式标识符，先查询 action=getLoginConfig；若 usernamePassword=false，下一步应立即调用 manageAppAuth(action=patchLoginStrategy, patch={ usernamePassword: true })，不要直接写 email 登录 API。",
         inputSchema: {
             action: zod_1.z.enum(QUERY_APP_AUTH_ACTIONS),
             providerId: zod_1.z.string().optional().describe("provider 标识，如 email、google"),
@@ -8988,8 +9004,8 @@ function registerAppAuthTools(server) {
         }
     }));
     server.registerTool?.("manageAppAuth", {
-        title: "管理应用认证配置",
-        description: "应用侧认证配置写入口。用于修改登录方式、provider、client 配置，确保 publishable key，以及创建或删除 API key、自定义登录密钥。⚠️ 本工具为管理端配置工具，不执行用户登录。当任务要求编写客户端登录代码时（例如「用 JS SDK 登录」），应先通过本工具完成配置（如启用 usernamePassword、获取 publishable key），再在项目代码中编写 @cloudbase/js-sdk 客户端登录代码（如 auth.signInWithPassword()），而非使用本工具完成登录。若前端要接受普通用户名样式标识符，应先执行 action=patchLoginStrategy 并传入 patch={ usernamePassword: true }，再实现对应前端登录逻辑。",
+        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 }，再实现对应前端登录逻辑。",
         inputSchema: {
             action: zod_1.z.enum(MANAGE_APP_AUTH_ACTIONS),
             patch: zod_1.z
@@ -8997,7 +9013,10 @@ function registerAppAuthTools(server) {
                 .optional()
                 .describe("patchLoginStrategy 使用的简化登录策略 patch，如 { usernamePassword: true }"),
             providerId: zod_1.z.string().optional().describe("provider 标识，如 email、google；addProvider 时也可作为自定义 provider Id"),
-            providerType: zod_1.z.string().optional().describe("addProvider 时的 provider 协议类型，如 OAUTH、OIDC、EMAIL"),
+            providerType: zod_1.z
+                .enum(APP_AUTH_PROVIDER_TYPES)
+                .optional()
+                .describe("addProvider 时的 provider 协议类型"),
             displayName: zod_1.z
                 .union([zod_1.z.string(), zod_1.z.record(zod_1.z.any())])
                 .optional()
@@ -9256,7 +9275,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.20.0" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.20.2" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -10616,8 +10635,8 @@ function registerFunctionTools(server) {
         }
     };
     server.registerTool?.("queryFunctions", {
-        title: "查询云函数域资源",
-        description: "函数域统一只读入口。通过更自解释的 action 查询 CloudBase 云函数列表、函数详情、执行日志、层、触发器和代码下载地址。" +
+        title: "查询 CloudBase 云函数",
+        description: "CloudBase 云函数统一只读入口。通过更自解释的 action 查询 CloudBase 云函数列表、函数详情、执行日志、层、触发器和代码下载地址。" +
             "\n\n**分页说明**：`listFunctions`、`listLayers` 支持 `limit` 和 `offset` 参数。" +
             "\n- `limit`: 分页数量，默认值由后端决定" +
             "\n- `offset`: 分页偏移，从 0 开始" +
@@ -10677,8 +10696,8 @@ function registerFunctionTools(server) {
         },
     }, async (input) => withEnvelope(() => handleQueryFunctions(input)));
     server.registerTool?.("manageFunctions", {
-        title: "管理云函数域资源",
-        description: "函数域统一写入口。支持创建函数、更新代码、更新配置、调用函数、管理定时跑 / 定时任务 / scheduled job 的 timer 触发器和层绑定。" +
+        title: "管理 CloudBase 云函数",
+        description: "CloudBase 云函数统一写入口。支持创建函数、更新代码、更新配置、调用函数、管理定时跑 / 定时任务 / scheduled job 的 timer 触发器和层绑定。" +
             "如果要创建 cron 定时任务，先用 createFunction 创建函数，再用 createFunctionTrigger 创建 timer 触发器（支持7段cron表达式），deleteFunctionTrigger 删除触发器。" +
             "危险操作需要显式 confirm=true。",
         inputSchema: {
@@ -11812,7 +11831,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.20.0" : 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.20.2" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -12755,6 +12774,10 @@ const cloudbase_manager_js_1 = __webpack_require__(3431);
 const cloud_mode_js_1 = __webpack_require__(9684);
 const notification_js_1 = __webpack_require__(2720);
 const tool_result_js_1 = __webpack_require__(9835);
+const HOSTING_CDN_SWITCH_VALUES = ['on', 'off'];
+const HOSTING_REFERER_TYPES = ['blacklist', 'whitelist'];
+const HOSTING_CACHE_RULE_TYPES = ['fileType', 'path'];
+const HOSTING_IP_FILTER_TYPES = ['blacklist', 'whitelist'];
 const routingRuleSchema = zod_1.z.object({
     keyPrefixEquals: zod_1.z.string().optional().describe('匹配前缀规则，例如 app/ 或 assets/。与 httpErrorCodeReturnedEquals 二选一或按 CloudBase 规则组合使用。'),
     httpErrorCodeReturnedEquals: zod_1.z.string().optional().describe('匹配 HTTP 错误码，例如 404。SPA 回退常用 404。'),
@@ -12763,25 +12786,25 @@ const routingRuleSchema = zod_1.z.object({
 });
 const domainConfigSchema = zod_1.z.object({
     Refer: zod_1.z.object({
-        Switch: zod_1.z.string().describe('Referer 防盗链开关，例如 on/off。'),
+        Switch: zod_1.z.enum(HOSTING_CDN_SWITCH_VALUES).describe('Referer 防盗链开关：on=开启，off=关闭。'),
         RefererRules: zod_1.z.array(zod_1.z.object({
-            RefererType: zod_1.z.string().describe('Referer 规则类型。'),
+            RefererType: zod_1.z.enum(HOSTING_REFERER_TYPES).describe('Referer 规则类型：blacklist=黑名单，whitelist=白名单。'),
             Referers: zod_1.z.array(zod_1.z.string()).describe('Referer 规则值列表。'),
             AllowEmpty: zod_1.z.boolean().describe('是否允许空 Referer。'),
         })).optional().describe('Referer 规则列表。'),
     }).optional().describe('Referer 防盗链配置。'),
     Cache: zod_1.z.array(zod_1.z.object({
-        RuleType: zod_1.z.string().describe('缓存规则类型，例如 fileType/path。'),
+        RuleType: zod_1.z.enum(HOSTING_CACHE_RULE_TYPES).describe('缓存规则类型：fileType=文件类型，path=路径。'),
         RuleValue: zod_1.z.string().describe('规则匹配值。'),
         CacheTtl: zod_1.z.number().describe('缓存 TTL，单位秒。'),
     })).optional().describe('CDN 缓存规则列表。'),
     IpFilter: zod_1.z.object({
-        Switch: zod_1.z.string().describe('IP 访问控制开关，例如 on/off。'),
-        FilterType: zod_1.z.string().optional().describe('过滤类型，例如 blacklist/whitelist。'),
+        Switch: zod_1.z.enum(HOSTING_CDN_SWITCH_VALUES).describe('IP 访问控制开关：on=开启，off=关闭。'),
+        FilterType: zod_1.z.enum(HOSTING_IP_FILTER_TYPES).optional().describe('过滤类型：blacklist=黑名单，whitelist=白名单。'),
         Filters: zod_1.z.array(zod_1.z.string()).optional().describe('IP 规则列表。'),
     }).optional().describe('IP 访问控制配置。'),
     IpFreqLimit: zod_1.z.object({
-        Switch: zod_1.z.string().describe('IP 频控开关，例如 on/off。'),
+        Switch: zod_1.z.enum(HOSTING_CDN_SWITCH_VALUES).describe('IP 频控开关：on=开启，off=关闭。'),
         Qps: zod_1.z.number().optional().describe('每个 IP 的 QPS 上限。'),
     }).optional().describe('IP 频控配置。'),
 });
@@ -13092,7 +13115,7 @@ function registerHostingTools(server) {
     const cloudBaseOptions = server.cloudBaseOptions;
     const getManager = () => (0, cloudbase_manager_js_1.getCloudBaseManager)({ cloudBaseOptions });
     server.registerTool('queryHosting', {
-        title: '查询静态托管',
+        title: '查询 CloudBase 静态托管',
         description: '查询 CloudBase 静态托管的只读信息。适合 AI 先做发现再决定下一步：action=websiteConfig 查询首页/错误页/路由规则与站点域名信息；action=status 查询托管服务状态；action=findFiles 按前缀查找文件；action=listFiles 列出全部托管文件；action=domainStatus 查询自定义域名的当前状态与配置。该工具不会产生任何副作用。',
         inputSchema: queryHostingInputSchema,
         annotations: {
@@ -13231,7 +13254,7 @@ function registerHostingTools(server) {
         }
     });
     server.registerTool('manageHosting', {
-        title: '管理静态托管',
+        title: '管理 CloudBase 静态托管',
         description: '管理 CloudBase 静态托管的变更操作。action=upload 上传本地构建产物；action=delete 删除托管文件或目录（必须 confirm=true）；action=setWebsiteDocument 设置首页/错误页/路由规则；action=enableService 开通静态托管；action=bindDomain / unbindDomain / updateDomain 管理自定义域名；action=downloadFile / downloadDirectory 下载托管内容到本地。若任务只是查看配置、文件或域名状态，请改用 queryHosting。',
         inputSchema: manageHostingInputSchema,
         annotations: {
@@ -14578,8 +14601,8 @@ function registerAgentTools(server) {
     const cloudBaseOptions = server.cloudBaseOptions;
     const getManager = () => (0, cloudbase_manager_js_1.getCloudBaseManager)({ cloudBaseOptions });
     server.registerTool?.("queryAgents", {
-        title: "查询 Agent",
-        description: "Agent 域统一只读入口。支持列表、详情与日志查询。",
+        title: "查询 CloudBase Agent",
+        description: "CloudBase Agent 域统一只读入口。支持列表、详情与日志查询。",
         inputSchema: {
             action: zod_1.z.enum(QUERY_AGENT_ACTIONS),
             agentId: zod_1.z.string().optional(),
@@ -14641,8 +14664,8 @@ function registerAgentTools(server) {
         }
     });
     server.registerTool?.("manageAgents", {
-        title: "管理 Agent",
-        description: "Agent 域统一写入口。支持创建、更新和删除远端 Agent。",
+        title: "管理 CloudBase Agent",
+        description: "CloudBase Agent 域统一写入口。支持创建、更新和删除远端 Agent。",
         inputSchema: {
             action: zod_1.z.enum(MANAGE_AGENT_ACTIONS),
             agentId: zod_1.z.string().optional(),

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@cloudbase/cloudbase-mcp",
-  "version": "2.20.0",
+  "version": "2.20.2",
+  "packageManager": "pnpm@10.8.0",
   "description": "腾讯云开发 MCP Server，通过AI提示词和MCP协议+云开发，让开发更智能、更高效,当你在Cursor/ VSCode GitHub Copilot/WinSurf/CodeBuddy/Augment Code/Claude Code等AI编程工具里写代码时，它能自动帮你生成可直接部署的前后端应用+小程序，并一键发布到腾讯云开发 CloudBase。",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",