@cloudbase/cloudbase-mcp 2.21.1-beta.0 → 2.21.1-beta.2

package/dist/index.d.ts

@@ -392,7 +392,7 @@ export { StdioServerTransport }
  *
  * - listFiles / getFileInfo / downloadFile：queryStorage 只读操作
  * - uploadFile / deleteFiles / deleteDirectory：manageStorage 写操作
- * 无需 override 的：getTemporaryUrl（通过 CAPI DescribeEnvs 推导，已可走 requestFn）
+ * - getFileUrl：获取文件临时下载链接（可选，未提供时使用 CAPI 默认实现）
  */
 declare interface StorageOverrides {
     /** 列出目录下的文件，替代 storageService.listDirectoryFiles() */
@@ -423,6 +423,17 @@ declare interface StorageOverrides {
         localPath: string;
         cloudPath: string;
     }) => Promise<void>;
+    /**
+     * 获取文件临时下载链接，替代 storageService.getTemporaryUrl()
+     * 可通过 COS getObjectUrl 实现；未提供时走 manager-node 默认路径
+     */
+    getFileUrl?: (params: {
+        cloudPath: string;
+        maxAge?: number;
+    }) => Promise<{
+        url: string;
+        fileId?: string;
+    }>;
     /** 删除文件（支持批量），替代 storageService.deleteFile() */
     deleteFiles?: (params: {
         cloudPaths: string[];

package/dist/index.js

@@ -9394,29 +9394,7 @@ function registerEnvTools(server) {
         });
     } // end: wxide guard for auth tool
     // queryEnv - 环境查询（合并 listEnvs + getEnvInfo + getEnvAuthDomains）
