@cloudbase/cloudbase-mcp 2.2.0 → 2.3.1

package/dist/index.js

@@ -2525,7 +2525,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.downloadWebTemplate = downloadWebTemplate;
 exports.getClaudePrompt = getClaudePrompt;
 exports.registerRagTools = registerRagTools;
 const adm_zip_1 = __importDefault(__webpack_require__(872));
@@ -2543,6 +2542,58 @@ const KnowledgeBaseIdMap = {
     scf: "scfsczskzyws_4bdc",
     miniprogram: "xcxzskws_25d8",
 };
+// ============ 缓存配置 ============
+const CACHE_BASE_DIR = path.join(os.homedir(), ".cloudbase-mcp");
+const CACHE_META_FILE = path.join(CACHE_BASE_DIR, "cache-meta.json");
+const DEFAULT_CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 默认 24 小时
+// 支持环境变量 CLOUDBASE_MCP_CACHE_TTL_MS 控制缓存过期时间（毫秒）
+const parsedCacheTTL = process.env.CLOUDBASE_MCP_CACHE_TTL_MS
+    ? parseInt(process.env.CLOUDBASE_MCP_CACHE_TTL_MS, 10)
+    : NaN;
+const CACHE_TTL_MS = Number.isNaN(parsedCacheTTL) || parsedCacheTTL < 0
+    ? DEFAULT_CACHE_TTL_MS
+    : parsedCacheTTL;
+if (!Number.isNaN(parsedCacheTTL) && parsedCacheTTL >= 0) {
+    (0, logger_js_1.debug)("[cache] Using TTL from CLOUDBASE_MCP_CACHE_TTL_MS", {
+        ttlMs: CACHE_TTL_MS,
+    });
+}
+else {
+    (0, logger_js_1.debug)("[cache] Using default TTL", { ttlMs: CACHE_TTL_MS });
+}
+// 共享的下载 Promise，防止并发重复下载
+let resourceDownloadPromise = null;
+// 检查缓存是否可用（未过期）
+async function canUseCache() {
+    try {
+        const content = await fs.readFile(CACHE_META_FILE, "utf8");
+        const meta = JSON.parse(content);
+        if (!meta.timestamp) {
+            (0, logger_js_1.debug)("[cache] cache-meta missing timestamp, treating as invalid", {
+                ttlMs: CACHE_TTL_MS,
+            });
+            return false;
+        }
+        const ageMs = Date.now() - meta.timestamp;
+        const isValid = ageMs <= CACHE_TTL_MS;
+        (0, logger_js_1.debug)("[cache] evaluated cache meta", {
+            timestamp: meta.timestamp,
+            ageMs,
+            ttlMs: CACHE_TTL_MS,
+            valid: isValid,
+        });
+        return isValid;
+    }
+    catch (error) {
+        (0, logger_js_1.debug)("[cache] failed to read cache meta, treating as miss", { error });
+        return false;
+    }
+}
+// 更新缓存时间戳
+async function updateCache() {
+    await fs.mkdir(CACHE_BASE_DIR, { recursive: true });
+    await fs.writeFile(CACHE_META_FILE, JSON.stringify({ timestamp: Date.now() }, null, 2), "utf8");
+}
 // 安全 JSON.parse
 function safeParse(str) {
     try {
@@ -2569,31 +2620,141 @@ function safeStringify(obj) {
         return "";
     }
 }
-// Download and extract web template, return extract directory path
-// Always downloads and overwrites existing template
+// OpenAPI 文档 URL 列表
+const OPENAPI_SOURCES = [
+    {
+        name: "mysqldb",
+        description: "MySQL RESTful API - 云开发 MySQL 数据库 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/mysqldb.v1.openapi.yaml",
+    },
+    {
+        name: "functions",
+        description: "Cloud Functions API - 云函数 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/functions.v1.openapi.yaml",
+    },
+    {
+        name: "auth",
+        description: "Authentication API - 身份认证 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/auth.v1.openapi.yaml",
+    },
+    {
+        name: "cloudrun",
+        description: "CloudRun API - 云托管服务 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/cloudrun.v1.openapi.yaml",
+    },
+    {
+        name: "storage",
+        description: "Storage API - 云存储 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/storage.v1.openapi.yaml",
+    },
+];
 async function downloadWebTemplate() {
-    const baseDir = path.join(os.homedir(), ".cloudbase-mcp");
-    const zipPath = path.join(baseDir, "web-cloudbase-project.zip");
-    const extractDir = path.join(baseDir, "web-template");
+    const zipPath = path.join(CACHE_BASE_DIR, "web-cloudbase-project.zip");
+    const extractDir = path.join(CACHE_BASE_DIR, "web-template");
     const url = "https://static.cloudbase.net/cloudbase-examples/web-cloudbase-project.zip";
-    await fs.mkdir(baseDir, { recursive: true });
-    // Download zip to specified path (overwrite)
     const response = await fetch(url);
     if (!response.ok) {
         throw new Error(`下载模板失败，状态码: ${response.status}`);
     }
     const buffer = Buffer.from(await response.arrayBuffer());
     await fs.writeFile(zipPath, buffer);
-    // Clean and recreate extract directory
     await fs.rm(extractDir, { recursive: true, force: true });
     await fs.mkdir(extractDir, { recursive: true });
     const zip = new adm_zip_1.default(zipPath);
     zip.extractAllTo(extractDir, true);
+    (0, logger_js_1.debug)("[downloadResources] webTemplate 下载完成");
     return extractDir;
 }
-async function prepareKnowledgeBaseWebTemplate() {
-    const extractDir = await downloadWebTemplate();
-    return collectSkillDescriptions(path.join(extractDir, ".claude", "skills"));
+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) => {
+        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;
+            }
+            const content = await response.text();
+            const filePath = path.join(baseDir, `${source.name}.openapi.yaml`);
+            await fs.writeFile(filePath, content, "utf8");
+            results.push({
+                name: source.name,
+                description: source.description,
+                absolutePath: filePath,
+            });
+        }
+        catch (error) {
+            (0, logger_js_1.warn)(`[downloadOpenAPI] Failed to download ${source.name}`, {
+                error,
+            });
+        }
+    }));
+    (0, logger_js_1.debug)("[downloadOpenAPI] openAPIDocs 下载完成", {
+        successCount: results.length,
+        total: OPENAPI_SOURCES.length,
+    });
+    return results;
+}
+// 实际执行下载所有资源的函数（webTemplate 和 openAPI 并发下载）
+async function _doDownloadResources() {
+    // 并发下载 webTemplate 和 openAPIDocs
+    const [webTemplateDir, openAPIDocs] = await Promise.all([
+        // 下载 web 模板
+        downloadWebTemplate(),
+        // 并发下载所有 OpenAPI 文档
+        downloadOpenAPI(),
+    ]);
+    (0, logger_js_1.debug)("[downloadResources] 所有资源下载完成");
+    return { webTemplateDir, openAPIDocs };
+}
+// 下载所有资源（带缓存和共享 Promise 机制）
+async function downloadResources() {
+    const webTemplateDir = path.join(CACHE_BASE_DIR, "web-template");
+    const openAPIDir = path.join(CACHE_BASE_DIR, "openapi");
+    // 检查缓存是否有效
+    if (await canUseCache()) {
+        try {
+            // 检查两个目录都存在
+            await Promise.all([fs.access(webTemplateDir), fs.access(openAPIDir)]);
+            const files = await fs.readdir(openAPIDir);
+            if (files.length > 0) {
+                (0, logger_js_1.debug)("[downloadResources] 使用缓存");
+                return {
+                    webTemplateDir,
+                    openAPIDocs: OPENAPI_SOURCES.map((source) => ({
+                        name: source.name,
+                        description: source.description,
+                        absolutePath: path.join(openAPIDir, `${source.name}.openapi.yaml`),
+                    })).filter((item) => files.includes(`${item.name}.openapi.yaml`)),
+                };
+            }
+        }
+        catch {
+            // 缓存无效，需要重新下载
+        }
+    }
+    // 如果已有下载任务在进行中，共享该 Promise
+    if (resourceDownloadPromise) {
+        (0, logger_js_1.debug)("[downloadResources] 共享已有下载任务");
+        return resourceDownloadPromise;
+    }
+    // 创建新的下载任务
+    (0, logger_js_1.debug)("[downloadResources] 开始新下载任务");
+    await fs.mkdir(CACHE_BASE_DIR, { recursive: true });
+    resourceDownloadPromise = _doDownloadResources()
+        .then(async (result) => {
+        await updateCache();
+        (0, logger_js_1.debug)("[downloadResources] 缓存已更新");
+        return result;
+    })
+        .finally(() => {
+        resourceDownloadPromise = null;
+    });
+    return resourceDownloadPromise;
 }
 // Get CLAUDE.md prompt content
 // Priority: 1. From downloaded template, 2. Fallback to embedded constant
