@cloudbase/cloudbase-mcp 2.0.5 → 2.1.0

package/dist/index.js

@@ -4,6 +4,7 @@ import * as __WEBPACK_EXTERNAL_MODULE__cloudbase_cals_lib_cjs_utils_mermaid_data
 import * as __WEBPACK_EXTERNAL_MODULE_ws__ from "ws";
 import * as __WEBPACK_EXTERNAL_MODULE_winston_daily_rotate_file_69928d76__ from "winston-daily-rotate-file";
 import * as __WEBPACK_EXTERNAL_MODULE_winston__ from "winston";
+import * as __WEBPACK_EXTERNAL_MODULE__modelcontextprotocol_sdk_types_js_70eb1363__ from "@modelcontextprotocol/sdk/types.js";
 import * as __WEBPACK_EXTERNAL_MODULE_net__ from "net";
 import * as __WEBPACK_EXTERNAL_MODULE_fs__ from "fs";
 import * as __WEBPACK_EXTERNAL_MODULE__modelcontextprotocol_sdk_server_stdio_js_25848778__ from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -38,6 +39,7 @@ const fs_1 = __importDefault(__webpack_require__(421));
 const path_1 = __importDefault(__webpack_require__(521));
 const zod_1 = __webpack_require__(971);
 const cloudbase_manager_js_1 = __webpack_require__(431);
+const notification_js_1 = __webpack_require__(720);
 // CloudRun service types
 exports.CLOUDRUN_SERVICE_TYPES = ['function', 'container'];
 // CloudRun access types
