@cloudbase/cloudbase-mcp 1.8.4 → 1.8.6

package/README.md

@@ -37,6 +37,8 @@
 |---|---|
 | 🤖 **AI智能开发**: AI自动生成代码和架构设计<br>☁️ **云开发集成**: 一键接入数据库、云函数、静态托管<br>⚡ **快速部署**: 几分钟内完成全栈应用上线 | **Web应用**: 现代化前端 + 静态托管<br>**微信小程序**: 云开发小程序解决方案<br>**后端服务**: 云数据库 + 无服务器函数+云托管 |
 
+📚 [快速开始](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/getting-started) | 🛠️ [IDE配置](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/) | 🎨 [项目模板](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/templates) | 📖 [开发指南](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/development) | 🎮 [使用案例](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/examples) | 🎓 [教程](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/tutorials) | 🔧 [MCP工具](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/mcp-tools) | ❓ [常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq)
+
 
 </div> 
 
@@ -147,6 +149,7 @@ npx -y clear-npx-cache
 | [文心快码](https://comate.baidu.com/) | VS Code、JetBrains插件|
 | [Augment Code](https://www.augmentcode.com/) | VS Code、JetBrains 插件 |
 | [Claude Code](https://www.anthropic.com/claude-code) | 命令行工具 |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | 命令行工具 |
 
 <details>
 <summary><strong>🔧 Cursor 配置</strong></summary>
@@ -157,7 +160,11 @@ npx -y clear-npx-cache
 
 #### 步骤2：配置 MCP
 
-如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，可以点击下方按钮安装到 Cursor 中：
+
+> [!TIP] 
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
+如果使用模板项目，MCP 配置已经预置完成，请点击左下角的弹出的窗口启用MCP。如果不是从模板开始，可以点击下方按钮安装到 Cursor 中：
 
 [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=CloudBase&config=eyJjb21tYW5kIjoibnB4IEBjbG91ZGJhc2UvY2xvdWRiYXNlLW1jcEBsYXRlc3QiLCJkaXNhYmxlZCI6ZmFsc2V9)
 
@@ -191,6 +198,9 @@ npx -y clear-npx-cache
 
 #### 步骤2：配置 MCP
 
+> [!TIP] 
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
 如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 WindSurf 的 Plugins 配置中添加：
 
 ```json
@@ -204,6 +214,9 @@ npx -y clear-npx-cache
 }
 ```
 
+
+
+
 #### 步骤3：切换到 Write 模式
 
 在对话中切换到 Write 模式进行智能生成。
@@ -219,7 +232,12 @@ npx -y clear-npx-cache
 
 #### 步骤2：配置 MCP
 
-点开 CodeBuddy 右上角的 MCP 按钮，点击右侧的添加，在 MCP 配置中添加云开发的 MCP
+
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
+1. 可以在 点开 CodeBuddy 右上角的 MCP 按钮，在 MCP 市场中搜索 CloudBase，然后点击安装即可。
+
+2. 也可以手动添加，点开 CodeBuddy 右上角的 MCP 按钮，点击右侧的添加，在 MCP 配置中添加云开发的 MCP
 
 ```json
 {
@@ -232,6 +250,9 @@ npx -y clear-npx-cache
 }
 ```
 
+
+
+
 #### 步骤3：切换到 Craft 智能体
 
 在对话窗口中切换到 Craft 模式。建议在右侧设置中关闭确认计划功能，以获得更流畅的体验。
@@ -247,6 +268,10 @@ npx -y clear-npx-cache
 
 #### 步骤2：配置 MCP
 
+
+> [!TIP] 
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
 如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP Server 配置中添加：
 
 ```json
@@ -281,6 +306,10 @@ npx -y clear-npx-cache
 
 #### 步骤2：配置 MCP
 
+
+> [!TIP] 
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
 如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 `.vscode/mcp.json` 中添加：
 
 ```json
@@ -313,7 +342,11 @@ npx -y clear-npx-cache
 
 #### 步骤2：配置 MCP
 
-如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP 配置中添加：
+
+> [!TIP] 
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
+需要在 Trae 的MCP 配置中添加：
 
 ```json
 {
@@ -341,6 +374,10 @@ npx -y clear-npx-cache
 
 #### 步骤2：配置 MCP
 
+
+> [!TIP] 
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
 如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP 配置中添加：
 
 ```json
@@ -369,6 +406,10 @@ npx -y clear-npx-cache
 
 #### 步骤2：配置 MCP
 
+
+> [!TIP] 
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
 如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP 配置中添加：
 
 ```json
@@ -400,6 +441,10 @@ npx -y clear-npx-cache
 
 #### 步骤2：配置 MCP
 
+
+> [!TIP] 
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
 如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP 配置中添加：
 
 ```json
@@ -435,6 +480,10 @@ npx -y clear-npx-cache
 
 #### 步骤2：配置 MCP
 
+
+> [!TIP] 
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
 如果使用模板项目，MCP 配置已经预置完成(内置在`.vscode/settings.json`中)。如果不是从模板开始，需要在 Augment的 MCP 配置中添加云开发 MCP，[参考文档](https://docs.augmentcode.com/setup-augment/mcp)：
 
 ```json
@@ -467,6 +516,10 @@ npx -y clear-npx-cache
 
 #### 步骤2：配置 MCP
 
+
+> [!TIP] 
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
 如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在项目根目录创建 `.mcp.json` 文件：
 
 ```json
@@ -489,6 +542,79 @@ npx -y clear-npx-cache
 
 </details>
 
+<details>
+<summary><strong>🔹 Gemini CLI 配置</strong></summary>
+
+#### 步骤1：安装 Gemini CLI
+
+确保安装 Node.js 18+，然后全局安装 Gemini CLI：
+
+```bash
+npm install -g @google/gemini-cli
+```
+
+或直接运行：
+
+```bash
+npx @google/gemini-cli
+```
+
+首次运行时，使用个人 Google 账户登录即可获得免费额度（每分钟 60 次请求，每天 1000 次请求）。
+
+#### 步骤2：配置 MCP
+
+> [!TIP] 
+> 如果安装以后工具数量一直为 0，请参考[常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq#mcp-%E6%98%BE%E7%A4%BA%E5%B7%A5%E5%85%B7%E6%95%B0%E9%87%8F%E4%B8%BA-0-%E6%80%8E%E4%B9%88%E5%8A%9E)
+
+
+如果使用模板项目，MCP 配置已经预置完成。
+
+如果不是从模板开始，可以在用户主目录（`~`）或项目目录中创建 `.gemini/settings.json` 文件：
+
+```json
+{
+  "mcpServers": {
+    "cloudbase-mcp": {
+      "command": "npx",
+      "args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
+    }
+  }
+}
+```
+
+#### 步骤3：启用 AI 规则
+
+
+模板项目根目录已经包含 `GEMINI.md` 文件，包含 CloudBase 开发规则。
+
+如果是现有项目，在 Gemini CLI 中对 AI 说：
+
+```
+在当前项目中下载云开发 AI 规则
+```
+
+#### 步骤4：开始开发
+
+启动 Gemini CLI：
+
+```bash
+gemini
+```
+
+然后对 AI 说：
+
+```
+登录云开发
+```
+
+**常用命令：**
+- `/tools` - 查看可用工具
+- `/mcp` - 查看 MCP 服务器状态
+- `/memory show` - 查看当前规则
+- `!command` - 执行 Shell 命令
+
+</details>
+
 <details>
 <summary><strong>🔄 更新 CloudBase AI ToolKit</strong></summary>
 
@@ -565,6 +691,20 @@ AI 会自动：
 
 
 
+## 📚 教程
+
+### 📄 文章
+- [1小时开发微信小游戏《我的早餐店》——基于CloudBase AI Toolkit](https://cloud.tencent.com/developer/article/2532595)
+- [AI Coding宝藏组合：Cursor + Cloudbase-AI-Toolkit 开发游戏实战](https://juejin.cn/post/7518783423277695028#comment)
+
+### 📱 应用项目
+- [简历助手小程序](https://gitcode.com/qq_33681891/resume_template)
+
+### 🎥 视频教程
+- [云开发CloudBase：用AI开发一款分手厨房小游戏](https://www.bilibili.com/video/BV1v5KAzwEf9/)
+
+---
+
 ## 🎯 使用案例
 
 ### 案例1：双人在线对战五子棋

package/dist/cli.cjs

@@ -128,7 +128,7 @@ var init_logger = __esm({
     logger = new Logger({
       enabled: (process.env.MCP_DEBUG ?? "true") === "true",
       level: 0 /* DEBUG */,
-      console: process.env.NODE_ENV === "development" || process.env.MCP_CONSOLE_LOG === "true"
+      console: process.env.MCP_CONSOLE_LOG === "true"
     });
     debug = (message, data) => logger.debug(message, data);
     info = (message, data) => logger.info(message, data);
@@ -177,20 +177,29 @@ var init_auth = __esm({
 });
 
 // src/interactive-server.ts
+async function openUrl(url, options) {
+  try {
+    const openModule = await import("open");
+    const open = openModule.default || openModule;
+    return await open(url, options);
+  } catch (err) {
+    error("Failed to import or use open module", err);
+    warn(`Please manually open: ${url}`);
+  }
+}
 function getInteractiveServer() {
   if (!interactiveServerInstance) {
     interactiveServerInstance = new InteractiveServer();
   }
   return interactiveServerInstance;
 }
-var import_express, import_http, import_ws, import_open, import_path2, import_url, import_meta, getFilename, __filename, __dirname, InteractiveServer, interactiveServerInstance;
+var import_express, import_http, import_ws, import_path2, import_url, import_meta, getFilename, __filename, __dirname, InteractiveServer, interactiveServerInstance;
 var init_interactive_server = __esm({
   "src/interactive-server.ts"() {
     "use strict";
     import_express = __toESM(require("express"), 1);
     import_http = __toESM(require("http"), 1);
     import_ws = require("ws");
-    import_open = __toESM(require("open"), 1);
     import_path2 = __toESM(require("path"), 1);
     import_url = require("url");
     init_logger();
@@ -202,7 +211,10 @@ var init_interactive_server = __esm({
       if (typeof globalThis.__filename === "string") {
         return globalThis.__filename;
       }
-      return require.main?.filename || process.cwd() + "/interactive-server.js";
+      if (typeof require !== "undefined" && require.main && require.main.filename) {
+        return require.main.filename;
+      }
+      return import_path2.default.join(process.cwd(), "interactive-server.js");
     };
     __filename = getFilename();
     __dirname = import_path2.default.dirname(__filename);
@@ -438,7 +450,7 @@ var init_interactive_server = __esm({
           const url = `http://localhost:${port}/env-setup/${sessionId}`;
           info(`Opening browser: ${url}`);
           try {
-            await (0, import_open.default)(url, { wait: false });
+            await openUrl(url, { wait: false });
             info("Browser opened successfully");
           } catch (browserError) {
             error("Failed to open browser", browserError);
@@ -468,7 +480,7 @@ var init_interactive_server = __esm({
           this.sessionData.delete(sessionId);
         }, 5 * 60 * 1e3);
         const url = `http://localhost:${port}/clarification/${sessionId}`;
-        await (0, import_open.default)(url);
+        await openUrl(url);
         return new Promise((resolve2) => {
           this.currentResolver = resolve2;
         });
@@ -3114,10 +3126,9 @@ function registerEnvTools(server2) {
     "envQuery",
     {
       title: "\u73AF\u5883\u67E5\u8BE2",
-      description: "\u67E5\u8BE2\u4E91\u5F00\u53D1\u73AF\u5883\u76F8\u5173\u4FE1\u606F\uFF0C\u652F\u6301\u67E5\u8BE2\u73AF\u5883\u5217\u8868\u3001\u5F53\u524D\u73AF\u5883\u4FE1\u606F\u548C\u5B89\u5168\u57DF\u540D",
+      description: "\u67E5\u8BE2\u4E91\u5F00\u53D1\u73AF\u5883\u76F8\u5173\u4FE1\u606F\uFF0C\u652F\u6301\u67E5\u8BE2\u73AF\u5883\u5217\u8868\u3001\u5F53\u524D\u73AF\u5883\u4FE1\u606F\u548C\u5B89\u5168\u57DF\u540D\u3002\uFF08\u539F\u5DE5\u5177\u540D\uFF1AlistEnvs/getEnvInfo/getEnvAuthDomains\uFF0C\u4E3A\u517C\u5BB9\u65E7AI\u89C4\u5219\u53EF\u7EE7\u7EED\u4F7F\u7528\u8FD9\u4E9B\u540D\u79F0\uFF09",
       inputSchema: {
-        action: import_zod2.z.enum(["list", "info", "domains"]).describe("\u67E5\u8BE2\u7C7B\u578B\uFF1Alist=\u73AF\u5883\u5217\u8868\uFF0Cinfo=\u5F53\u524D\u73AF\u5883\u4FE1\u606F\uFF0Cdomains=\u5B89\u5168\u57DF\u540D\u5217\u8868"),
-        confirm: import_zod2.z.literal("yes").optional().describe("\u786E\u8BA4\u64CD\u4F5C\uFF0C\u9ED8\u8BA4\u4F20 yes")
+        action: import_zod2.z.enum(["list", "info", "domains"]).describe("\u67E5\u8BE2\u7C7B\u578B\uFF1Alist=\u73AF\u5883\u5217\u8868\uFF0Cinfo=\u5F53\u524D\u73AF\u5883\u4FE1\u606F\uFF0Cdomains=\u5B89\u5168\u57DF\u540D\u5217\u8868")
       },
       annotations: {
         readOnlyHint: true,
@@ -3164,7 +3175,7 @@ function registerEnvTools(server2) {
     "envDomainManagement",
     {
       title: "\u73AF\u5883\u57DF\u540D\u7BA1\u7406",
-      description: "\u7BA1\u7406\u4E91\u5F00\u53D1\u73AF\u5883\u7684\u5B89\u5168\u57DF\u540D\uFF0C\u652F\u6301\u6DFB\u52A0\u548C\u5220\u9664\u64CD\u4F5C",
+      description: "\u7BA1\u7406\u4E91\u5F00\u53D1\u73AF\u5883\u7684\u5B89\u5168\u57DF\u540D\uFF0C\u652F\u6301\u6DFB\u52A0\u548C\u5220\u9664\u64CD\u4F5C\u3002\uFF08\u539F\u5DE5\u5177\u540D\uFF1AcreateEnvDomain/deleteEnvDomain\uFF0C\u4E3A\u517C\u5BB9\u65E7AI\u89C4\u5219\u53EF\u7EE7\u7EED\u4F7F\u7528\u8FD9\u4E9B\u540D\u79F0\uFF09",
       inputSchema: {
         action: import_zod2.z.enum(["create", "delete"]).describe("\u64CD\u4F5C\u7C7B\u578B\uFF1Acreate=\u6DFB\u52A0\u57DF\u540D\uFF0Cdelete=\u5220\u9664\u57DF\u540D"),
         domains: import_zod2.z.array(import_zod2.z.string()).describe("\u5B89\u5168\u57DF\u540D\u6570\u7EC4")
@@ -4008,7 +4019,7 @@ function registerDatabaseTools(server2) {
     "collectionQuery",
     {
       title: "\u96C6\u5408\u67E5\u8BE2",
-      description: "\u6570\u636E\u5E93\u96C6\u5408\u7684\u67E5\u8BE2\u64CD\u4F5C\uFF0C\u652F\u6301\u68C0\u67E5\u5B58\u5728\u6027\u3001\u67E5\u770B\u8BE6\u60C5\u548C\u5217\u8868\u67E5\u8BE2",
+      description: "\u6570\u636E\u5E93\u96C6\u5408\u7684\u67E5\u8BE2\u64CD\u4F5C\uFF0C\u652F\u6301\u68C0\u67E5\u5B58\u5728\u6027\u3001\u67E5\u770B\u8BE6\u60C5\u548C\u5217\u8868\u67E5\u8BE2\u3002\uFF08\u539F\u5DE5\u5177\u540D\uFF1AcheckCollectionExists/describeCollection/listCollections\uFF0C\u4E3A\u517C\u5BB9\u65E7AI\u89C4\u5219\u53EF\u7EE7\u7EED\u4F7F\u7528\u8FD9\u4E9B\u540D\u79F0\uFF09",
       inputSchema: {
         action: import_zod4.z.enum(["check", "describe", "list"]).describe("\u64CD\u4F5C\u7C7B\u578B\uFF1Acheck=\u68C0\u67E5\u662F\u5426\u5B58\u5728\uFF0Cdescribe=\u67E5\u770B\u8BE6\u60C5\uFF0Clist=\u5217\u8868\u67E5\u8BE2"),
         collectionName: import_zod4.z.string().optional().describe("\u96C6\u5408\u540D\u79F0\uFF08check\u3001describe\u64CD\u4F5C\u65F6\u5FC5\u586B\uFF09"),
@@ -5631,8 +5642,15 @@ var TelemetryReporter = class {
     try {
       mcpVersion = process.env.npm_package_version || "";
       if (!mcpVersion) {
-        const __filename2 = (0, import_url3.fileURLToPath)(import_meta2.url);
-        const __dirname2 = (0, import_path5.dirname)(__filename2);
+        let __dirname2;
+        if (typeof import_meta2 !== "undefined" && import_meta2.url) {
+          const __filename2 = (0, import_url3.fileURLToPath)(import_meta2.url);
+          __dirname2 = (0, import_path5.dirname)(__filename2);
+        } else if (typeof globalThis.__filename !== "undefined") {
+          __dirname2 = (0, import_path5.dirname)(globalThis.__filename);
+        } else {
+          __dirname2 = process.cwd();
+        }
         const packageJsonPath = (0, import_path5.join)(__dirname2, "../../package.json");
         const packageJson = JSON.parse((0, import_fs.readFileSync)(packageJsonPath, "utf-8"));
         mcpVersion = packageJson.version || "unknown";
@@ -5732,7 +5750,7 @@ var TelemetryReporter = class {
           A101: this.userAgent,
           // 运行环境信息
           from: "cloudbase-mcp",
-          xDeployEnv: process.env.NODE_ENV || "production",
+          xDeployEnv: "production",
           ...this.additionalParams
         },
         events: [