@@ -2717,23 +2878,15 @@ async function registerRagTools(server) {
             };
         }
     });
-    let skills = [];
     let openapis = [];
-    // 知识库检索
-    try {
-        skills = await prepareKnowledgeBaseWebTemplate();
-    }
-    catch (error) {
-        (0, logger_js_1.warn)("[searchKnowledgeBase] Failed to prepare web template", {
-            error,
-        });
-    }
-    // OpenAPI 文档准备
+    let skills = [];
     try {
-        openapis = await prepareOpenAPIDocs();
+        const { webTemplateDir, openAPIDocs } = await downloadResources();
+        openapis = openAPIDocs;
+        skills = await collectSkillDescriptions(path.join(webTemplateDir, ".claude", "skills"));
     }
     catch (error) {
-        (0, logger_js_1.warn)("[searchKnowledgeBase] Failed to prepare OpenAPI docs", {
+        (0, logger_js_1.warn)("[downloadResources] Failed to download resources", {
             error,
         });
     }
@@ -2900,65 +3053,6 @@ function extractDescriptionFromFrontMatter(content) {
         .match(/^(?:decsription|description)\s*:\s*(.*)$/m);
     return match ? match[1].trim() : null;
 }
-// OpenAPI 文档 URL 列表
-const OPENAPI_SOURCES = [
-    {
-        name: "mysqldb",
-        description: "MySQL RESTful API - 云开发 MySQL 数据库 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/mysqldb.v1.openapi.yaml",
-    },
-    {
-        name: "functions",
-        description: "Cloud Functions API - 云函数 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/functions.v1.openapi.yaml",
-    },
-    {
-        name: "auth",
-        description: "Authentication API - 身份认证 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/auth.v1.openapi.yaml",
-    },
-    {
-        name: "cloudrun",
-        description: "CloudRun API - 云托管服务 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/cloudrun.v1.openapi.yaml",
-    },
-    {
-        name: "storage",
-        description: "Storage API - 云存储 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/storage.v1.openapi.yaml",
-    },
-];
-// 下载并准备 OpenAPI 文档
-async function prepareOpenAPIDocs() {
-    const baseDir = path.join(os.homedir(), ".cloudbase-mcp", "openapi");
-    await fs.mkdir(baseDir, { recursive: true });
-    const results = [];
-    await Promise.all(OPENAPI_SOURCES.map(async (source) => {
-        try {
-            const response = await fetch(source.url);
-            if (!response.ok) {
-                (0, logger_js_1.warn)(`[prepareOpenAPIDocs] Failed to download ${source.name}`, {
-                    status: response.status,
-                });
-                return;
-            }
-            const content = await response.text();
-            const filePath = path.join(baseDir, `${source.name}.openapi.yaml`);
-            await fs.writeFile(filePath, content, "utf8");
-            results.push({
-                name: source.name,
-                description: source.description,
-                absolutePath: filePath,
-            });
-        }
-        catch (error) {
-            (0, logger_js_1.warn)(`[prepareOpenAPIDocs] Failed to download ${source.name}`, {
-                error,
-            });
-        }
-    }));
-    return results;
-}
 async function collectSkillDescriptions(rootDir) {
     const result = [];
     async function walk(dir) {
@@ -6224,7 +6318,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.2.0" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.3.1" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -7164,12 +7258,15 @@ const IDE_TYPES = [
     "roocode", // RooCode AI编辑器
     "tongyi-lingma", // 通义灵码
     "trae", // Trae AI编辑器
+    "qoder", // Qoder AI编辑器
+    "antigravity", // Google Antigravity AI编辑器
     "vscode", // Visual Studio Code
 ];
 // IDE到文件的映射关系
+// 注意：以 "/" 结尾的路径表示目录，会包含该目录下的所有文件
 const IDE_FILE_MAPPINGS = {
-    cursor: [".cursor/rules/cloudbase-rules.mdc", ".cursor/mcp.json"],
-    windsurf: [".windsurf/rules/cloudbase-rules.md"],
+    cursor: [".cursor/rules/", ".cursor/mcp.json"],
+    windsurf: [".windsurf/rules/"],
     codebuddy: [".rules/cloudbase-rules.md", "CODEBUDDY.md", ".mcp.json"],
     "claude-code": [
         "CLAUDE.md",
@@ -7179,7 +7276,7 @@ const IDE_FILE_MAPPINGS = {
         ".claude/commands/spec.md",
         ".claude/commands/no_spec.md",
     ],
-    cline: [".clinerules/cloudbase-rules.mdc"],
+    cline: [".clinerules/"],
     "gemini-cli": [".gemini/GEMINI.md", ".gemini/settings.json"],
     opencode: [".opencode.json"],
     "qwen-code": [".qwen/QWEN.md", ".qwen/settings.json"],
@@ -7193,7 +7290,9 @@ const IDE_FILE_MAPPINGS = {
     "github-copilot": [".github/copilot-instructions.md"],
     roocode: [".roo/rules/cloudbaase-rules.md", ".roo/mcp.json"],
     "tongyi-lingma": [".lingma/rules/cloudbaase-rules.md"],
-    trae: [".trae/rules/cloudbase-rules.md"],
+    trae: [".trae/rules/"],
+    qoder: [".qoder/rules/"],
+    antigravity: [".agent/rules/"],
     vscode: [".vscode/mcp.json", ".vscode/settings.json"],
 };
 // 所有IDE配置文件的完整列表 - 通过IDE_FILE_MAPPINGS计算得出
@@ -7218,6 +7317,8 @@ const IDE_DESCRIPTIONS = {
     roocode: "RooCode AI编辑器",
     "tongyi-lingma": "通义灵码",
     trae: "Trae AI编辑器",
+    qoder: "Qoder AI编辑器",
+    antigravity: "Google Antigravity AI编辑器",
     vscode: "Visual Studio Code",
 };
 // INTEGRATION_IDE 环境变量值到 IDE 类型的映射
@@ -7239,6 +7340,8 @@ const INTEGRATION_IDE_MAPPING = {
     RooCode: "roocode",
     "Tongyi Lingma": "tongyi-lingma",
     Trae: "trae",
+    Qoder: "qoder",
+    Antigravity: "antigravity",
     VSCode: "vscode",
 };
 // 根据 INTEGRATION_IDE 环境变量获取默认 IDE 类型
@@ -7389,6 +7492,17 @@ function validateIDE(ide) {
     }
     return { valid: true };
 }
+// 检查文件是否匹配给定的路径（支持文件和目录）
+function matchesPath(file, pathPattern) {
+    if (pathPattern.endsWith("/")) {
+        // 目录路径：检查文件是否在该目录下
+        return file.startsWith(pathPattern);
+    }
+    else {
+        // 文件路径：精确匹配
+        return file === pathPattern;
+    }
+}
 // 文件过滤函数
 function filterFilesByIDE(files, ide) {
     if (ide === "all") {
@@ -7399,9 +7513,32 @@ function filterFilesByIDE(files, ide) {
         return files; // 如果找不到映射，返回所有文件
     }
     // 计算需要排除的IDE文件（除了当前IDE需要的文件）
-    const filesToExclude = ALL_IDE_FILES.filter((file) => !ideFiles.includes(file));
+    const filesToExclude = [];
+    // 遍历所有IDE文件，找出不属于当前IDE的文件
+    for (const ideFile of ALL_IDE_FILES) {
+        // 检查这个文件是否属于当前IDE需要的文件
+        let isCurrentIDEFile = false;
+        for (const currentIDEFile of ideFiles) {
+            if (matchesPath(ideFile, currentIDEFile)) {
+                isCurrentIDEFile = true;
+                break;
+            }
+        }
+        // 如果不属于当前IDE，加入排除列表
+        if (!isCurrentIDEFile) {
+            filesToExclude.push(ideFile);
+        }
+    }
     // 排除不需要的IDE配置文件，保留其他所有文件
-    return files.filter((file) => !filesToExclude.includes(file));
+    return files.filter((file) => {
+        // 检查文件是否应该被排除
+        for (const excludePath of filesToExclude) {
+            if (matchesPath(file, excludePath)) {
+                return false; // 排除
+            }
+        }
+        return true; // 保留
+    });
 }
 // 创建过滤后的目录结构
 async function createFilteredDirectory(extractDir, filteredFiles, ide) {
@@ -7428,7 +7565,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- vscode: Visual Studio Code\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.2.0" : 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- 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\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.3.1" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -8526,7 +8663,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.2.0" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.3.1" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/cloudbase-mcp",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "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",