@cloudbase/cloudbase-mcp 2.25.7 → 2.25.9

package/dist/index.cjs

@@ -139372,7 +139372,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.25.7" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.25.9" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -202226,6 +202226,7 @@ async function registerRagTools(server) {
       强烈推荐始终优先使用固定技能文档 (skill)、OpenAPI 文档 (openapi) 或 CloudBase 官方文档 (docs) 模式进行检索，仅当固定文档无法覆盖你的问题时，再使用向量查询 (vector) 模式。
 
       ⚠️ 重要：当 CloudBase skills 处于禁用状态或当前 IDE 不支持 skill 文件读取时，必须使用 searchKnowledgeBase(mode=skill, skillName=...) 来获取 CloudBase 技能文档内容，而不是尝试直接读取 skill 文件。直接读取可能返回 400 错误。示例：
+      - 需要最小 Web+数据库 Demo 路径时：searchKnowledgeBase(mode=skill, skillName=minimal-web-baas-demo)
       - 需要 auth-tool 指南时：searchKnowledgeBase(mode=skill, skillName=auth-tool)
       - 需要 auth-web 指南时：searchKnowledgeBase(mode=skill, skillName=auth-web)
       - 需要 cloudbase-agent 指南时：searchKnowledgeBase(mode=skill, skillName=cloudbase-agent)
@@ -215267,7 +215268,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.25.7" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.25.9" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -215348,7 +215349,7 @@ function createWrappedHandler(name, handler, server) {
                 requestId: (typeof error === 'object' && error && 'requestId' in error) ? error.requestId : '',
                 ide: server.ide || process.env.INTEGRATION_IDE || ''
             });
