@cloudbase/cloudbase-mcp 2.7.3 → 2.7.6

package/dist/index.cjs

@@ -137058,7 +137058,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.7.3" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.7.6" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -203593,20 +203593,27 @@ const telemetry_js_1 = __webpack_require__(45880);
 async function generateGitHubIssueLink(toolName, errorMessage, args, cloudBaseOptions, payload) {
     const { requestId, ide } = payload || {};
     const baseUrl = 'https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues/new';
-    // 尝试获取环境ID
+    const isTestEnvironment =  false || process.env.VITEST === "true";
+    // 尝试获取环境ID（测试环境跳过，避免交互/阻塞）
     let envIdSection = '';
-    try {
-        const envId = await (0, cloudbase_manager_js_1.getEnvId)(cloudBaseOptions);
-        if (envId) {
-            envIdSection = `
+    if (!isTestEnvironment) {
+        try {
+            // Avoid blocking forever on envId lookup
+            const envId = await Promise.race([
+                (0, cloudbase_manager_js_1.getEnvId)(cloudBaseOptions),
+                new Promise((resolve) => setTimeout(() => resolve(''), 2000)),
+            ]);
+            if (envId) {
+                envIdSection = `
 ## 环境ID
 ${envId}
 `;
+            }
+        }
+        catch (error) {
+            // 如果获取 envId 失败，不添加环境ID部分
+            (0, logger_js_1.debug)('无法获取环境ID:', error instanceof Error ? error : new Error(String(error)));
         }
-    }
-    catch (error) {
-        // 如果获取 envId 失败，不添加环境ID部分
-        (0, logger_js_1.debug)('无法获取环境ID:', error instanceof Error ? error : new Error(String(error)));
     }
     // 构建标题
     const title = `MCP工具错误: ${toolName}`;
@@ -203622,7 +203629,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.7.3" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.7.6" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -203660,13 +203667,19 @@ function createWrappedHandler(name, handler, server) {
         let requestId;
         try {
             (0, logger_js_1.debug)(`开始执行工具: ${name}`, { args: sanitizeArgs(args) });
-            server.logger?.({ type: 'beforeToolCall', toolName: name, args: sanitizeArgs(args) });
+            // In test environment, skip logger to avoid potential blocking
+            const isTestEnvironment =  false || process.env.VITEST === "true";
+            if (!isTestEnvironment) {
+                server.logger?.({ type: 'beforeToolCall', toolName: name, args: sanitizeArgs(args) });
+            }
             // 执行原始处理函数
             const result = await handler(args);
             success = true;
             const duration = Date.now() - startTime;
             (0, logger_js_1.debug)(`工具执行成功: ${name}`, { duration });
-            server.logger?.({ type: 'afterToolCall', toolName: name, args: sanitizeArgs(args), result: result, duration });
+            if (!isTestEnvironment) {
+                server.logger?.({ type: 'afterToolCall', toolName: name, args: sanitizeArgs(args), result: result, duration });
+            }
             return result;
         }
         catch (error) {
@@ -203677,7 +203690,14 @@ function createWrappedHandler(name, handler, server) {
                 error: errorMessage,
                 duration: Date.now() - startTime
             });
-            server.logger?.({ type: 'errorToolCall', toolName: name, args: sanitizeArgs(args), message: errorMessage, duration: Date.now() - startTime });
+            const isTestEnvironment =  false || process.env.VITEST === "true";
+            if (!isTestEnvironment) {
+                server.logger?.({ type: 'errorToolCall', toolName: name, args: sanitizeArgs(args), message: errorMessage, duration: Date.now() - startTime });
+            }
+            // In tests, avoid any extra work that may block (envId lookup, issue link generation, etc.)
+            if (isTestEnvironment) {
+                throw error instanceof Error ? error : new Error(String(error));
+            }
             // 生成 GitHub Issue 创建链接
             const issueLink = await generateGitHubIssueLink(name, errorMessage, args, server.cloudBaseOptions, {
                 requestId: (typeof error === 'object' && error && 'requestId' in error) ? error.requestId : '',
@@ -203697,25 +203717,32 @@ function createWrappedHandler(name, handler, server) {
             throw enhancedError;
         }
         finally {
-            // 上报工具调用数据
-            const duration = Date.now() - startTime;
-            // 如果 server.cloudBaseOptions 为空或没有 envId，尝试从缓存获取并更新
-            let cloudBaseOptions = server.cloudBaseOptions;
-            if (!cloudBaseOptions?.envId) {
-                const cachedEnvId = (0, cloudbase_manager_js_1.getCachedEnvId)();
-                if (cachedEnvId) {
-                    cloudBaseOptions = { ...cloudBaseOptions, envId: cachedEnvId };
+            // 上报工具调用数据（测试环境中跳过，避免阻塞）
+            const isTestEnvironment =  false || process.env.VITEST === "true";
+            if (!isTestEnvironment) {
+                const duration = Date.now() - startTime;
+                // 如果 server.cloudBaseOptions 为空或没有 envId，尝试从缓存获取并更新
+                let cloudBaseOptions = server.cloudBaseOptions;
+                if (!cloudBaseOptions?.envId) {
+                    const cachedEnvId = (0, cloudbase_manager_js_1.getCachedEnvId)();
+                    if (cachedEnvId) {
+                        cloudBaseOptions = { ...cloudBaseOptions, envId: cachedEnvId };
+                    }
                 }
+                // 异步上报，不阻塞工具返回
+                (0, telemetry_js_1.reportToolCall)({
+                    toolName: name,
+                    success,
+                    duration,
+                    error: errorMessage,
+                    inputParams: sanitizeArgs(args), // 添加入参上报
+                    cloudBaseOptions: cloudBaseOptions, // 传递 CloudBase 配置（可能已更新）
+                    ide: server.ide || process.env.INTEGRATION_IDE // 传递集成IDE信息
+                }).catch(err => {
+                    // 静默处理上报错误，不影响主要功能
+                    (0, logger_js_1.debug)('遥测上报失败', { toolName: name, error: err instanceof Error ? err.message : String(err) });
+                });
             }
-            (0, telemetry_js_1.reportToolCall)({
-                toolName: name,
-                success,
-                duration,
-                error: errorMessage,
-                inputParams: sanitizeArgs(args), // 添加入参上报
-                cloudBaseOptions: cloudBaseOptions, // 传递 CloudBase 配置（可能已更新）
-                ide: server.ide || process.env.INTEGRATION_IDE // 传递集成IDE信息
-            });
         }
     };
 }
@@ -217939,6 +217966,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.RAW_IDE_FILE_MAPPINGS = void 0;
+exports.resolveDownloadTemplateIDE = resolveDownloadTemplateIDE;
+exports.validateIDE = validateIDE;
 exports.registerSetupTools = registerSetupTools;
 const adm_zip_1 = __importDefault(__webpack_require__(30283));
 const fs = __importStar(__webpack_require__(29021));
@@ -218116,17 +218145,30 @@ const INTEGRATION_IDE_MAPPING = {
     Kiro: "kiro",
     iFlow: "iflow-cli",
 };
-// 根据 INTEGRATION_IDE 环境变量获取默认 IDE 类型
-function getDefaultIDEFromEnv() {
-    const integrationIDE = process.env.INTEGRATION_IDE;
+// Resolve IDE for downloadTemplate without side effects (unit-test friendly).
+function resolveDownloadTemplateIDE(ide, integrationIDE) {
+    if (ide) {
+        return { ok: true, resolvedIDE: ide };
+    }
     if (integrationIDE) {
         const mappedIDE = INTEGRATION_IDE_MAPPING[integrationIDE];
         if (mappedIDE) {
-            return mappedIDE;
+            return { ok: true, resolvedIDE: mappedIDE };
         }
+        return {
+            ok: false,
+            reason: "unmapped_integration_ide",
+            integrationIDE,
+            supportedIDEs: IDE_TYPES.filter((t) => t !== "all"),
+        };
     }
-    return "all";
+    return {
+        ok: false,
+        reason: "missing_ide",
+        supportedIDEs: IDE_TYPES.filter((t) => t !== "all"),
+    };
 }
+// 根据 INTEGRATION_IDE 环境变量获取默认 IDE 类型
 // 下载文件到临时目录
 async function downloadFile(url, filePath) {
     return new Promise((resolve, reject) => {
@@ -218343,7 +218385,7 @@ function registerSetupTools(server) {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。⚠️ **MANDATORY FOR NEW PROJECTS** ⚠️
 
-**CRITICAL**: This tool MUST be called FIRST when starting a new project.\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- 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.7.3" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**CRITICAL**: This tool MUST be called FIRST when starting a new project.\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.7.6" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -218351,7 +218393,7 @@ function registerSetupTools(server) {
             ide: zod_1.z
                 .enum(IDE_TYPES)
                 .optional()
-                .describe("指定要下载的IDE类型。如果未指定，会根据 INTEGRATION_IDE 环境变量自动选择对应的IDE配置；如果环境变量也未设置，则默认下载所有IDE配置"),
+                .describe("指定要下载的IDE类型。如果未指定，会根据 INTEGRATION_IDE 环境变量自动选择对应的IDE配置；如果环境变量也未设置，则必须传入此参数"),
             overwrite: zod_1.z
                 .boolean()
                 .optional()
@@ -218366,8 +218408,29 @@ function registerSetupTools(server) {
         },
     }, async ({ template, ide, overwrite = false, }) => {
         try {
-            // 如果没有传入 ide 参数，根据 INTEGRATION_IDE 环境变量获取默认值
-            const resolvedIDE = ide ?? getDefaultIDEFromEnv();
+            const ideResolution = resolveDownloadTemplateIDE(ide, process.env.INTEGRATION_IDE);
+            if (!ideResolution.ok) {
+                const supportedIDEs = ideResolution.supportedIDEs.join(", ");
+                if (ideResolution.reason === "unmapped_integration_ide") {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `❌ 无法识别当前 IDE 环境\n\n检测到 INTEGRATION_IDE="${ideResolution.integrationIDE}"，但无法映射到支持的 IDE 类型。\n\n请显式传入 \`ide\` 参数来指定要下载的 IDE 配置。\n\n支持的 IDE 类型: ${supportedIDEs}\n\n示例: \`ide: "cursor"\` 或 \`ide: "all"\`（下载所有 IDE 配置）`,
+                            },
+                        ],
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `❌ 必须指定 IDE 参数\n\n请传入 \`ide\` 参数来指定要下载的 IDE 配置。\n\n支持的 IDE 类型: ${supportedIDEs}\n\n示例: \`ide: "cursor"\` 或 \`ide: "all"\`（下载所有 IDE 配置）`,
+                        },
+                    ],
+                };
+            }
+            const resolvedIDE = ideResolution.resolvedIDE;
             // 验证IDE类型
             const ideValidation = validateIDE(resolvedIDE);
             if (!ideValidation.valid) {

package/dist/index.js

@@ -527,20 +527,27 @@ const telemetry_js_1 = __webpack_require__(5880);
 async function generateGitHubIssueLink(toolName, errorMessage, args, cloudBaseOptions, payload) {
     const { requestId, ide } = payload || {};
     const baseUrl = 'https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues/new';
-    // 尝试获取环境ID
+    const isTestEnvironment =  false || process.env.VITEST === "true";
+    // 尝试获取环境ID（测试环境跳过，避免交互/阻塞）
     let envIdSection = '';
-    try {
-        const envId = await (0, cloudbase_manager_js_1.getEnvId)(cloudBaseOptions);
-        if (envId) {
-            envIdSection = `
+    if (!isTestEnvironment) {
+        try {
+            // Avoid blocking forever on envId lookup
+            const envId = await Promise.race([
+                (0, cloudbase_manager_js_1.getEnvId)(cloudBaseOptions),
+                new Promise((resolve) => setTimeout(() => resolve(''), 2000)),
+            ]);
+            if (envId) {
+                envIdSection = `
 ## 环境ID
 ${envId}
 `;
+            }
+        }
+        catch (error) {
+            // 如果获取 envId 失败，不添加环境ID部分
+            (0, logger_js_1.debug)('无法获取环境ID:', error instanceof Error ? error : new Error(String(error)));
         }
-    }
-    catch (error) {
-        // 如果获取 envId 失败，不添加环境ID部分
-        (0, logger_js_1.debug)('无法获取环境ID:', error instanceof Error ? error : new Error(String(error)));
     }
     // 构建标题
     const title = `MCP工具错误: ${toolName}`;
@@ -556,7 +563,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.7.3" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.7.6" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -594,13 +601,19 @@ function createWrappedHandler(name, handler, server) {
         let requestId;
         try {
             (0, logger_js_1.debug)(`开始执行工具: ${name}`, { args: sanitizeArgs(args) });
-            server.logger?.({ type: 'beforeToolCall', toolName: name, args: sanitizeArgs(args) });
+            // In test environment, skip logger to avoid potential blocking
+            const isTestEnvironment =  false || process.env.VITEST === "true";
+            if (!isTestEnvironment) {
+                server.logger?.({ type: 'beforeToolCall', toolName: name, args: sanitizeArgs(args) });
+            }
             // 执行原始处理函数
             const result = await handler(args);
             success = true;
             const duration = Date.now() - startTime;
             (0, logger_js_1.debug)(`工具执行成功: ${name}`, { duration });
-            server.logger?.({ type: 'afterToolCall', toolName: name, args: sanitizeArgs(args), result: result, duration });
+            if (!isTestEnvironment) {
+                server.logger?.({ type: 'afterToolCall', toolName: name, args: sanitizeArgs(args), result: result, duration });
+            }
             return result;
         }
         catch (error) {
@@ -611,7 +624,14 @@ function createWrappedHandler(name, handler, server) {
                 error: errorMessage,
                 duration: Date.now() - startTime
             });
-            server.logger?.({ type: 'errorToolCall', toolName: name, args: sanitizeArgs(args), message: errorMessage, duration: Date.now() - startTime });
+            const isTestEnvironment =  false || process.env.VITEST === "true";
+            if (!isTestEnvironment) {
+                server.logger?.({ type: 'errorToolCall', toolName: name, args: sanitizeArgs(args), message: errorMessage, duration: Date.now() - startTime });
+            }
+            // In tests, avoid any extra work that may block (envId lookup, issue link generation, etc.)
+            if (isTestEnvironment) {
+                throw error instanceof Error ? error : new Error(String(error));
+            }
             // 生成 GitHub Issue 创建链接
             const issueLink = await generateGitHubIssueLink(name, errorMessage, args, server.cloudBaseOptions, {
                 requestId: (typeof error === 'object' && error && 'requestId' in error) ? error.requestId : '',
@@ -631,25 +651,32 @@ function createWrappedHandler(name, handler, server) {
             throw enhancedError;
         }
         finally {
-            // 上报工具调用数据
-            const duration = Date.now() - startTime;
-            // 如果 server.cloudBaseOptions 为空或没有 envId，尝试从缓存获取并更新
-            let cloudBaseOptions = server.cloudBaseOptions;
-            if (!cloudBaseOptions?.envId) {
-                const cachedEnvId = (0, cloudbase_manager_js_1.getCachedEnvId)();
-                if (cachedEnvId) {
-                    cloudBaseOptions = { ...cloudBaseOptions, envId: cachedEnvId };
+            // 上报工具调用数据（测试环境中跳过，避免阻塞）
+            const isTestEnvironment =  false || process.env.VITEST === "true";
+            if (!isTestEnvironment) {
+                const duration = Date.now() - startTime;
+                // 如果 server.cloudBaseOptions 为空或没有 envId，尝试从缓存获取并更新
+                let cloudBaseOptions = server.cloudBaseOptions;
+                if (!cloudBaseOptions?.envId) {
+                    const cachedEnvId = (0, cloudbase_manager_js_1.getCachedEnvId)();
+                    if (cachedEnvId) {
+                        cloudBaseOptions = { ...cloudBaseOptions, envId: cachedEnvId };
+                    }
                 }
+                // 异步上报，不阻塞工具返回
+                (0, telemetry_js_1.reportToolCall)({
+                    toolName: name,
+                    success,
+                    duration,
+                    error: errorMessage,
+                    inputParams: sanitizeArgs(args), // 添加入参上报
+                    cloudBaseOptions: cloudBaseOptions, // 传递 CloudBase 配置（可能已更新）
+                    ide: server.ide || process.env.INTEGRATION_IDE // 传递集成IDE信息
+                }).catch(err => {
+                    // 静默处理上报错误，不影响主要功能
+                    (0, logger_js_1.debug)('遥测上报失败', { toolName: name, error: err instanceof Error ? err.message : String(err) });
+                });
             }
-            (0, telemetry_js_1.reportToolCall)({
-                toolName: name,
-                success,
-                duration,
-                error: errorMessage,
-                inputParams: sanitizeArgs(args), // 添加入参上报
-                cloudBaseOptions: cloudBaseOptions, // 传递 CloudBase 配置（可能已更新）
-                ide: server.ide || process.env.INTEGRATION_IDE // 传递集成IDE信息
-            });
         }
     };
 }
@@ -8686,7 +8713,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.7.3" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.7.6" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -9687,6 +9714,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.RAW_IDE_FILE_MAPPINGS = void 0;
+exports.resolveDownloadTemplateIDE = resolveDownloadTemplateIDE;
+exports.validateIDE = validateIDE;
 exports.registerSetupTools = registerSetupTools;
 const adm_zip_1 = __importDefault(__webpack_require__(2872));
 const fs = __importStar(__webpack_require__(4421));
@@ -9864,17 +9893,30 @@ const INTEGRATION_IDE_MAPPING = {
     Kiro: "kiro",
     iFlow: "iflow-cli",
 };
-// 根据 INTEGRATION_IDE 环境变量获取默认 IDE 类型
-function getDefaultIDEFromEnv() {
-    const integrationIDE = process.env.INTEGRATION_IDE;
+// Resolve IDE for downloadTemplate without side effects (unit-test friendly).
+function resolveDownloadTemplateIDE(ide, integrationIDE) {
+    if (ide) {
+        return { ok: true, resolvedIDE: ide };
+    }
     if (integrationIDE) {
         const mappedIDE = INTEGRATION_IDE_MAPPING[integrationIDE];
         if (mappedIDE) {
-            return mappedIDE;
+            return { ok: true, resolvedIDE: mappedIDE };
         }
+        return {
+            ok: false,
+            reason: "unmapped_integration_ide",
+            integrationIDE,
+            supportedIDEs: IDE_TYPES.filter((t) => t !== "all"),
+        };
     }
-    return "all";
+    return {
+        ok: false,
+        reason: "missing_ide",
+        supportedIDEs: IDE_TYPES.filter((t) => t !== "all"),
+    };
 }
+// 根据 INTEGRATION_IDE 环境变量获取默认 IDE 类型
 // 下载文件到临时目录
 async function downloadFile(url, filePath) {
     return new Promise((resolve, reject) => {
@@ -10091,7 +10133,7 @@ function registerSetupTools(server) {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。⚠️ **MANDATORY FOR NEW PROJECTS** ⚠️
 
-**CRITICAL**: This tool MUST be called FIRST when starting a new project.\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- 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.7.3" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**CRITICAL**: This tool MUST be called FIRST when starting a new project.\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.7.6" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -10099,7 +10141,7 @@ function registerSetupTools(server) {
             ide: zod_1.z
                 .enum(IDE_TYPES)
                 .optional()
-                .describe("指定要下载的IDE类型。如果未指定，会根据 INTEGRATION_IDE 环境变量自动选择对应的IDE配置；如果环境变量也未设置，则默认下载所有IDE配置"),
+                .describe("指定要下载的IDE类型。如果未指定，会根据 INTEGRATION_IDE 环境变量自动选择对应的IDE配置；如果环境变量也未设置，则必须传入此参数"),
             overwrite: zod_1.z
                 .boolean()
                 .optional()
@@ -10114,8 +10156,29 @@ function registerSetupTools(server) {
         },
     }, async ({ template, ide, overwrite = false, }) => {
         try {
-            // 如果没有传入 ide 参数，根据 INTEGRATION_IDE 环境变量获取默认值
-            const resolvedIDE = ide ?? getDefaultIDEFromEnv();
+            const ideResolution = resolveDownloadTemplateIDE(ide, process.env.INTEGRATION_IDE);
+            if (!ideResolution.ok) {
+                const supportedIDEs = ideResolution.supportedIDEs.join(", ");
+                if (ideResolution.reason === "unmapped_integration_ide") {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `❌ 无法识别当前 IDE 环境\n\n检测到 INTEGRATION_IDE="${ideResolution.integrationIDE}"，但无法映射到支持的 IDE 类型。\n\n请显式传入 \`ide\` 参数来指定要下载的 IDE 配置。\n\n支持的 IDE 类型: ${supportedIDEs}\n\n示例: \`ide: "cursor"\` 或 \`ide: "all"\`（下载所有 IDE 配置）`,
+                            },
+                        ],
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `❌ 必须指定 IDE 参数\n\n请传入 \`ide\` 参数来指定要下载的 IDE 配置。\n\n支持的 IDE 类型: ${supportedIDEs}\n\n示例: \`ide: "cursor"\` 或 \`ide: "all"\`（下载所有 IDE 配置）`,
+                        },
+                    ],
+                };
+            }
+            const resolvedIDE = ideResolution.resolvedIDE;
             // 验证IDE类型
             const ideValidation = validateIDE(resolvedIDE);
             if (!ideValidation.valid) {

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@cloudbase/cloudbase-mcp",
-  "version": "2.7.3",
+  "version": "2.7.6",
   "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",
   "types": "./dist/index.d.ts",
   "type": "module",
   "bin": {
-    "cloudbase-mcp": "./dist/cli.cjs"
+    "cloudbase-mcp": "dist/cli.cjs"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
   },
   "exports": {
     ".": {
@@ -22,14 +26,14 @@
       "default": "./dist/index.js"
     }
   },
-  "homepage": "https://github.com/TencentCloudBase/CloudBase-AI-ToolKit",
+  "homepage": "https://github.com/TencentCloudBase/CloudBase-MCP",
   "bugs": {
-    "url": "https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues",
+    "url": "https://github.com/TencentCloudBase/CloudBase-MCP/issues",
     "email": "bookerzhao@tencent.com"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/TencentCloudBase/CloudBase-AI-ToolKit.git"
+    "url": "git+https://github.com/TencentCloudBase/CloudBase-MCP.git"
   },
   "scripts": {
     "clean": "rm -rf dist",