@cloudbase/cloudbase-mcp 2.34.0 → 2.34.2

package/dist/index.cjs

@@ -202710,7 +202710,7 @@ exports.env = (0, types_js_1.defineModule)({
     "auth.deviceCodeMissing": "未获取到设备码信息，请重试设备码登录",
     "auth.deviceStarted": "已发起设备码登录，请在浏览器中打开 verification_uri 并输入 user_code 完成授权。授权完成后请再次调用 auth(action=\"status\")。",
     "auth.loginStateMissing": "未获取到登录态，请先完成认证",
-    "auth.apiKeyArgsRequired": "action=login_by_api_key 时必须同时提供 apiKey 和 envId。",
+    "auth.apiKeyArgsRequired": "action=login_by_api_key 时必须同时提供 apiKey 和 apiKeyEnvId。",
     "auth.apiKeySuccess": "API Key 认证成功，已获取临时密钥。",
     "auth.apiKeyExchangeFailed": "API Key 换取临时密钥失败。",
     "auth.apiKeyDiagLogin": "\n\n诊断信息：\n- CLOUDBASE_ENV_ID: {envId}\n- CLOUDBASE_API_KEY: {apiKeyPrefix}...（已截断）\n- TCB_SITE: {site}\n\n可能原因：\n1. API Key 已过期或被删除\n2. CLOUDBASE_ENV_ID 与 API Key 所属环境不匹配\n3. API Key 与站点不匹配：国际站环境的 Key 需配置 TCB_SITE=intl（走 ap-singapore 网关）；国内站环境（含 ap-guangzhou/ap-singapore 地域）不要配置 intl\n4. 网络连接问题\n\n建议：请检查 API Key 和环境 ID 是否正确。",
@@ -202923,7 +202923,7 @@ exports.env = (0, types_js_1.defineModule)({
     "auth.deviceCodeMissing": "No device code info was returned; please retry device-code login",
     "auth.deviceStarted": "Device-code login started. Open verification_uri in the browser and enter user_code to complete the authorization. Once authorized, call auth(action=\"status\") again.",
     "auth.loginStateMissing": "No login state was obtained; please complete authentication first",
-    "auth.apiKeyArgsRequired": "Both apiKey and envId must be provided when action=login_by_api_key.",
+    "auth.apiKeyArgsRequired": "Both apiKey and apiKeyEnvId must be provided when action=login_by_api_key.",
     "auth.apiKeySuccess": "API Key authentication succeeded; temporary credentials obtained.",
     "auth.apiKeyExchangeFailed": "Failed to exchange the API Key for temporary credentials.",
     "auth.apiKeyDiagLogin": "\n\nDiagnostics:\n- CLOUDBASE_ENV_ID: {envId}\n- CLOUDBASE_API_KEY: {apiKeyPrefix}... (truncated)\n- TCB_SITE: {site}\n\nPossible causes:\n1. The API Key has expired or was deleted\n2. CLOUDBASE_ENV_ID does not match the environment the API Key belongs to\n3. The API Key does not match the site: keys for international-site environments need TCB_SITE=intl (routed via the ap-singapore gateway); do not set intl for domestic-site environments (including the ap-guangzhou/ap-singapore regions)\n4. Network connectivity issue\n\nSuggestion: check that the API Key and environment ID are correct.",
@@ -218658,7 +218658,7 @@ function registerEnvTools(server) {
                             code: "INVALID_ARGS",
                             message: (0, index_js_1.t)("env.auth.apiKeyArgsRequired", undefined, outLang),
                             next_step: (0, tool_result_js_1.buildAuthNextStep)("login_by_api_key", {
-                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", envId: "<your-env-id>" },
+                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", apiKeyEnvId: "<your-env-id>" },
                             }),
                         });
                     }
@@ -218703,7 +218703,7 @@ function registerEnvTools(server) {
                             auth_mode: "api_key",
                             envId: toolApiKeyEnvId,
                             next_step: (0, tool_result_js_1.buildAuthNextStep)("login_by_api_key", {
-                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", envId: "<your-env-id>" },
+                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", apiKeyEnvId: "<your-env-id>" },
                             }),
                         });
                     }
@@ -218718,7 +218718,7 @@ function registerEnvTools(server) {
                             message: (0, index_js_1.t)("env.auth.apiKeyException", { message }, outLang),
                             auth_mode: "api_key",
                             next_step: (0, tool_result_js_1.buildAuthNextStep)("login_by_api_key", {
-                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", envId: "<your-env-id>" },
+                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", apiKeyEnvId: "<your-env-id>" },
                             }),
                         });
                     }
