@cloudbase/cloudbase-mcp 2.10.0 → 2.11.1

package/dist/index.js

@@ -562,7 +562,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.10.0" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.11.1" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -971,11 +971,43 @@ exports.resetInteractiveServer = resetInteractiveServer;
 exports.getInteractiveServerSafe = getInteractiveServerSafe;
 const express_1 = __importDefault(__webpack_require__(2674));
 const http_1 = __importDefault(__webpack_require__(3782));
+const child_process_1 = __webpack_require__(5814);
 const open_1 = __importDefault(__webpack_require__(1622));
 const ws_1 = __webpack_require__(6220);
 const index_js_1 = __webpack_require__(9529);
 const logger_js_1 = __webpack_require__(3039);
-// 动态导入 open 模块，兼容 ESM/CJS 环境
+function isVSCodeEnvironment() {
+    return Boolean(process.env.VSCODE_IPC_HOOK_CLI ||
+        process.env.VSCODE_PID ||
+        process.env.TERM_PROGRAM === "vscode");
+}
+function parseBrowserCommand(browser) {
+    const parts = browser.match(/(?:[^\s"]+|"[^"]*")+/g) || [];
+    return parts.map((item) => item.replace(/^"(.*)"$/, "$1"));
+}
+async function openUrlByBrowserEnv(url) {
+    const browser = process.env.BROWSER?.trim();
+    if (!browser) {
+        return false;
+    }
+    const [command, ...args] = parseBrowserCommand(browser);
+    if (!command) {
+        return false;
+    }
+    const finalArgs = args.map((arg) => (arg === "%s" ? url : arg));
+    if (!args.includes("%s")) {
+        finalArgs.push(url);
+    }
+    return new Promise((resolve) => {
+        (0, child_process_1.execFile)(command, finalArgs, (execError) => {
+            resolve(!execError);
+        });
+    });
+}
+function shouldUseBrowserEnvFallback() {
+    return process.platform === "linux" && isVSCodeEnvironment();
+}
+// Dynamic open behavior with IDE awareness and VSCode/Linux fallback
 async function openUrl(url, options, mcpServer) {
     // mcpServer 是 ExtendedMcpServer 实例，它有 server 和 ide 属性
     // server 属性是 MCP server 的内部 server 实例，有 sendLoggingMessage 方法
@@ -1007,13 +1039,28 @@ async function openUrl(url, options, mcpServer) {
             return;
         }
     }
-    // 默认行为：直接打开网页
+    // 默认行为：直接打开网页（带 VSCode/Linux 降级逻辑）
     (0, logger_js_1.debug)(`[openUrl] Opening URL in browser: ${url}`);
     try {
-        return await (0, open_1.default)(url, options);
+        const openOptions = options ? { url: true, ...options } : { url: true };
+        const child = await (0, open_1.default)(url, openOptions);
+        if (child?.once) {
+            child.once("error", async () => {
+                if (shouldUseBrowserEnvFallback()) {
+                    (0, logger_js_1.debug)("[openUrl] open() failed, trying BROWSER fallback");
+                    await openUrlByBrowserEnv(url);
+                }
+            });
+        }
+        return;
     }
     catch (err) {
         (0, logger_js_1.error)(`Failed to open ${url} ${options} ${err instanceof Error ? err.message : err} `, err instanceof Error ? err : new Error(String(err)));
+        if (shouldUseBrowserEnvFallback()) {
+            (0, logger_js_1.debug)("[openUrl] open() threw, trying BROWSER fallback");
+            await openUrlByBrowserEnv(url);
+            return;
+        }
         (0, logger_js_1.warn)(`Please manually open: ${url}`);
     }
 }
@@ -1038,10 +1085,15 @@ class InteractiveServer {
         3722, 3723, 3724, 3725, 3726, 3727, 3728, 3729, 3730, 3731, 3732, 3733,
         3734, 3735,
     ];
+    /** Idle timeout for HTTP/WS connections (e.g. long login). Avoids "connection disconnected" after ~1 min. */
+    static SERVER_IDLE_MS = 30 * 60 * 1000; // 30 minutes
+    /** WebSocket ping interval to keep connection alive past proxies/firewalls. */
+    static WS_PING_INTERVAL_MS = 25 * 1000; // 25 seconds
     constructor(mcpServer) {
         this._mcpServer = mcpServer;
         this.app = (0, express_1.default)();
         this.server = http_1.default.createServer(this.app);
+        this.applyServerTimeouts();
         this.wss = new ws_1.WebSocketServer({ server: this.server });
         this.setupExpress();
         this.setupWebSocket();
@@ -1057,6 +1109,16 @@ class InteractiveServer {
             this.isRunning = false;
         }
     }
+    /** Apply timeouts so long-lived login does not cause "connection disconnected". */
+    applyServerTimeouts() {
+        this.server.timeout = 0;
+        if (typeof this.server.keepAliveTimeout === "number") {
+            this.server.keepAliveTimeout = InteractiveServer.SERVER_IDLE_MS;
+        }
+        if (typeof this.server.headersTimeout === "number") {
+            this.server.headersTimeout = Math.max(this.server.headersTimeout || 0, InteractiveServer.SERVER_IDLE_MS);
+        }
+    }
     setupExpress() {
         this.app.use(express_1.default.json());
         this.app.get("/env-setup/:sessionId", (req, res) => {
@@ -1160,6 +1222,16 @@ class InteractiveServer {
     setupWebSocket() {
         this.wss.on("connection", (ws) => {
             (0, logger_js_1.debug)("WebSocket client connected");
+            // Keep connection alive during long login so proxies/firewalls do not close it
+            const pingInterval = setInterval(() => {
+                if (ws.readyState === ws_1.WebSocket.OPEN) {
+                    ws.ping();
+                }
+            }, InteractiveServer.WS_PING_INTERVAL_MS);
+            ws.on("close", () => {
+                clearInterval(pingInterval);
+                (0, logger_js_1.debug)("WebSocket client disconnected");
+            });
             ws.on("message", async (message) => {
                 try {
                     const data = JSON.parse(message.toString());
@@ -1269,9 +1341,6 @@ class InteractiveServer {
                     (0, logger_js_1.error)("WebSocket message parsing error", err instanceof Error ? err : new Error(String(err)));
                 }
             });
-            ws.on("close", () => {
-                (0, logger_js_1.debug)("WebSocket client disconnected");
-            });
         });
     }
     async start() {
@@ -1313,13 +1382,15 @@ class InteractiveServer {
                         reject(err);
                     }
                 };
+                // Host: default 0.0.0.0 so Cloud IDE / VSCode Remote port-forward can connect; set INTERACTIVE_SERVER_HOST=127.0.0.1 for local-only
+                const host = process.env.INTERACTIVE_SERVER_HOST ?? "0.0.0.0";
                 // 设置成功监听处理
                 const listeningHandler = () => {
                     const address = this.server.address();
                     if (address && typeof address === "object") {
                         this.port = address.port;
                         this.isRunning = true;
-                        (0, logger_js_1.info)(`Interactive server started successfully on http://localhost:${this.port}`);
+                        (0, logger_js_1.info)(`Interactive server started successfully on http://${host}:${this.port}`);
                         // 移除临时监听器
                         this.server.removeListener("error", errorHandler);
                         this.server.removeListener("listening", listeningHandler);
@@ -1334,7 +1405,7 @@ class InteractiveServer {
                 this.server.once("error", errorHandler);
                 this.server.once("listening", listeningHandler);
                 try {
-                    this.server.listen(portToTry, "127.0.0.1");
+                    this.server.listen(portToTry, host);
                 }
                 catch (err) {
                     (0, logger_js_1.error)(`Failed to bind to port ${portToTry}:`, err instanceof Error ? err : new Error(String(err)));
@@ -1375,6 +1446,7 @@ class InteractiveServer {
                             this.port = 0;
                             // 重新创建整个服务器实例以便下次使用
                             this.server = http_1.default.createServer(this.app);
+                            this.applyServerTimeouts();
                             this.wss = new ws_1.WebSocketServer({ server: this.server });
                             this.setupWebSocket();
                             (0, logger_js_1.debug)("HTTP and WebSocket servers recreated for next use");
@@ -1465,11 +1537,9 @@ class InteractiveServer {
                 (0, logger_js_1.warn)(`Please manually open: ${url}`);
             }
             (0, logger_js_1.info)("Waiting for user selection...");
-            // Use shorter timeout for CodeBuddy when notification is sent (2 minutes)
-            // This prevents hanging while still giving users enough time to respond
-            // Otherwise use the default 10 minutes timeout
-            const timeoutDuration = (isCodeBuddy && notificationSent) ? 2 * 60 * 1000 : 10 * 60 * 1000;
-            (0, logger_js_1.debug)(`[collectEnvId] Using timeout duration: ${timeoutDuration / 1000} seconds (CodeBuddy: ${isCodeBuddy}, notification sent: ${notificationSent})`);
+            // Use same 10 minutes for all IDEs so long login (re-auth, switch account) does not close the server
+            const timeoutDuration = 10 * 60 * 1000;
+            (0, logger_js_1.debug)(`[collectEnvId] Using timeout duration: ${timeoutDuration / 1000} seconds`);
             return new Promise((resolve) => {
                 this.currentResolver = (result) => {
                     // 用户选择完成后，关闭服务器
@@ -5267,8 +5337,11 @@ checkIndex: 检查索引是否存在`),
         title: "修改 NoSQL 数据库结构",
         description: "修改 NoSQL 数据库结构",
         inputSchema: {
-            action: zod_1.z.enum(["createCollection", "updateCollection", "deleteCollection"])
-                .describe(`createCollection: 创建集合
+            action: zod_1.z.enum([
+                "createCollection",
+                "updateCollection",
+                "deleteCollection",
+            ]).describe(`createCollection: 创建集合
 updateCollection: 更新集合
 deleteCollection: 删除集合`),
             collectionName: zod_1.z.string().describe("集合名称"),
@@ -5348,9 +5421,7 @@ deleteCollection: 删除集合`),
                 success: true,
                 requestId: result.RequestId,
                 action,
-                message: result.Exists === false
-                    ? "集合不存在"
-                    : "云开发数据库集合删除成功",
+                message: result.Exists === false ? "集合不存在" : "云开发数据库集合删除成功",
             };
             if (result.Exists === false) {
                 body.exists = false;
@@ -5381,9 +5452,17 @@ deleteCollection: 删除集合`),
                 .optional()
                 .describe("返回字段投影(对象或字符串,推荐对象)"),
             sort: zod_1.z
-                .union([zod_1.z.object({}).passthrough(), zod_1.z.string()])
+                .union([
+                zod_1.z.array(zod_1.z
+                    .object({
+                    key: zod_1.z.string().describe("sort 字段名"),
+                    direction: zod_1.z.number().describe("排序方向,1:升序,-1:降序"),
+                })
+                    .passthrough()),
+                zod_1.z.string(),
+            ])
                 .optional()
-                .describe("排序条件(对象或字符串,推荐对象)"),
+                .describe("排序条件，使用对象或字符串。"),
             limit: zod_1.z.number().optional().describe("返回数量限制"),
             offset: zod_1.z.number().optional().describe("跳过的记录数"),
         },
@@ -5429,7 +5508,8 @@ deleteCollection: 删除集合`),
         title: "修改 NoSQL 数据库数据记录",
         description: "修改 NoSQL 数据库数据记录",
         inputSchema: {
-            action: zod_1.z.enum(["insert", "update", "delete"])
+            action: zod_1.z
+                .enum(["insert", "update", "delete"])
                 .describe(`insert: 插入数据（新增文档）\nupdate: 更新数据\ndelete: 删除数据`),
             collectionName: zod_1.z.string().describe("集合名称"),
             documents: zod_1.z
@@ -8606,7 +8686,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.10.0" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.11.1" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -10039,7 +10119,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.10.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- 其他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.11.1" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -11448,8 +11528,10 @@ function getJavaScripts(wsPort) {
     }
   }
 
-  // WebSocket connection
-  const ws = new WebSocket('ws://localhost:${wsPort}');
+  // WebSocket: same host as page so it works in remote VS Code / Cloud IDE (no localhost)
+  const wsScheme = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
+  const wsUrl = wsScheme + '//' + window.location.host;
+  const ws = new WebSocket(wsUrl);
   
   ws.onopen = () => {
     console.log('[env-setup] WebSocket connected');

package/package.json

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