@cloudbase/cloudbase-mcp 2.15.3 → 2.15.4

package/dist/index.cjs

@@ -130743,7 +130743,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.15.3" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.15.4" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -187484,7 +187484,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.15.3" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.15.4" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -194840,6 +194840,53 @@ function normalizeNoSqlDocuments(data) {
     }
     return data.map((item) => parseNoSqlDocument(item));
 }
+function normalizeSortDirection(value) {
+    if (value === 1) {
+        return 1;
+    }
+    if (value === -1) {
+        return -1;
+    }
+    throw new Error(`非法 sort direction: ${String(value)}，仅支持 1 / -1`);
+}
+function normalizeSortItem(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("sort 数组项必须是 { key, direction } 对象");
+    }
+    const { key, direction } = value;
+    if (typeof key !== "string" || key.trim() === "") {
+        throw new Error("sort.key 必须是非空字符串");
+    }
+    return {
+        key,
+        direction: normalizeSortDirection(direction),
+    };
+}
+function normalizeSortInput(sort) {
+    if (sort === undefined || sort === null) {
+        return undefined;
+    }
+    let parsed = sort;
+    if (typeof parsed === "string") {
+        const trimmed = parsed.trim();
+        if (!trimmed) {
+            return undefined;
+        }
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            throw new Error("sort 必须是 sort 数组的 JSON 字符串");
+        }
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error('sort 仅支持数组 [{"key":"createdAt","direction":-1}] 或对应 JSON 字符串');
+    }
+    if (parsed.length === 0) {
+        return undefined;
+    }
+    return JSON.stringify(parsed.map((item) => normalizeSortItem(item)));
+}
 function withCollectionName(collectionName, payload) {
     return {
         ...payload,
@@ -195184,7 +195231,7 @@ deleteCollection: 删除集合`),
                 zod_1.z.string(),
             ])
                 .optional()
-                .describe("排序条件，使用对象或字符串。"),
+                .describe('排序条件，仅支持数组 [{"key":"createdAt","direction":-1}] 或对应 JSON 字符串。'),
             limit: zod_1.z.number().optional().describe("返回数量限制"),
             offset: zod_1.z.number().optional().describe("跳过的记录数"),
         },
@@ -195197,13 +195244,14 @@ deleteCollection: 删除集合`),
         const cloudbase = await getManager();
         const instanceId = await getDatabaseInstanceId(getManager);
         const toJSONString = (v) => typeof v === "object" && v !== null ? JSON.stringify(v) : v;
+        const normalizedSort = normalizeSortInput(sort);
         const result = await cloudbase.commonService("tcb", "2018-06-08").call({
             Action: "QueryRecords",
             Param: {
                 TableName: collectionName,
                 MgoQuery: toJSONString(query),
                 MgoProjection: toJSONString(projection),
-                MgoSort: toJSONString(sort),
+                MgoSort: normalizedSort,
                 MgoLimit: limit ?? 100,
                 MgoOffset: offset,
                 Tag: instanceId,
@@ -200544,7 +200592,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- 其他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.15.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.15.4" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])

package/dist/index.js

@@ -1426,7 +1426,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.15.3" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.15.4" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -3359,6 +3359,53 @@ function normalizeNoSqlDocuments(data) {
     }
     return data.map((item) => parseNoSqlDocument(item));
 }
+function normalizeSortDirection(value) {
+    if (value === 1) {
+        return 1;
+    }
+    if (value === -1) {
+        return -1;
+    }
+    throw new Error(`非法 sort direction: ${String(value)}，仅支持 1 / -1`);
+}
+function normalizeSortItem(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("sort 数组项必须是 { key, direction } 对象");
+    }
+    const { key, direction } = value;
+    if (typeof key !== "string" || key.trim() === "") {
+        throw new Error("sort.key 必须是非空字符串");
+    }
+    return {
+        key,
+        direction: normalizeSortDirection(direction),
+    };
+}
+function normalizeSortInput(sort) {
+    if (sort === undefined || sort === null) {
+        return undefined;
+    }
+    let parsed = sort;
+    if (typeof parsed === "string") {
+        const trimmed = parsed.trim();
+        if (!trimmed) {
+            return undefined;
+        }
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            throw new Error("sort 必须是 sort 数组的 JSON 字符串");
+        }
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error('sort 仅支持数组 [{"key":"createdAt","direction":-1}] 或对应 JSON 字符串');
+    }
+    if (parsed.length === 0) {
+        return undefined;
+    }
+    return JSON.stringify(parsed.map((item) => normalizeSortItem(item)));
+}
 function withCollectionName(collectionName, payload) {
     return {
         ...payload,
@@ -3703,7 +3750,7 @@ deleteCollection: 删除集合`),
                 zod_1.z.string(),
             ])
                 .optional()
-                .describe("排序条件，使用对象或字符串。"),
+                .describe('排序条件，仅支持数组 [{"key":"createdAt","direction":-1}] 或对应 JSON 字符串。'),
             limit: zod_1.z.number().optional().describe("返回数量限制"),
             offset: zod_1.z.number().optional().describe("跳过的记录数"),
         },
@@ -3716,13 +3763,14 @@ deleteCollection: 删除集合`),
         const cloudbase = await getManager();
         const instanceId = await getDatabaseInstanceId(getManager);
         const toJSONString = (v) => typeof v === "object" && v !== null ? JSON.stringify(v) : v;
+        const normalizedSort = normalizeSortInput(sort);
         const result = await cloudbase.commonService("tcb", "2018-06-08").call({
             Action: "QueryRecords",
             Param: {
                 TableName: collectionName,
                 MgoQuery: toJSONString(query),
                 MgoProjection: toJSONString(projection),
-                MgoSort: toJSONString(sort),
+                MgoSort: normalizedSort,
                 MgoLimit: limit ?? 100,
                 MgoOffset: offset,
                 Tag: instanceId,
@@ -7082,7 +7130,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.15.3" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.15.4" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -8914,7 +8962,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- 其他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.15.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.15.4" : 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.15.3",
+  "version": "2.15.4",
   "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",