@cloudbase/cloudbase-mcp 2.24.0 → 2.24.1

package/dist/index.js

@@ -30,6 +30,8 @@ import * as __WEBPACK_EXTERNAL_MODULE_winston__ from "winston";
 
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.DEFAULT_CREATE_ENV_RESOURCES = exports.CREATE_ENV_RESOURCE_VALUES = void 0;
+exports.resolveCreateEnvResources = resolveCreateEnvResources;
 exports.simplifyEnvList = simplifyEnvList;
 exports.registerEnvTools = registerEnvTools;
 const toolbox_1 = __webpack_require__(2090);
@@ -39,6 +41,26 @@ const cloudbase_manager_js_1 = __webpack_require__(3431);
 const logger_js_1 = __webpack_require__(3039);
 const tool_result_js_1 = __webpack_require__(9835);
 const env_setup_js_1 = __webpack_require__(6978);
+/**
+ * Resources accepted by CreateEnv. Matches Cloud API / Manager SDK contract.
+ * `postgresql` enables CloudBase PostgreSQL (PG mode) when supported by the package.
+ */
+exports.CREATE_ENV_RESOURCE_VALUES = [
+    "flexdb",
+    "storage",
+    "function",
+    "postgresql",
+];
+/** Default Resources when callers omit the field (schema promises "all four"). */
+exports.DEFAULT_CREATE_ENV_RESOURCES = [
+    ...exports.CREATE_ENV_RESOURCE_VALUES,
+];
+function resolveCreateEnvResources(resources) {
+    if (Array.isArray(resources) && resources.length > 0) {
+        return [...resources];
+    }
+    return [...exports.DEFAULT_CREATE_ENV_RESOURCES];
+}
 /**
  * Simplify environment list data by keeping only essential fields for AI assistant
  * This reduces token consumption when returning environment lists via MCP tools
@@ -804,7 +826,13 @@ function resolveToolAuthOptions(server, overrides) {
 function registerEnvTools(server) {
     // 获取 cloudBaseOptions，如果没有则为 undefined
     const cloudBaseOptions = server.cloudBaseOptions;
-    const getManager = () => (0, cloudbase_manager_js_1.getCloudBaseManager)({ cloudBaseOptions, mcpServer: server });
+    // Default: env-scoped tools need a bound envId (domains / domain management use SDK this.envId).
+    // manageEnv create/listPackages are account-level — use requireEnvId: false there only.
+    const getManager = (options) => (0, cloudbase_manager_js_1.getCloudBaseManager)({
+        cloudBaseOptions,
+        requireEnvId: options?.requireEnvId ?? true,
+        mcpServer: server,
+    });
     const getManagerForEnvQuery = (targetEnvId, requireEnvId = true) => (0, cloudbase_manager_js_1.getCloudBaseManager)({
         cloudBaseOptions: targetEnvId && targetEnvId !== cloudBaseOptions?.envId
             ? {
@@ -1685,14 +1713,10 @@ function registerEnvTools(server) {
                 .string()
                 .optional()
                 .describe("套餐 ID（action=create/modifyPlan 时必填）。可选值如 baas_personal(个人版)、baas_pf_standard(标准版)、baas_pf_enterprise(企业版)"),
-            region: zod_1.z
-                .string()
-                .optional()
-                .describe("环境地域（action=create 时可选）。默认 ap-shanghai，可选 ap-guangzhou、ap-beijing 等"),
             resources: zod_1.z
-                .array(zod_1.z.enum(["flexdb", "storage", "function", "postgresql"]))
+                .array(zod_1.z.enum(exports.CREATE_ENV_RESOURCE_VALUES))
                 .optional()
-                .describe("启用的资源类型（action=create 时可选）。默认启用全部四项：flexdb(文档数据库)、storage(存储)、function(云函数)、postgresql(PostgreSQL 数据库)"),
+                .describe("启用的资源类型（action=create 时可选）。省略时默认全部四项：flexdb(文档数据库)、storage(存储)、function(云函数)、postgresql(PostgreSQL)。CreateEnv 要求 Resources 非空，MCP 会始终下发该字段。"),
             duration: zod_1.z
                 .number()
                 .int()
@@ -1720,17 +1744,19 @@ function registerEnvTools(server) {
         const action = rawArgs.action ?? "";
         const alias = normalizeOptionalToolString(rawArgs.alias);
         const packageId = normalizeOptionalToolString(rawArgs.packageId);
-        const region = normalizeOptionalToolString(rawArgs.region) ?? "ap-shanghai";
-        const resources = rawArgs.resources;
+        const resolvedResources = resolveCreateEnvResources(rawArgs.resources);
         const duration = rawArgs.duration ?? 1;
         const envId = normalizeOptionalToolString(rawArgs.envId);
         const confirmed = rawArgs.confirm === "yes";
         try {
-            const cloudbase = await getManager();
+            const cloudbase = await getManager({ requireEnvId: false });
             switch (action) {
                 case "listPackages": {
-                    // 查询可选套餐列表（新购场景）
-                    const result = await cloudbase.env.describeBaasPackageList({ TargetAction: "new" });
+                    // Query packages for new purchase. Source aligns with billing-side Baas package APIs.
+                    const result = await cloudbase.env.describeBaasPackageList({
+                        TargetAction: "new",
+                        Source: "qcloud",
+                    });
                     (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, result);
                     return (0, tool_result_js_1.buildJsonToolResult)({
                         ok: true,
@@ -1740,12 +1766,13 @@ function registerEnvTools(server) {
                     });
                 }
                 case "create": {
-                    // 创建环境需要 confirm
+                    // CreateEnv (Manager SDK / Cloud API) accepts Alias, PackageId, Resources, Period, etc.
+                    // It does NOT accept Region — region is determined by account/package, not this call.
                     if (!confirmed) {
                         return (0, tool_result_js_1.buildJsonToolResult)({
                             ok: false,
                             code: "CONFIRM_REQUIRED",
-                            message: `创建环境需要您确认。请确认以下配置信息后传入 confirm="yes"：\n别名: ${alias}\n套餐: ${packageId}\n地域: ${region}\n资源类型: ${resources?.join(", ") ?? "flexdb, storage, function, postgresql"}\n时长: ${duration} 个月`,
+                            message: `创建环境需要您确认。请确认以下配置信息后传入 confirm="yes"：\n别名: ${alias}\n套餐: ${packageId}\n资源类型: ${resolvedResources.join(", ")}\n时长: ${duration} 个月\n说明: CreateEnv 不接受 Region；环境地域由账号与套餐侧决定。`,
                             next_step: {
                                 tool: "manageEnv",
                                 action: "create",
@@ -1762,12 +1789,9 @@ function registerEnvTools(server) {
                     const createParams = {
                         Alias: alias,
                         PackageId: packageId,
-                        Region: region,
+                        Resources: resolvedResources,
                         Period: duration,
                     };
-                    if (resources && resources.length > 0) {
-                        createParams.Resources = resources;
-                    }
                     const result = await cloudbase.env.createEnv(createParams);
                     (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, result);
                     return (0, tool_result_js_1.buildJsonToolResult)({
@@ -1775,6 +1799,7 @@ function registerEnvTools(server) {
                         code: "ENV_CREATED",
                         message: `环境创建成功！新环境 ID: ${result.EnvId}。环境初始化可能需要几分钟，请通过 queryEnv(action="info", envId="${result.EnvId}") 轮询直到 Status 为正常。`,
                         envId: result.EnvId,
+                        resources: resolvedResources,
                     });
                 }
                 case "modifyPlan": {
@@ -1852,11 +1877,19 @@ function registerEnvTools(server) {
             if (toolPayloadResult) {
                 return toolPayloadResult;
             }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (action === "listPackages" && /billTags/i.test(errorMessage)) {
+                return (0, tool_result_js_1.buildJsonToolResult)({
+                    ok: false,
+                    code: "PACKAGE_LIST_FAILED",
+                    message: `查询套餐列表失败（计费标签 BillTags）：${errorMessage}。可改用控制台查看套餐，或直接使用已知 packageId（如 baas_personal）调用 manageEnv(action="create")。`,
+                });
+            }
             return {
                 content: [
                     {
                         type: "text",
-                        text: `环境管理操作失败: ${error instanceof Error ? error.message : String(error)}`,
+                        text: `环境管理操作失败: ${errorMessage}`,
                     },
                 ],
             };
@@ -2200,7 +2233,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.24.0" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.24.1" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -2281,7 +2314,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.24.0" : 0;
+            const mcpVersion =  true ? "2.24.1" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息
@@ -2318,7 +2351,8 @@ function createWrappedHandler(name, handler, server) {
                     error: errorMessage,
                     inputParams: sanitizeArgs(args), // 添加入参上报
                     cloudBaseOptions: cloudBaseOptions, // 传递 CloudBase 配置（可能已更新）
-                    ide: server.ide || process.env.INTEGRATION_IDE // 传递集成IDE信息
+                    ide: server.ide || process.env.INTEGRATION_IDE, // 传递集成IDE信息
+                    mcpClientInfo: (0, telemetry_js_1.readMcpClientInfoFromServer)(server),
                 }).catch(err => {
                     // 静默处理上报错误，不影响主要功能
                     (0, logger_js_1.debug)('遥测上报失败', { toolName: name, error: err instanceof Error ? err.message : String(err) });
@@ -9886,6 +9920,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.reportToolkitLifecycle = exports.reportToolCall = exports.telemetryReporter = void 0;
+exports.extractMcpClientInfo = extractMcpClientInfo;
+exports.readMcpClientInfoFromServer = readMcpClientInfoFromServer;
 const crypto_1 = __importDefault(__webpack_require__(7823));
 const http_1 = __importDefault(__webpack_require__(3782));
 const https_1 = __importDefault(__webpack_require__(3871));
@@ -9937,7 +9973,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.24.0" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.24.1" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -10119,6 +10155,49 @@ function resolveEnvId(cloudBaseOptions) {
     }
     return { envId, envIdSource };
 }
+/**
+ * Normalize SDK Implementation / clientInfo into telemetry-safe fields.
+ */
+function extractMcpClientInfo(clientVersion) {
+    if (!clientVersion || typeof clientVersion !== "object") {
+        return {};
+    }
+    const info = clientVersion;
+    const name = typeof info.name === "string" ? info.name.trim() : "";
+    const version = typeof info.version === "string" ? info.version.trim() : "";
+    const title = typeof info.title === "string" ? info.title.trim() : "";
+    return {
+        ...(name ? { name } : {}),
+        ...(version ? { version } : {}),
+        ...(title ? { title } : {}),
+    };
+}
+/**
+ * Read MCP clientInfo from an McpServer after initialize.
+ * Returns empty object when handshake has not completed or the accessor is unavailable.
+ */
+function readMcpClientInfoFromServer(server) {
+    try {
+        return extractMcpClientInfo(server?.server?.getClientVersion?.());
+    }
+    catch {
+        return {};
+    }
+}
+function appendMcpClientInfoFields(eventData, clientInfo) {
+    if (!clientInfo) {
+        return;
+    }
+    if (clientInfo.name) {
+        eventData.mcpClientName = clientInfo.name;
+    }
+    if (clientInfo.version) {
+        eventData.mcpClientVersion = clientInfo.version;
+    }
+    if (clientInfo.title) {
+        eventData.mcpClientTitle = clientInfo.title;
+    }
+}
 // 便捷方法
 const reportToolCall = async (params) => {
     const { nodeVersion, osType, osRelease, arch, mcpVersion } = exports.telemetryReporter.getUserAgent();
@@ -10163,6 +10242,7 @@ const reportToolCall = async (params) => {
     if (params.ide) {
         eventData.ide = params.ide;
     }
+    appendMcpClientInfoFields(eventData, params.mcpClientInfo);
     // Debug: 打印最终上报参数
     (0, logger_js_1.debug)('[telemetry] 工具调用上报参数', {
         toolName: params.toolName,
@@ -10205,6 +10285,7 @@ const reportToolkitLifecycle = async (params) => {
     if (params.ide) {
         eventData.ide = params.ide;
     }
+    appendMcpClientInfoFields(eventData, params.mcpClientInfo);
     // Debug: 打印最终上报参数
     (0, logger_js_1.debug)('[telemetry] 生命周期事件上报参数', {
         event: params.event,
@@ -14194,7 +14275,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.24.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.24.1" : 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.24.0",
+  "version": "2.24.1",
   "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",
@@ -100,6 +100,12 @@
     "webpack-obfuscator": "^3.6.0"
   },
   "overrides": {
-    "tough-cookie": "^4.1.3"
+    "tough-cookie": "^4.1.3",
+    "js-yaml": "4.3.0",
+    "brace-expansion@1": "1.1.16",
+    "brace-expansion@2": "2.1.2",
+    "brace-expansion@3": "5.0.7",
+    "brace-expansion@4": "5.0.7",
+    "brace-expansion@5": "5.0.7"
   }
 }