@@ -542,6 +544,58 @@ for await (let x of res.textStream) {
                     catch (error) {
                         // Ignore cloudbaserc.json creation errors
                     }
+                    // Send deployment notification to CodeBuddy IDE
+                    try {
+                        // Query service details to get access URL
+                        let serviceUrl = "";
+                        try {
+                            const serviceDetails = await cloudrunService.detail({ serverName: input.serverName });
+                            // Extract access URL from service details
+                            // Priority: DefaultDomainName > CustomDomainName > PublicDomain > InternalDomain
+                            const details = serviceDetails; // Use any to access dynamic properties
+                            if (details?.BaseInfo?.DefaultDomainName) {
+                                // DefaultDomainName is already a complete URL (e.g., https://...)
+                                serviceUrl = details.BaseInfo.DefaultDomainName;
+                            }
+                            else if (details?.BaseInfo?.CustomDomainName) {
+                                // CustomDomainName might be a domain without protocol
+                                const customDomain = details.BaseInfo.CustomDomainName;
+                                serviceUrl = customDomain.startsWith('http') ? customDomain : `https://${customDomain}`;
+                            }
+                            else if (details?.BaseInfo?.PublicDomain) {
+                                serviceUrl = `https://${details.BaseInfo.PublicDomain}`;
+                            }
+                            else if (details?.BaseInfo?.InternalDomain) {
+                                serviceUrl = `https://${details.BaseInfo.InternalDomain}`;
+                            }
+                            else if (details?.AccessInfo?.PublicDomain) {
+                                serviceUrl = `https://${details.AccessInfo.PublicDomain}`;
+                            }
+                            else {
+                                serviceUrl = ""; // URL not available
+                            }
+                        }
+                        catch (detailErr) {
+                            // If query fails, continue with empty URL
+                            serviceUrl = "";
+                        }
+                        // Extract project name from targetPath
+                        const projectName = path_1.default.basename(targetPath);
+                        // Build console URL
+                        const consoleUrl = `https://tcb.cloud.tencent.com/dev?envId=${currentEnvId}#/platform-run/service/detail?serverName=${input.serverName}&tabId=overview&envId=${currentEnvId}`;
+                        // Send notification
+                        await (0, notification_js_1.sendDeployNotification)(server, {
+                            deployType: 'cloudrun',
+                            url: serviceUrl,
+                            projectId: currentEnvId,
+                            projectName: projectName,
+                            consoleUrl: consoleUrl
+                        });
+                    }
+                    catch (notifyErr) {
+                        // Notification failure should not affect deployment flow
+                        // Error is already logged in sendDeployNotification
+                    }
                     return {
                         content: [
                             {
@@ -2664,6 +2718,7 @@ async function registerRagTools(server) {
         }
     });
     let skills = [];
+    let openapis = [];
     // 知识库检索
     try {
         skills = await prepareKnowledgeBaseWebTemplate();
@@ -2673,22 +2728,40 @@ async function registerRagTools(server) {
             error,
         });
     }
+    // OpenAPI 文档准备
+    try {
+        openapis = await prepareOpenAPIDocs();
+    }
+    catch (error) {
+        (0, logger_js_1.warn)("[searchKnowledgeBase] Failed to prepare OpenAPI docs", {
+            error,
+        });
+    }
     server.registerTool?.("searchKnowledgeBase", {
         title: "云开发知识库检索",
-        description: `云开发知识库智能检索工具，支持向量查询 (vector) 和固定文档 (doc) 查询。
+        description: `云开发知识库智能检索工具，支持向量查询 (vector)、固定文档 (doc) 和 OpenAPI 文档 (openapi) 查询。
 
-      强烈推荐始终优先使用固定文档 (doc) 模式进行检索，仅当固定文档无法覆盖你的问题时，再使用向量查询 (vector) 模式。
+      强烈推荐始终优先使用固定文档 (doc) 或 OpenAPI 文档 (openapi) 模式进行检索，仅当固定文档无法覆盖你的问题时，再使用向量查询 (vector) 模式。
 
       固定文档 (doc) 查询当前支持 ${skills.length} 个固定文档，分别是：
       ${skills
             .map((skill) => `文档名：${path.basename(path.dirname(skill.absolutePath))} 文档介绍：${skill.description}`)
+            .join("\n")}
+
+      OpenAPI 文档 (openapi) 查询当前支持 ${openapis.length} 个 API 文档，分别是：
+      ${openapis
+            .map((api) => `API名：${api.name} API介绍：${api.description}`)
             .join("\n")}`,
         inputSchema: {
-            mode: zod_1.z.enum(["vector", "doc"]),
+            mode: zod_1.z.enum(["vector", "doc", "openapi"]),
             docName: zod_1.z
                 .enum(skills.map((skill) => path.basename(path.dirname(skill.absolutePath))))
                 .optional()
                 .describe("mode=doc 时指定。文档名称。"),
+            apiName: zod_1.z
+                .enum(openapis.map((api) => api.name))
+                .optional()
+                .describe("mode=openapi 时指定。API 名称。"),
             threshold: zod_1.z
                 .number()
                 .default(0.5)
@@ -2718,7 +2791,7 @@ async function registerRagTools(server) {
             openWorldHint: true,
             category: "rag",
         },
-    }, async ({ id, content, options: { chunkExpand = [3, 3] } = {}, limit = 5, threshold = 0.5, mode, docName, }) => {
+    }, async ({ id, content, options: { chunkExpand = [3, 3] } = {}, limit = 5, threshold = 0.5, mode, docName, apiName, }) => {
         if (mode === "doc") {
             const absolutePath = skills.find((skill) => skill.absolutePath.includes(docName)).absolutePath;
             return {
@@ -2730,6 +2803,27 @@ async function registerRagTools(server) {
                 ],
             };
         }
+        if (mode === "openapi") {
+            const api = openapis.find((api) => api.name === apiName);
+            if (!api) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `OpenAPI document "${apiName}" not found. Available APIs: ${openapis.map((a) => a.name).join(", ")}`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `OpenAPI document: ${api.name}\nDescription: ${api.description}\nPath: ${api.absolutePath}\n\n${(await fs.readFile(api.absolutePath)).toString()}`,
+                    },
+                ],
+            };
+        }
         // 枚举到后端 id 映射
         const backendId = KnowledgeBaseIdMap[id] || id;
         const signInRes = await fetch("https://tcb-advanced-a656fc.api.tcloudbasegateway.com/auth/v1/signin/anonymously", {
@@ -2806,6 +2900,65 @@ 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) {
@@ -3106,13 +3259,19 @@ module.exports = __WEBPACK_EXTERNAL_MODULE_winston_daily_rotate_file_69928d76__;
 /***/ }),
 
 /***/ 279:
-/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+/***/ (function(__unused_webpack_module, exports, __webpack_require__) {
 
 
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.registerHostingTools = registerHostingTools;
+const fs_1 = __importDefault(__webpack_require__(421));
+const path_1 = __importDefault(__webpack_require__(521));
 const zod_1 = __webpack_require__(971);
 const cloudbase_manager_js_1 = __webpack_require__(431);
+const notification_js_1 = __webpack_require__(720);
 function registerHostingTools(server) {
     // 获取 cloudBaseOptions，如果没有则为 undefined
     const cloudBaseOptions = server.cloudBaseOptions;
@@ -3149,6 +3308,43 @@ function registerHostingTools(server) {
         // 获取环境信息
         const envInfo = await cloudbase.env.getEnvInfo();
         const staticDomain = envInfo.EnvInfo?.StaticStorages?.[0]?.StaticDomain;
+        const accessUrl = staticDomain ? `https://${staticDomain}/${cloudPath || ''}` : "";
+        // Send deployment notification to CodeBuddy IDE
+        try {
+            const envId = await (0, cloudbase_manager_js_1.getEnvId)(cloudBaseOptions);
+            // Extract project name from localPath
+            let projectName = "unknown";
+            if (localPath) {
+                try {
+                    // If localPath is a file, get parent directory name; if it's a directory, get directory name
+                    const stats = fs_1.default.statSync(localPath);
+                    if (stats.isFile()) {
+                        projectName = path_1.default.basename(path_1.default.dirname(localPath));
+                    }
+                    else {
+                        projectName = path_1.default.basename(localPath);
+                    }
+                }
+                catch (statErr) {
+                    // If stat fails, try to extract from path directly
+                    projectName = path_1.default.basename(localPath);
+                }
+            }
+            // Build console URL
+            const consoleUrl = `https://tcb.cloud.tencent.com/dev?envId=${envId}#/static-hosting`;
+            // Send notification
+            await (0, notification_js_1.sendDeployNotification)(server, {
+                deployType: 'hosting',
+                url: accessUrl,
+                projectId: envId,
+                projectName: projectName,
+                consoleUrl: consoleUrl
+            });
+        }
+        catch (notifyErr) {
+            // Notification failure should not affect deployment flow
+            // Error is already logged in sendDeployNotification
+        }
         return {
             content: [
                 {
@@ -3157,7 +3353,7 @@ function registerHostingTools(server) {
                         ...result,
                         staticDomain,
                         message: "文件上传成功",
-                        accessUrl: staticDomain ? `https://${staticDomain}/${cloudPath || ''}` : "请检查静态托管配置"
+                        accessUrl: accessUrl
                     }, null, 2)
                 }
             ]
@@ -5659,6 +5855,13 @@ async function getInteractiveServerSafe(mcpServer) {
 }
 
 
+/***/ }),
+
+/***/ 344:
+/***/ ((module) => {
+
+module.exports = __WEBPACK_EXTERNAL_MODULE__modelcontextprotocol_sdk_types_js_70eb1363__;
+
 /***/ }),
 
 /***/ 357:
@@ -6021,7 +6224,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.0.5" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.1.0" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -6188,7 +6391,7 @@ function registerSQLDatabaseTools(server) {
     // executeReadOnlySQL
     server.registerTool?.("executeReadOnlySQL", {
         title: "Execute read-only SQL query",
-        description: "Execute a read-only SQL query on the SQL database. 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 read-only SQL query on the SQL database. Note: For per-user ACL, each table should contain a fixed `_openid` column defined as `_openid VARCHAR(64) DEFAULT '' NOT NULL` that represents the user and is used for access control.",
         inputSchema: {
             sql: zod_1.z.string().describe("SQL query statement (SELECT queries only)"),
         },
@@ -6247,7 +6450,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.). Whenever you create a new table, you **must** contain a fixed `_opeid` 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** include a fixed `_openid` column defined as `_openid VARCHAR(64) DEFAULT '' NOT NULL` that represents the user and is used for access control.",
         inputSchema: {
             sql: zod_1.z
                 .string()
@@ -6339,12 +6542,14 @@ const rag_js_1 = __webpack_require__(215);
 const setup_js_1 = __webpack_require__(556);
 const storage_js_1 = __webpack_require__(848);
 // import { registerMiniprogramTools } from "./tools/miniprogram.js";
+const types_js_1 = __webpack_require__(344);
 const cloudrun_js_1 = __webpack_require__(23);
 const dataModel_js_1 = __webpack_require__(52);
 const gateway_js_1 = __webpack_require__(319);
 const invite_code_js_1 = __webpack_require__(760);
 const security_rule_js_1 = __webpack_require__(862);
 const cloud_mode_js_1 = __webpack_require__(684);
+const logger_js_1 = __webpack_require__(39);
 const tool_wrapper_js_1 = __webpack_require__(363);
 // 默认插件列表
 const DEFAULT_PLUGINS = [
@@ -6445,6 +6650,13 @@ async function createCloudBaseMcpServer(options) {
             ...(ide === "CodeBuddy" ? { logging: {} } : {}),
         },
     });
+    // Only set logging handler if logging capability is declared
+    if (ide === "CodeBuddy") {
+        server.server.setRequestHandler(types_js_1.SetLevelRequestSchema, (request, extra) => {
+            (0, logger_js_1.info)(`--- Logging level: ${request.params.level}`);
+            return {};
+        });
+    }
     // Store cloudBaseOptions in server instance for tools to access
     if (cloudBaseOptions) {
         server.cloudBaseOptions = cloudBaseOptions;
@@ -6475,10 +6687,10 @@ function getDefaultServer() {
 }
 var stdio_js_1 = __webpack_require__(448);
 Object.defineProperty(exports, "StdioServerTransport", ({ enumerable: true, get: function () { return stdio_js_1.StdioServerTransport; } }));
-var logger_js_1 = __webpack_require__(39);
-Object.defineProperty(exports, "error", ({ enumerable: true, get: function () { return logger_js_1.error; } }));
-Object.defineProperty(exports, "info", ({ enumerable: true, get: function () { return logger_js_1.info; } }));
-Object.defineProperty(exports, "warn", ({ enumerable: true, get: function () { return logger_js_1.warn; } }));
+var logger_js_2 = __webpack_require__(39);
+Object.defineProperty(exports, "error", ({ enumerable: true, get: function () { return logger_js_2.error; } }));
+Object.defineProperty(exports, "info", ({ enumerable: true, get: function () { return logger_js_2.info; } }));
+Object.defineProperty(exports, "warn", ({ enumerable: true, get: function () { return logger_js_2.warn; } }));
 var telemetry_js_1 = __webpack_require__(880);
 Object.defineProperty(exports, "reportToolCall", ({ enumerable: true, get: function () { return telemetry_js_1.reportToolCall; } }));
 Object.defineProperty(exports, "reportToolkitLifecycle", ({ enumerable: true, get: function () { return telemetry_js_1.reportToolkitLifecycle; } }));
@@ -7211,7 +7423,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.5" : 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.1.0" : 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配置）"),
@@ -7487,6 +7699,52 @@ function shouldRegisterTool(toolName) {
 }
 
 
+/***/ }),
+
+/***/ 720:
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.sendDeployNotification = sendDeployNotification;
+const logger_js_1 = __webpack_require__(39);
+/**
+ * Send deployment notification to CodeBuddy IDE
+ * @param server ExtendedMcpServer instance
+ * @param notificationData Deployment notification data
+ */
+async function sendDeployNotification(server, notificationData) {
+    // Check if current IDE is CodeBuddy (prefer server.ide, fallback to environment variable)
+    const currentIde = server.ide || process.env.INTEGRATION_IDE;
+    if (currentIde !== 'CodeBuddy' || !server.server) {
+        // Not CodeBuddy IDE, skip notification
+        return;
+    }
+    try {
+        // Send notification using sendLoggingMessage
+        server.server.sendLoggingMessage({
+            level: "notice",
+            data: {
+                type: "tcb",
+                event: "deploy",
+                data: {
+                    type: notificationData.deployType, // "hosting" or "cloudrun"
+                    url: notificationData.url,
+                    projectId: notificationData.projectId,
+                    projectName: notificationData.projectName,
+                    consoleUrl: notificationData.consoleUrl
+                }
+            }
+        });
+        (0, logger_js_1.info)(`CodeBuddy IDE: 已发送部署通知 - ${notificationData.deployType} - ${notificationData.url}`);
+    }
+    catch (err) {
+        // Log error but don't throw - notification failure should not affect deployment flow
+        (0, logger_js_1.error)(`Failed to send deployment notification: ${err instanceof Error ? err.message : err}`, err);
+    }
+}
+
+
 /***/ }),
 
 /***/ 760:
@@ -8253,7 +8511,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.5" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.1.0" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -8844,12 +9102,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()
@@ -8869,6 +9130,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,
@@ -8884,6 +9148,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,
@@ -8902,6 +9172,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.5",
+  "version": "2.1.0",
   "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",