@cloudbase/cloudbase-mcp 2.0.4 → 2.0.6

package/README.md

@@ -29,7 +29,7 @@
 
 <sup>从 AI 提示词到应用上线的最短路径</sup>
 
-[![][github-trending-shield]][github-trending-url]
+[![][github-trending-shield]](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit)
 
 [<img width="791" height="592" alt="Clipboard_Screenshot_1763724670" src="https://github.com/user-attachments/assets/f769beb7-5710-4397-8854-af2b7e452f70" />](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/tutorials)
 
@@ -85,10 +85,6 @@ AI 编程工具（如 Cursor、Copilot）解决了**代码生成**的难题。
 > 一键安装，自动配置，支持多种 AI 编程工具：
 > 
 > ```bash
-> # Mac/Linux/WSL
-> curl https://static.cloudbase.net/cli/install/install.sh -fsS | bash
-> 
-> # Windows PowerShell
 > npm install @cloudbase/cli@latest -g
 > ```
 > 

package/dist/cli.cjs

@@ -33476,9 +33476,12 @@ function wrap (fn) {
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.WRITE_SECURITY_RULE = exports.READ_SECURITY_RULE = void 0;
 exports.registerSecurityRuleTools = registerSecurityRuleTools;
 const zod_1 = __webpack_require__(21614);
 const cloudbase_manager_js_1 = __webpack_require__(3431);
+exports.READ_SECURITY_RULE = "readSecurityRule";
+exports.WRITE_SECURITY_RULE = "writeSecurityRule";
 /**
  * 注册安全规则相关 Tool
  * @param server MCP Server 实例
@@ -33487,7 +33490,7 @@ function registerSecurityRuleTools(server) {
     const cloudBaseOptions = server.cloudBaseOptions;
     const getManager = () => (0, cloudbase_manager_js_1.getCloudBaseManager)({ cloudBaseOptions });
     // 读取安全规则 Tool
-    server.registerTool?.("readSecurityRule", {
+    server.registerTool?.(exports.READ_SECURITY_RULE, {
         title: "读取安全规则",
         description: `读取指定资源（noSQL 数据库、SQL 数据库、云函数、存储桶）的安全规则和权限类别。`,
         inputSchema: {
@@ -33587,7 +33590,7 @@ function registerSecurityRuleTools(server) {
         }
     });
     // 写入安全规则 Tool
-    server.registerTool?.("writeSecurityRule", {
+    server.registerTool?.(exports.WRITE_SECURITY_RULE, {
         title: "写入安全规则",
         description: `设置指定资源（数据库集合、云函数、存储桶）的安全规则。`,
         inputSchema: {
@@ -38318,6 +38321,7 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.registerSQLDatabaseTools = registerSQLDatabaseTools;
 const zod_1 = __webpack_require__(21614);
 const cloudbase_manager_js_1 = __webpack_require__(3431);
+const security_rule_js_1 = __webpack_require__(7862);
 const CATEGORY = "SQL database";
 function registerSQLDatabaseTools(server) {
     // Get cloudBaseOptions, if not available then undefined
@@ -38386,7 +38390,7 @@ function registerSQLDatabaseTools(server) {
     // executeWriteSQL
     server.registerTool?.("executeWriteSQL", {
         title: "Execute write SQL statement",
-        description: "Execute a write SQL statement on the SQL database (INSERT, UPDATE, DELETE, etc.). Note: For per-user ACL, each table should contain a fixed `_openid` column that represents the user and is used for access control.",
+        description: "Execute a write SQL statement on the SQL database (INSERT, UPDATE, DELETE, etc.). Whenever you create a new table, you **must** contain a fixed `_opeid` column that represents the user and is used for access control.",
         inputSchema: {
             sql: zod_1.z
                 .string()
@@ -38424,7 +38428,7 @@ function registerSQLDatabaseTools(server) {
                         type: "text",
                         text: JSON.stringify({
                             success: true,
-                            message: "SQL statement executed successfully",
+                            message: `SQL statement executed successfully. If you just created a table, make sure to check its security rule is set to a proper value by using \`${security_rule_js_1.WRITE_SECURITY_RULE}\` and \`${security_rule_js_1.READ_SECURITY_RULE}\` tools.`,
                             result,
                         }, null, 2),
                     },
@@ -134861,7 +134865,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.0.4" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.0.6" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -200506,7 +200510,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.0.4" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.0.6" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -208787,12 +208791,15 @@ deleteCollection: 删除数据`),
             collectionName: zod_1.z.string().describe("集合名称"),
             documents: zod_1.z
                 .array(zod_1.z.object({}).passthrough())
+                .optional()
                 .describe("要插入的文档对象数组,每个文档都是对象(insert 操作必填)"),
             query: zod_1.z
                 .union([zod_1.z.object({}).passthrough(), zod_1.z.string()])
+                .optional()
                 .describe("查询条件(对象或字符串,推荐对象)(update/delete 操作必填)"),
             update: zod_1.z
                 .union([zod_1.z.object({}).passthrough(), zod_1.z.string()])
+                .optional()
                 .describe("更新内容(对象或字符串,推荐对象)(update 操作必填)"),
             isMulti: zod_1.z
                 .boolean()
@@ -208812,6 +208819,9 @@ deleteCollection: 删除数据`),
         },
     }, async ({ action, collectionName, documents, query, update, isMulti, upsert, }) => {
         if (action === "insert") {
+            if (!documents) {
+                throw new Error("insert 操作时必须提供 documents");
+            }
             const text = await insertDocuments({
                 collectionName,
                 documents,
@@ -208827,6 +208837,12 @@ deleteCollection: 删除数据`),
             };
         }
         if (action === "update") {
+            if (!query) {
+                throw new Error("update 操作时必须提供 query");
+            }
+            if (!update) {
+                throw new Error("update 操作时必须提供 update");
+            }
             const text = await updateDocuments({
                 collectionName,
                 query,
@@ -208845,6 +208861,9 @@ deleteCollection: 删除数据`),
             };
         }
         if (action === "delete") {
+            if (!query) {
+                throw new Error("delete 操作时必须提供 query");
+            }
             const text = await deleteDocuments({
                 collectionName,
                 query,
@@ -215083,7 +215102,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.0.4" : 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- vscode: Visual Studio Code\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.0.6" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z.enum(["react", "vue", "miniprogram", "uniapp", "rules"]).describe("要下载的模板类型"),
             ide: zod_1.z.enum(IDE_TYPES).optional().default("all").describe("指定要下载的IDE类型，默认为all（下载所有IDE配置）"),

package/dist/index.cjs

@@ -33475,9 +33475,12 @@ function wrap (fn) {
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.WRITE_SECURITY_RULE = exports.READ_SECURITY_RULE = void 0;
 exports.registerSecurityRuleTools = registerSecurityRuleTools;
 const zod_1 = __webpack_require__(21614);
 const cloudbase_manager_js_1 = __webpack_require__(3431);
+exports.READ_SECURITY_RULE = "readSecurityRule";
+exports.WRITE_SECURITY_RULE = "writeSecurityRule";
 /**
  * 注册安全规则相关 Tool
  * @param server MCP Server 实例
@@ -33486,7 +33489,7 @@ function registerSecurityRuleTools(server) {
     const cloudBaseOptions = server.cloudBaseOptions;
     const getManager = () => (0, cloudbase_manager_js_1.getCloudBaseManager)({ cloudBaseOptions });
     // 读取安全规则 Tool
-    server.registerTool?.("readSecurityRule", {
+    server.registerTool?.(exports.READ_SECURITY_RULE, {
         title: "读取安全规则",
         description: `读取指定资源（noSQL 数据库、SQL 数据库、云函数、存储桶）的安全规则和权限类别。`,
         inputSchema: {
@@ -33586,7 +33589,7 @@ function registerSecurityRuleTools(server) {
         }
     });
     // 写入安全规则 Tool
-    server.registerTool?.("writeSecurityRule", {
+    server.registerTool?.(exports.WRITE_SECURITY_RULE, {
         title: "写入安全规则",
         description: `设置指定资源（数据库集合、云函数、存储桶）的安全规则。`,
         inputSchema: {
@@ -38317,6 +38320,7 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.registerSQLDatabaseTools = registerSQLDatabaseTools;
 const zod_1 = __webpack_require__(21614);
 const cloudbase_manager_js_1 = __webpack_require__(3431);
+const security_rule_js_1 = __webpack_require__(7862);
 const CATEGORY = "SQL database";
 function registerSQLDatabaseTools(server) {
     // Get cloudBaseOptions, if not available then undefined
@@ -38385,7 +38389,7 @@ function registerSQLDatabaseTools(server) {
     // executeWriteSQL
     server.registerTool?.("executeWriteSQL", {
         title: "Execute write SQL statement",
-        description: "Execute a write SQL statement on the SQL database (INSERT, UPDATE, DELETE, etc.). Note: For per-user ACL, each table should contain a fixed `_openid` column that represents the user and is used for access control.",
+        description: "Execute a write SQL statement on the SQL database (INSERT, UPDATE, DELETE, etc.). Whenever you create a new table, you **must** contain a fixed `_opeid` column that represents the user and is used for access control.",
         inputSchema: {
             sql: zod_1.z
                 .string()
@@ -38423,7 +38427,7 @@ function registerSQLDatabaseTools(server) {
                         type: "text",
                         text: JSON.stringify({
                             success: true,
-                            message: "SQL statement executed successfully",
+                            message: `SQL statement executed successfully. If you just created a table, make sure to check its security rule is set to a proper value by using \`${security_rule_js_1.WRITE_SECURITY_RULE}\` and \`${security_rule_js_1.READ_SECURITY_RULE}\` tools.`,
                             result,
                         }, null, 2),
                     },
@@ -134710,7 +134714,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.0.4" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.0.6" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -200355,7 +200359,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.0.4" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.0.6" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -208636,12 +208640,15 @@ deleteCollection: 删除数据`),
             collectionName: zod_1.z.string().describe("集合名称"),
             documents: zod_1.z
                 .array(zod_1.z.object({}).passthrough())
+                .optional()
                 .describe("要插入的文档对象数组,每个文档都是对象(insert 操作必填)"),
             query: zod_1.z
                 .union([zod_1.z.object({}).passthrough(), zod_1.z.string()])
+                .optional()
                 .describe("查询条件(对象或字符串,推荐对象)(update/delete 操作必填)"),
             update: zod_1.z
                 .union([zod_1.z.object({}).passthrough(), zod_1.z.string()])
+                .optional()
                 .describe("更新内容(对象或字符串,推荐对象)(update 操作必填)"),
             isMulti: zod_1.z
                 .boolean()
@@ -208661,6 +208668,9 @@ deleteCollection: 删除数据`),
         },
     }, async ({ action, collectionName, documents, query, update, isMulti, upsert, }) => {
         if (action === "insert") {
+            if (!documents) {
+                throw new Error("insert 操作时必须提供 documents");
+            }
             const text = await insertDocuments({
                 collectionName,
                 documents,
@@ -208676,6 +208686,12 @@ deleteCollection: 删除数据`),
             };
         }
         if (action === "update") {
+            if (!query) {
+                throw new Error("update 操作时必须提供 query");
+            }
+            if (!update) {
+                throw new Error("update 操作时必须提供 update");
+            }
             const text = await updateDocuments({
                 collectionName,
                 query,
@@ -208694,6 +208710,9 @@ deleteCollection: 删除数据`),
             };
         }
         if (action === "delete") {
+            if (!query) {
+                throw new Error("delete 操作时必须提供 query");
+            }
             const text = await deleteDocuments({
                 collectionName,
                 query,
@@ -214932,7 +214951,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.0.4" : 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- vscode: Visual Studio Code\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.0.6" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z.enum(["react", "vue", "miniprogram", "uniapp", "rules"]).describe("要下载的模板类型"),
             ide: zod_1.z.enum(IDE_TYPES).optional().default("all").describe("指定要下载的IDE类型，默认为all（下载所有IDE配置）"),

package/dist/index.js

@@ -6021,7 +6021,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.0.4" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.0.6" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -6178,6 +6178,7 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.registerSQLDatabaseTools = registerSQLDatabaseTools;
 const zod_1 = __webpack_require__(971);
 const cloudbase_manager_js_1 = __webpack_require__(431);
+const security_rule_js_1 = __webpack_require__(862);
 const CATEGORY = "SQL database";
 function registerSQLDatabaseTools(server) {
     // Get cloudBaseOptions, if not available then undefined
@@ -6246,7 +6247,7 @@ function registerSQLDatabaseTools(server) {
     // executeWriteSQL
     server.registerTool?.("executeWriteSQL", {
         title: "Execute write SQL statement",
-        description: "Execute a write SQL statement on the SQL database (INSERT, UPDATE, DELETE, etc.). Note: For per-user ACL, each table should contain a fixed `_openid` column that represents the user and is used for access control.",
+        description: "Execute a write SQL statement on the SQL database (INSERT, UPDATE, DELETE, etc.). Whenever you create a new table, you **must** contain a fixed `_opeid` column that represents the user and is used for access control.",
         inputSchema: {
             sql: zod_1.z
                 .string()
@@ -6284,7 +6285,7 @@ function registerSQLDatabaseTools(server) {
                         type: "text",
                         text: JSON.stringify({
                             success: true,
-                            message: "SQL statement executed successfully",
+                            message: `SQL statement executed successfully. If you just created a table, make sure to check its security rule is set to a proper value by using \`${security_rule_js_1.WRITE_SECURITY_RULE}\` and \`${security_rule_js_1.READ_SECURITY_RULE}\` tools.`,
                             result,
                         }, null, 2),
                     },
@@ -7210,7 +7211,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.0.4" : 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- vscode: Visual Studio Code\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.0.6" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z.enum(["react", "vue", "miniprogram", "uniapp", "rules"]).describe("要下载的模板类型"),
             ide: zod_1.z.enum(IDE_TYPES).optional().default("all").describe("指定要下载的IDE类型，默认为all（下载所有IDE配置）"),
@@ -7893,9 +7894,12 @@ function registerStorageTools(server) {
 
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.WRITE_SECURITY_RULE = exports.READ_SECURITY_RULE = void 0;
 exports.registerSecurityRuleTools = registerSecurityRuleTools;
 const zod_1 = __webpack_require__(971);
 const cloudbase_manager_js_1 = __webpack_require__(431);
+exports.READ_SECURITY_RULE = "readSecurityRule";
+exports.WRITE_SECURITY_RULE = "writeSecurityRule";
 /**
  * 注册安全规则相关 Tool
  * @param server MCP Server 实例
@@ -7904,7 +7908,7 @@ function registerSecurityRuleTools(server) {
     const cloudBaseOptions = server.cloudBaseOptions;
     const getManager = () => (0, cloudbase_manager_js_1.getCloudBaseManager)({ cloudBaseOptions });
     // 读取安全规则 Tool
-    server.registerTool?.("readSecurityRule", {
+    server.registerTool?.(exports.READ_SECURITY_RULE, {
         title: "读取安全规则",
         description: `读取指定资源（noSQL 数据库、SQL 数据库、云函数、存储桶）的安全规则和权限类别。`,
         inputSchema: {
@@ -8004,7 +8008,7 @@ function registerSecurityRuleTools(server) {
         }
     });
     // 写入安全规则 Tool
-    server.registerTool?.("writeSecurityRule", {
+    server.registerTool?.(exports.WRITE_SECURITY_RULE, {
         title: "写入安全规则",
         description: `设置指定资源（数据库集合、云函数、存储桶）的安全规则。`,
         inputSchema: {
@@ -8249,7 +8253,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.0.4" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.0.6" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -8840,12 +8844,15 @@ deleteCollection: 删除数据`),
             collectionName: zod_1.z.string().describe("集合名称"),
             documents: zod_1.z
                 .array(zod_1.z.object({}).passthrough())
+                .optional()
                 .describe("要插入的文档对象数组,每个文档都是对象(insert 操作必填)"),
             query: zod_1.z
                 .union([zod_1.z.object({}).passthrough(), zod_1.z.string()])
+                .optional()
                 .describe("查询条件(对象或字符串,推荐对象)(update/delete 操作必填)"),
             update: zod_1.z
                 .union([zod_1.z.object({}).passthrough(), zod_1.z.string()])
+                .optional()
                 .describe("更新内容(对象或字符串,推荐对象)(update 操作必填)"),
             isMulti: zod_1.z
                 .boolean()
@@ -8865,6 +8872,9 @@ deleteCollection: 删除数据`),
         },
     }, async ({ action, collectionName, documents, query, update, isMulti, upsert, }) => {
         if (action === "insert") {
+            if (!documents) {
+                throw new Error("insert 操作时必须提供 documents");
+            }
             const text = await insertDocuments({
                 collectionName,
                 documents,
@@ -8880,6 +8890,12 @@ deleteCollection: 删除数据`),
             };
         }
         if (action === "update") {
+            if (!query) {
+                throw new Error("update 操作时必须提供 query");
+            }
+            if (!update) {
+                throw new Error("update 操作时必须提供 update");
+            }
             const text = await updateDocuments({
                 collectionName,
                 query,
@@ -8898,6 +8914,9 @@ deleteCollection: 删除数据`),
             };
         }
         if (action === "delete") {
+            if (!query) {
+                throw new Error("delete 操作时必须提供 query");
+            }
             const text = await deleteDocuments({
                 collectionName,
                 query,

package/package.json

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