@@ -227899,32 +227899,37 @@ async function downloadWebTemplate() {
 async function downloadOpenAPI() {
     const baseDir = path.join(CACHE_BASE_DIR, "openapi");
     await fs.mkdir(baseDir, { recursive: true });
-    const results = [];
-    await Promise.all(OPENAPI_SOURCES.map(async (source) => {
+    const downloaded = await Promise.all(OPENAPI_SOURCES.map(async (source) => {
         try {
             const response = await fetch(source.url);
             if (!response.ok) {
                 (0, logger_js_1.warn)(`[downloadOpenAPI] Failed to download ${source.name}`, {
                     status: response.status,
                 });
-                return;
+                return undefined;
             }
             const content = await response.text();
             const filePath = path.join(baseDir, `${source.name}.openapi.yaml`);
             await fs.writeFile(filePath, content, "utf8");
-            results.push({
+            return {
                 name: source.name,
                 description: source.description,
                 absolutePath: filePath,
                 url: source.url,
-            });
+            };
         }
         catch (error) {
             (0, logger_js_1.warn)(`[downloadOpenAPI] Failed to download ${source.name}`, {
                 error,
             });
+            return undefined;
         }
     }));
+    // 顺序必须跟随 OPENAPI_SOURCES 声明顺序。`Promise.all` 只保证按输入顺序
+    // 返回结果，所以这里先收集再过滤；若改成在各并发任务内部 `results.push()`，
+    // 数组顺序会变成网络完成顺序，导致 tools.json / mcp-tools.md 里内联的
+    // OpenAPI 清单在每次构建之间无意义漂移。
+    const results = downloaded.filter((item) => item !== undefined);
     (0, logger_js_1.debug)("[downloadOpenAPI] openAPIDocs 下载完成", {
         successCount: results.length,
         total: OPENAPI_SOURCES.length,
@@ -231557,7 +231562,7 @@ class TelemetryReporter {
         const arch = os_1.default.arch(); // 系统架构
         // Build-time injected version; guard for vitest / non-webpack runtimes.
         const mcpVersion = process.env.npm_package_version ||
-            ( true ? "2.34.0" : 0);
+            ( true ? "2.34.2" : 0);
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -232150,7 +232155,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || ( true ? "2.34.0" : 0)}
+- MCP 版本：${process.env.npm_package_version || ( true ? "2.34.2" : 0)}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -232239,7 +232244,7 @@ function createWrappedHandler(name, handler, server) {
                 requestId,
                 ide: server.ide || process.env.INTEGRATION_IDE || ''
             });
-            const mcpVersion =  true ? "2.34.0" : 0;
+            const mcpVersion =  true ? "2.34.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/dist/index.js

@@ -3730,7 +3730,7 @@ exports.env = (0, types_js_1.defineModule)({
     "auth.deviceCodeMissing": "未获取到设备码信息，请重试设备码登录",
     "auth.deviceStarted": "已发起设备码登录，请在浏览器中打开 verification_uri 并输入 user_code 完成授权。授权完成后请再次调用 auth(action=\"status\")。",
     "auth.loginStateMissing": "未获取到登录态，请先完成认证",
-    "auth.apiKeyArgsRequired": "action=login_by_api_key 时必须同时提供 apiKey 和 envId。",
+    "auth.apiKeyArgsRequired": "action=login_by_api_key 时必须同时提供 apiKey 和 apiKeyEnvId。",
     "auth.apiKeySuccess": "API Key 认证成功，已获取临时密钥。",
     "auth.apiKeyExchangeFailed": "API Key 换取临时密钥失败。",
     "auth.apiKeyDiagLogin": "\n\n诊断信息：\n- CLOUDBASE_ENV_ID: {envId}\n- CLOUDBASE_API_KEY: {apiKeyPrefix}...（已截断）\n- TCB_SITE: {site}\n\n可能原因：\n1. API Key 已过期或被删除\n2. CLOUDBASE_ENV_ID 与 API Key 所属环境不匹配\n3. API Key 与站点不匹配：国际站环境的 Key 需配置 TCB_SITE=intl（走 ap-singapore 网关）；国内站环境（含 ap-guangzhou/ap-singapore 地域）不要配置 intl\n4. 网络连接问题\n\n建议：请检查 API Key 和环境 ID 是否正确。",
@@ -3943,7 +3943,7 @@ exports.env = (0, types_js_1.defineModule)({
     "auth.deviceCodeMissing": "No device code info was returned; please retry device-code login",
     "auth.deviceStarted": "Device-code login started. Open verification_uri in the browser and enter user_code to complete the authorization. Once authorized, call auth(action=\"status\") again.",
     "auth.loginStateMissing": "No login state was obtained; please complete authentication first",
-    "auth.apiKeyArgsRequired": "Both apiKey and envId must be provided when action=login_by_api_key.",
+    "auth.apiKeyArgsRequired": "Both apiKey and apiKeyEnvId must be provided when action=login_by_api_key.",
     "auth.apiKeySuccess": "API Key authentication succeeded; temporary credentials obtained.",
     "auth.apiKeyExchangeFailed": "Failed to exchange the API Key for temporary credentials.",
     "auth.apiKeyDiagLogin": "\n\nDiagnostics:\n- CLOUDBASE_ENV_ID: {envId}\n- CLOUDBASE_API_KEY: {apiKeyPrefix}... (truncated)\n- TCB_SITE: {site}\n\nPossible causes:\n1. The API Key has expired or was deleted\n2. CLOUDBASE_ENV_ID does not match the environment the API Key belongs to\n3. The API Key does not match the site: keys for international-site environments need TCB_SITE=intl (routed via the ap-singapore gateway); do not set intl for domestic-site environments (including the ap-guangzhou/ap-singapore regions)\n4. Network connectivity issue\n\nSuggestion: check that the API Key and environment ID are correct.",
@@ -19613,7 +19613,7 @@ function registerEnvTools(server) {
                             code: "INVALID_ARGS",
                             message: (0, index_js_1.t)("env.auth.apiKeyArgsRequired", undefined, outLang),
                             next_step: (0, tool_result_js_1.buildAuthNextStep)("login_by_api_key", {
-                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", envId: "<your-env-id>" },
+                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", apiKeyEnvId: "<your-env-id>" },
                             }),
                         });
                     }
@@ -19658,7 +19658,7 @@ function registerEnvTools(server) {
                             auth_mode: "api_key",
                             envId: toolApiKeyEnvId,
                             next_step: (0, tool_result_js_1.buildAuthNextStep)("login_by_api_key", {
-                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", envId: "<your-env-id>" },
+                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", apiKeyEnvId: "<your-env-id>" },
                             }),
                         });
                     }
@@ -19673,7 +19673,7 @@ function registerEnvTools(server) {
                             message: (0, index_js_1.t)("env.auth.apiKeyException", { message }, outLang),
                             auth_mode: "api_key",
                             next_step: (0, tool_result_js_1.buildAuthNextStep)("login_by_api_key", {
-                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", envId: "<your-env-id>" },
+                                suggestedArgs: { action: "login_by_api_key", apiKey: "<your-api-key>", apiKeyEnvId: "<your-env-id>" },
                             }),
                         });
                     }
@@ -28847,32 +28847,37 @@ async function downloadWebTemplate() {
 async function downloadOpenAPI() {
     const baseDir = path.join(CACHE_BASE_DIR, "openapi");
     await fs.mkdir(baseDir, { recursive: true });
-    const results = [];
-    await Promise.all(OPENAPI_SOURCES.map(async (source) => {
+    const downloaded = await Promise.all(OPENAPI_SOURCES.map(async (source) => {
         try {
             const response = await fetch(source.url);
             if (!response.ok) {
                 (0, logger_js_1.warn)(`[downloadOpenAPI] Failed to download ${source.name}`, {
                     status: response.status,
                 });
-                return;
+                return undefined;
             }
             const content = await response.text();
             const filePath = path.join(baseDir, `${source.name}.openapi.yaml`);
             await fs.writeFile(filePath, content, "utf8");
-            results.push({
+            return {
                 name: source.name,
                 description: source.description,
                 absolutePath: filePath,
                 url: source.url,
-            });
+            };
         }
         catch (error) {
             (0, logger_js_1.warn)(`[downloadOpenAPI] Failed to download ${source.name}`, {
                 error,
             });
+            return undefined;
         }
     }));
+    // 顺序必须跟随 OPENAPI_SOURCES 声明顺序。`Promise.all` 只保证按输入顺序
+    // 返回结果，所以这里先收集再过滤；若改成在各并发任务内部 `results.push()`，
+    // 数组顺序会变成网络完成顺序，导致 tools.json / mcp-tools.md 里内联的
+    // OpenAPI 清单在每次构建之间无意义漂移。
+    const results = downloaded.filter((item) => item !== undefined);
     (0, logger_js_1.debug)("[downloadOpenAPI] openAPIDocs 下载完成", {
         successCount: results.length,
         total: OPENAPI_SOURCES.length,
@@ -32499,7 +32504,7 @@ class TelemetryReporter {
         const arch = os_1.default.arch(); // 系统架构
         // Build-time injected version; guard for vitest / non-webpack runtimes.
         const mcpVersion = process.env.npm_package_version ||
-            ( true ? "2.34.0" : 0);
+            ( true ? "2.34.2" : 0);
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -33091,7 +33096,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || ( true ? "2.34.0" : 0)}
+- MCP 版本：${process.env.npm_package_version || ( true ? "2.34.2" : 0)}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -33180,7 +33185,7 @@ function createWrappedHandler(name, handler, server) {
                 requestId,
                 ide: server.ide || process.env.INTEGRATION_IDE || ''
             });
-            const mcpVersion =  true ? "2.34.0" : 0;
+            const mcpVersion =  true ? "2.34.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.34.0",
+  "version": "2.34.2",
   "mcpName": "io.github.TencentCloudBase/cloudbase-mcp",
   "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.",

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.TencentCloudBase/cloudbase-mcp",
   "title": "CloudBase",
   "description": "CloudBase MCP: DB, functions, storage, hosting via @cloudbase/cloudbase-mcp",
-  "version": "2.34.0",
+  "version": "2.34.2",
   "websiteUrl": "https://github.com/TencentCloudBase/CloudBase-AI-Toolkit",
   "repository": {
     "url": "https://github.com/TencentCloudBase/CloudBase-AI-Toolkit",
@@ -25,7 +25,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cloudbase/cloudbase-mcp",
-      "version": "2.34.0",
+      "version": "2.34.2",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"