-            const mcpVersion =  true ? "2.25.7" : 0;
+            const mcpVersion =  true ? "2.25.9" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息
@@ -232232,7 +232233,7 @@ function registerSetupTools(server) {
     server.registerTool("downloadTemplate", {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。
-**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置\n- cursor: Cursor AI编辑器\n- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.25.7" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置\n- cursor: Cursor AI编辑器\n- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.25.9" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -259387,7 +259388,7 @@ module.exports = {
 /***/ }),
 
 /***/ 89684:
-/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+/***/ ((__unused_webpack_module, exports) => {
 
 "use strict";
 
@@ -259396,13 +259397,16 @@ exports.isCloudMode = isCloudMode;
 exports.enableCloudMode = enableCloudMode;
 exports.getCloudModeStatus = getCloudModeStatus;
 exports.shouldRegisterTool = shouldRegisterTool;
-const logger_js_1 = __webpack_require__(13039);
 /**
  * Check if MCP is running in cloud mode
  * Cloud mode is enabled by:
  * 1. Command line argument --cloud-mode
  * 2. Environment variable CLOUDBASE_MCP_CLOUD_MODE=true
  * 3. Environment variable MCP_CLOUD_MODE=true
+ *
+ * Intentionally does not import logger: logger.ts calls isCloudMode() during
+ * module init, so importing logger here creates a circular dependency that
+ * crashes `node dist/cli.cjs --cloud-mode` with `debug is not a function`.
  */
 function isCloudMode() {
     // Check for CLI argument first
@@ -259410,21 +259414,13 @@ function isCloudMode() {
     // Check environment variables
     const cloudModeEnabled = process.env.CLOUDBASE_MCP_CLOUD_MODE === 'true' ||
         process.env.MCP_CLOUD_MODE === 'true';
-    const isEnabled = hasCloudModeArg || cloudModeEnabled;
-    if (isEnabled) {
-        (0, logger_js_1.debug)('Cloud mode is enabled', {
-            source: hasCloudModeArg ? 'CLI_ARG' : 'ENV_VAR',
-            envVar: process.env.CLOUDBASE_MCP_CLOUD_MODE || process.env.MCP_CLOUD_MODE
-        });
-    }
-    return isEnabled;
+    return hasCloudModeArg || cloudModeEnabled;
 }
 /**
  * Enable cloud mode by setting environment variable
  */
 function enableCloudMode() {
     process.env.CLOUDBASE_MCP_CLOUD_MODE = 'true';
-    (0, logger_js_1.debug)('Cloud mode enabled via API call');
 }
 /**
  * Get cloud mode status for logging/debugging
@@ -259472,11 +259468,7 @@ function shouldRegisterTool(toolName) {
         // Download tools - local file downloads
         'manageStorage',
     ];
-    const shouldRegister = !cloudIncompatibleTools.includes(toolName);
-    if (!shouldRegister) {
-        (0, logger_js_1.debug)(`Cloud mode: skipping registration of incompatible tool: ${toolName}`);
-    }
-    return shouldRegister;
+    return !cloudIncompatibleTools.includes(toolName);
 }
 
 

package/dist/index.d.ts

@@ -302,6 +302,10 @@ declare class InteractiveServer {
  * 1. Command line argument --cloud-mode
  * 2. Environment variable CLOUDBASE_MCP_CLOUD_MODE=true
  * 3. Environment variable MCP_CLOUD_MODE=true
+ *
+ * Intentionally does not import logger: logger.ts calls isCloudMode() during
+ * module init, so importing logger here creates a circular dependency that
+ * crashes `node dist/cli.cjs --cloud-mode` with `debug is not a function`.
  */
 export declare function isCloudMode(): boolean;
 

package/dist/index.js

@@ -2772,7 +2772,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.25.7" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.25.9" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -2853,7 +2853,7 @@ function createWrappedHandler(name, handler, server) {
                 requestId: (typeof error === 'object' && error && 'requestId' in error) ? error.requestId : '',
                 ide: server.ide || process.env.INTEGRATION_IDE || ''
             });
-            const mcpVersion =  true ? "2.25.7" : 0;
+            const mcpVersion =  true ? "2.25.9" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息
@@ -7576,6 +7576,7 @@ async function registerRagTools(server) {
       强烈推荐始终优先使用固定技能文档 (skill)、OpenAPI 文档 (openapi) 或 CloudBase 官方文档 (docs) 模式进行检索，仅当固定文档无法覆盖你的问题时，再使用向量查询 (vector) 模式。
 
       ⚠️ 重要：当 CloudBase skills 处于禁用状态或当前 IDE 不支持 skill 文件读取时，必须使用 searchKnowledgeBase(mode=skill, skillName=...) 来获取 CloudBase 技能文档内容，而不是尝试直接读取 skill 文件。直接读取可能返回 400 错误。示例：
+      - 需要最小 Web+数据库 Demo 路径时：searchKnowledgeBase(mode=skill, skillName=minimal-web-baas-demo)
       - 需要 auth-tool 指南时：searchKnowledgeBase(mode=skill, skillName=auth-tool)
       - 需要 auth-web 指南时：searchKnowledgeBase(mode=skill, skillName=auth-web)
       - 需要 cloudbase-agent 指南时：searchKnowledgeBase(mode=skill, skillName=cloudbase-agent)
@@ -11208,7 +11209,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.25.7" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.25.9" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -16743,7 +16744,7 @@ function registerSetupTools(server) {
     server.registerTool("downloadTemplate", {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。
-**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置\n- cursor: Cursor AI编辑器\n- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.25.7" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置\n- cursor: Cursor AI编辑器\n- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.25.9" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -20473,7 +20474,7 @@ function registerAgentTools(server) {
 /***/ }),
 
 /***/ 9684:
-/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+/***/ ((__unused_webpack_module, exports) => {
 
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
@@ -20481,13 +20482,16 @@ exports.isCloudMode = isCloudMode;
 exports.enableCloudMode = enableCloudMode;
 exports.getCloudModeStatus = getCloudModeStatus;
 exports.shouldRegisterTool = shouldRegisterTool;
-const logger_js_1 = __webpack_require__(3039);
 /**
  * Check if MCP is running in cloud mode
  * Cloud mode is enabled by:
  * 1. Command line argument --cloud-mode
  * 2. Environment variable CLOUDBASE_MCP_CLOUD_MODE=true
  * 3. Environment variable MCP_CLOUD_MODE=true
+ *
+ * Intentionally does not import logger: logger.ts calls isCloudMode() during
+ * module init, so importing logger here creates a circular dependency that
+ * crashes `node dist/cli.cjs --cloud-mode` with `debug is not a function`.
  */
 function isCloudMode() {
     // Check for CLI argument first
@@ -20495,21 +20499,13 @@ function isCloudMode() {
     // Check environment variables
     const cloudModeEnabled = process.env.CLOUDBASE_MCP_CLOUD_MODE === 'true' ||
         process.env.MCP_CLOUD_MODE === 'true';
-    const isEnabled = hasCloudModeArg || cloudModeEnabled;
-    if (isEnabled) {
-        (0, logger_js_1.debug)('Cloud mode is enabled', {
-            source: hasCloudModeArg ? 'CLI_ARG' : 'ENV_VAR',
-            envVar: process.env.CLOUDBASE_MCP_CLOUD_MODE || process.env.MCP_CLOUD_MODE
-        });
-    }
-    return isEnabled;
+    return hasCloudModeArg || cloudModeEnabled;
 }
 /**
  * Enable cloud mode by setting environment variable
  */
 function enableCloudMode() {
     process.env.CLOUDBASE_MCP_CLOUD_MODE = 'true';
-    (0, logger_js_1.debug)('Cloud mode enabled via API call');
 }
 /**
  * Get cloud mode status for logging/debugging
@@ -20557,11 +20553,7 @@ function shouldRegisterTool(toolName) {
         // Download tools - local file downloads
         'manageStorage',
     ];
-    const shouldRegister = !cloudIncompatibleTools.includes(toolName);
-    if (!shouldRegister) {
-        (0, logger_js_1.debug)(`Cloud mode: skipping registration of incompatible tool: ${toolName}`);
-    }
-    return shouldRegister;
+    return !cloudIncompatibleTools.includes(toolName);
 }
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/cloudbase-mcp",
-  "version": "2.25.7",
+  "version": "2.25.9",
   "packageManager": "pnpm@10.8.0",
   "description": "CloudBase MCP Server — operate Tencent CloudBase (database, auth, functions, storage, hosting) from AI coding tools via the Model Context Protocol. Part of CloudBase AI Toolkit.",
   "main": "./dist/index.cjs",
@@ -48,6 +48,8 @@
     "test:watch": "npm run build && vitest",
     "test:coverage": "npm run build && vitest run --coverage",
     "test:pg:cloud": "npm run build && node ./scripts/verify-pg-cloud-smoke.mjs",
+    "test:cli:cloud-mode": "node ./scripts/verify-cli-cloud-mode-smoke.mjs",
+    "test:npm:tarball-smoke": "node ./scripts/verify-npm-tarball-smoke.mjs",
     "test:inspector": "npm run build && npx @modelcontextprotocol/inspector node ./dist/cli.js",
     "prepublishOnly": "npm run build && node scripts/prepare-publish.cjs",
     "postpublish": "node scripts/restore-deps.cjs"