-    server.registerTool?.("queryEnv", {
-        title: "CloudBase 环境查询",
-        description: "查询 CloudBase 环境相关信息，支持查询环境列表、指定环境详情和安全域名。（曾用名：envQuery、listEnvs、getEnvInfo、getEnvAuthDomains）当 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"])
-                .describe("查询类型：list=环境列表/摘要筛选（按 DescribeEnvs 语义筛选，支持通过 envId 筛选，返回 EnvId、Alias、Status、EnvType、Region、PackageId、PackageName、IsDefault，不支持 expiry），info=指定环境的详细信息（必须传入 envId，返回资源字段和计费信息），domains=安全域名列表"),
-            alias: zod_1.z.string().optional().describe("按环境别名筛选。action=list 时可选"),
-            aliasExact: zod_1.z.boolean().optional().describe("按环境别名精确筛选。action=list 时可选；与 alias 配合使用"),
-            envId: zod_1.z.string().optional().describe("按环境 ID 筛选。action=list 时可选（仅按 DescribeEnvs 语义做筛选，仍返回摘要）；action=info 时必填（返回该环境的详细信息，包含资源字段和计费信息）。如果任务已经给出了明确的 EnvId 并要求查询详情，请直接使用 action=info + envId，而不是 action=list"),
-            limit: zod_1.z.number().int().positive().optional().describe("返回数量上限。action=list 时可选"),
-            offset: zod_1.z.number().int().min(0).optional().describe("分页偏移。action=list 时可选"),
-            fields: zod_1.z
-                .array(zod_1.z.enum(DEFAULT_ENV_FIELDS))
-                .optional()
-                .describe("返回字段白名单。仅支持 EnvId、Alias、Status、EnvType、Region、PackageId、PackageName、IsDefault。action=list 时可选"),
-        },
-        annotations: {
-            readOnlyHint: true,
-            openWorldHint: true,
-            category: "env",
-        },
-    }, async ({ action, alias, aliasExact, envId, limit, offset, fields, }) => {
+    const queryEnvHandler = async ({ action, alias, aliasExact, envId, limit, offset, fields, }) => {
         try {
             let result;
             switch (action) {
@@ -9598,7 +9576,34 @@ function registerEnvTools(server) {
                 ],
             };
         }
-    });
+    };
+    // Register primary tool name (queryEnv)
+    const queryEnvToolSchema = {
+        title: "CloudBase 环境查询",
+        description: "查询 CloudBase 环境相关信息，支持查询环境列表、指定环境详情和安全域名。（曾用名：envQuery、listEnvs、getEnvInfo、getEnvAuthDomains）当 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"])
+                .describe("查询类型：list=环境列表/摘要筛选（按 DescribeEnvs 语义筛选，支持通过 envId 筛选，返回 EnvId、Alias、Status、EnvType、Region、PackageId、PackageName、IsDefault，不支持 expiry），info=指定环境的详细信息（必须传入 envId，返回资源字段和计费信息），domains=安全域名列表"),
+            alias: zod_1.z.string().optional().describe("按环境别名筛选。action=list 时可选"),
+            aliasExact: zod_1.z.boolean().optional().describe("按环境别名精确筛选。action=list 时可选；与 alias 配合使用"),
+            envId: zod_1.z.string().optional().describe("按环境 ID 筛选。action=list 时可选（仅按 DescribeEnvs 语义做筛选，仍返回摘要）；action=info 时必填（返回该环境的详细信息，包含资源字段和计费信息）。如果任务已经给出了明确的 EnvId 并要求查询详情，请直接使用 action=info + envId，而不是 action=list"),
+            limit: zod_1.z.number().int().positive().optional().describe("返回数量上限。action=list 时可选"),
+            offset: zod_1.z.number().int().min(0).optional().describe("分页偏移。action=list 时可选"),
+            fields: zod_1.z
+                .array(zod_1.z.enum(DEFAULT_ENV_FIELDS))
+                .optional()
+                .describe("返回字段白名单。仅支持 EnvId、Alias、Status、EnvType、Region、PackageId、PackageName、IsDefault。action=list 时可选"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            category: "env",
+        },
+    };
+    server.registerTool?.("queryEnv", queryEnvToolSchema, queryEnvHandler);
+    // 向后兼容：envQuery 作为 queryEnv 的别名注册
+    server.registerTool?.("envQuery", queryEnvToolSchema, queryEnvHandler);
     // envDomainManagement - 环境域名管理（合并 createEnvDomain + deleteEnvDomain）
     // 微信 IDE 场景不需要域名管理
     if (server.ide !== 'wxide') {
@@ -10842,7 +10847,7 @@ function registerFunctionTools(server) {
         inputSchema: {
             action: zod_1.z
                 .enum(exports.MANAGE_FUNCTION_ACTIONS)
-                .describe("写操作类型，例如 createFunction、updateFunctionCode、invokeFunction、deleteFunction、" +
+                .describe("写操作类型，例如 createFunction、updateFunctionCode、incrementalDeployFunction、invokeFunction、deleteFunction、" +
                 "createFunctionTrigger（定时任务 / cron / timer）、deleteFunctionTrigger、attachLayer、detachLayer"),
             func: CREATE_FUNCTION_SCHEMA.optional().describe("createFunction 操作的函数配置"),
             functionRootPath: zod_1.z.string().optional().describe("创建或更新函数代码时默认推荐的本地目录方式。" +
@@ -10878,6 +10883,7 @@ function registerFunctionTools(server) {
                 .describe("updateFunctionLayers 的目标层列表，顺序即最终顺序"),
             codeSecret: zod_1.z.string().optional().describe("层绑定时的代码保护密钥"),
             confirm: zod_1.z.boolean().optional().describe("危险操作确认开关。deleteFunction、deleteFunctionTrigger、deleteLayerVersion、detachLayer 等删除类操作需要显式传入 confirm=true"),
+            incrementalFile: zod_1.z.string().optional().describe("incrementalDeployFunction 增量部署时的变更文件路径"),
         },
         annotations: {
             readOnlyHint: false,
@@ -11704,13 +11710,16 @@ async function resolveHostingStaticDomain(cloudbase, logger) {
         return undefined;
     }
 }
-async function assertHostingUploadEnvironmentReady(cloudbase, cloudBaseOptions, logger) {
+// Returns the first hosting store record from DescribeStaticStore, which is
+// the authoritative source for Mini Program-sourced environments (those envs
+// do not populate StaticStorages in DescribeEnvs / getEnvInfo).
+// Throws when no valid store is found so upload can fail fast with a clear msg.
+async function getHostingStoreOrThrow(cloudbase, cloudBaseOptions, logger) {
     const envId = await (0, cloudbase_manager_js_1.getEnvId)(cloudBaseOptions);
-    const envInfo = await cloudbase.env.getEnvInfo();
-    (0, cloudbase_manager_js_1.logCloudBaseResult)(logger, envInfo);
-    const staticStorage = envInfo.EnvInfo?.StaticStorages?.[0];
-    if (staticStorage?.Bucket) {
-        return;
+    const result = await callTcbHostingAction(cloudbase, 'DescribeStaticStore', { EnvId: envId }, logger);
+    const hostingInfo = extractStaticStores(result);
+    if (hostingInfo.length > 0 && hostingInfo[0].Bucket) {
+        return hostingInfo[0];
     }
     throw new Error(`当前环境 ${envId} 未发现静态托管资源配置，无法上传文件。请先确认 MCP 已绑定到已开通静态托管的 CloudBase 环境；如需切换环境，请调用 auth(action="set_env", envId="目标环境ID") 后重试。`);
 }
@@ -11918,8 +11927,9 @@ function registerHostingTools(server) {
                         throw new Error('manageHosting(action="upload") 需要提供 localPath + cloudPath，或提供 files 多文件上传列表。');
                     }
                     let result;
+                    let store;
                     try {
-                        await assertHostingUploadEnvironmentReady(cloudbase, cloudBaseOptions, server.logger);
+                        store = await getHostingStoreOrThrow(cloudbase, cloudBaseOptions, server.logger);
                         result = await cloudbase.hosting.uploadFiles({
                             localPath: input.localPath,
                             cloudPath: input.cloudPath,
@@ -11931,7 +11941,11 @@ function registerHostingTools(server) {
                         throw new Error(buildUploadErrorMessage(error, input.localPath));
                     }
                     (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, result);
-                    const staticDomain = await resolveHostingStaticDomain(cloudbase, server.logger);
+                    // Prefer CdnDomain from the DescribeStaticStore result we already
+                    // fetched; fall back to getEnvInfo for environments that populate
+                    // StaticDomain there but not in DescribeStaticStore.
+                    const cdnFromStore = (store.CdnDomain ?? store.StaticDomain);
+                    const staticDomain = cdnFromStore || await resolveHostingStaticDomain(cloudbase, server.logger);
                     const accessUrl = buildHostingAccessUrl(staticDomain, input.cloudPath, input.localPath);
                     try {
                         const envId = await (0, cloudbase_manager_js_1.getEnvId)(cloudBaseOptions);
@@ -14181,7 +14195,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.21.1-beta.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.21.1-beta.2" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -14554,10 +14568,24 @@ function registerStorageTools(server) {
                 };
             }
             case 'url': {
-                const result = await storageService.getTemporaryUrl([{
+                let temporaryUrl = "";
+                let fileId = "";
+                if (storageOverrides?.getFileUrl) {
+                    const urlResult = await storageOverrides.getFileUrl({
                         cloudPath: input.cloudPath,
-                        maxAge: input.maxAge || 3600
-                    }]);
+                        maxAge: input.maxAge || 3600,
+                    });
+                    temporaryUrl = urlResult.url;
+                    fileId = urlResult.fileId || "";
+                }
+                else {
+                    const result = await storageService.getTemporaryUrl([{
+                            cloudPath: input.cloudPath,
+                            maxAge: input.maxAge || 3600
+                        }]);
+                    temporaryUrl = result[0]?.url || "";
+                    fileId = result[0]?.fileId || "";
+                }
                 const publicAccess = await resolveStoragePublicAccess({
                     cloudPath: input.cloudPath,
                     cloudBaseOptions,
@@ -14572,9 +14600,9 @@ function registerStorageTools(server) {
                                 data: {
                                     action: 'url',
                                     cloudPath: input.cloudPath,
-                                    temporaryUrl: result[0]?.url || "",
+                                    temporaryUrl,
                                     expireTime: `${input.maxAge || 3600}秒`,
-                                    fileId: result[0]?.fileId || "",
+                                    fileId,
                                     storageCdnDomain: publicAccess.storageCdnDomain,
                                     publicUrl: publicAccess.publicUrl,
                                     note: "temporaryUrl 是临时签名链接，会按 expireTime 过期。publicUrl 基于 DescribeEnvs 返回的 Storages[0].CdnDomain 推导，⚠️ 仅在存储桶 ACL 为公有读（所有用户可读）时才能被匿名访问；默认私有读写存储桶返回的 publicUrl 会 403，此时请继续使用 temporaryUrl 或先将目标路径设置为公有读。"
@@ -14679,15 +14707,42 @@ function registerStorageTools(server) {
                         });
                     }
                 }
-                const fileUrls = await storageService.getTemporaryUrl([{
+                // 上传成功后获取临时 URL 和公网访问信息
+                let temporaryUrl = "";
+                let fileId = "";
+                if (storageOverrides?.getFileUrl) {
+                    const urlResult = await storageOverrides.getFileUrl({
                         cloudPath: input.cloudPath,
-                        maxAge: 3600
-                    }]);
-                const publicAccess = await resolveStoragePublicAccess({
-                    cloudPath: input.cloudPath,
-                    cloudBaseOptions,
-                    manager,
-                });
+                        maxAge: 3600,
+                    });
+                    temporaryUrl = urlResult.url;
+                    fileId = urlResult.fileId || "";
+                }
+                else {
+                    try {
+                        const fileUrls = await storageService.getTemporaryUrl([{
+                                cloudPath: input.cloudPath,
+                                maxAge: 3600
+                            }]);
+                        temporaryUrl = fileUrls[0]?.url || "";
+                        fileId = fileUrls[0]?.fileId || "";
+                    }
+                    catch {
+                        // StorageOverrides 下 getTemporaryUrl 可能不可用
+                    }
+                }
+                let publicAccess = {};
+                try {
+                    publicAccess = await resolveStoragePublicAccess({
+                        cloudPath: input.cloudPath,
+                        cloudBaseOptions,
+                        manager,
+                    });
+                }
+                catch {
+                    // DescribeEnvs 可能不支持（IDE 模式下会绕过）
+                    publicAccess = {};
+                }
                 return {
                     content: [
                         {
@@ -14699,7 +14754,7 @@ function registerStorageTools(server) {
                                     localPath: input.localPath,
                                     cloudPath: input.cloudPath,
                                     isDirectory: input.isDirectory,
-                                    temporaryUrl: fileUrls[0]?.url || "",
+                                    temporaryUrl,
                                     expireTime: "1小时",
                                     storageCdnDomain: publicAccess.storageCdnDomain,
                                     publicUrl: publicAccess.publicUrl,
@@ -15347,7 +15402,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.21.1-beta.0" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.21.1-beta.2" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -15766,7 +15821,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.21.1-beta.0" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.21.1-beta.2" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -15847,7 +15902,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.21.1-beta.0" : 0;
+            const mcpVersion =  true ? "2.21.1-beta.2" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/cloudbase-mcp",
-  "version": "2.21.1-beta.0",
+  "version": "2.21.1-beta.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",