@cloudbase/cloudbase-mcp 1.7.0 → 1.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -25,7 +25,7 @@
25
25
 
26
26
  [![CNB 镜像](https://img.shields.io/badge/CNB-CloudBase--AI--ToolKit-blue?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHZpZXdCb3g9IjAgMCAxMiAxMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cmVjdCB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHJ4PSIyIiBmaWxsPSIjM0I4MkY2Ii8+PHBhdGggZD0iTTUgM0g3VjVINSIgc3Ryb2tlPSJ3aGl0ZSIgc3Ryb2tlLXdpZHRoPSIxLjUiLz48cGF0aCBkPSJNNSA3SDdWOUg1IiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjEuNSIvPjwvc3ZnPg==)](https://cnb.cool/tencent/cloud/cloudbase/CloudBase-AI-ToolKit)
27
27
 
28
- 当你在**Cursor/ VSCode GitHub Copilot/WinSurf/CodeBuddy**等AI编程工具里写代码时,它能自动帮你生成可直接部署的前后端应用+小程序,并一键发布到腾讯云开发 CloudBase。
28
+ 当你在**Cursor/ VSCode GitHub Copilot/WinSurf/CodeBuddy/Augment Code**等AI编程工具里写代码时,它能自动帮你生成可直接部署的前后端应用+小程序,并一键发布到腾讯云开发 CloudBase。
29
29
 
30
30
  <a href="https://www.producthunt.com/posts/cloudbase-ai-tookit?embed=true&utm_source=badge-featured&utm_medium=badge&utm_source=badge-cloudbase&#0045;ai&#0045;tookit" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=971451&theme=light&t=1748519563832" alt="CloudBase&#0032;AI&#0032;Tookit - Prompt&#0032;to&#0032;Production&#0058;&#0032;Full&#0045;stack&#0044;&#0032;DB&#0032;&#0038;&#0032;functions—zero&#0032;setup&#0046; | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
31
31
 
@@ -53,10 +53,10 @@ https://github.com/user-attachments/assets/2b402fa6-c5c4-495a-b85b-f5d4a25daa4a
53
53
  |------|------|------|
54
54
  | **🤖 AI 原生** | 专为 AI 编程工具设计的规则库 | 生成代码符合云开发最佳实践 |
55
55
  | **🚀 一键部署** | MCP 自动化部署到腾讯云开发 CloudBase 平台 | Serverless 架构,无需购买服务器 |
56
- | **📱 全栈应用支持** | Web + 小程序 + 数据库 + 后端一体化 | 支持小程序/web 等多种应用形式,提供后端托管和数据库 |
56
+ | **📱 全栈应用** | Web + 小程序 + 数据库 + 后端一体化 | 支持小程序/web 等多种应用形式,提供后端托管和数据库 |
57
57
  | **🔧 智能修复** | AI 自动查看日志并修复问题 | 降低运维成本 |
58
58
  | **⚡ 极速体验** | 国内 CDN 加速 | 比海外平台访问速度更快 |
59
- | **📚 智能知识库检索** | 内置支持云开发、微信小程序等专业知识库的智能向量检索 |
59
+ | **📚 知识检索** | 内置支持云开发、微信小程序等专业知识 |专业知识库的智能向量检索
60
60
 
61
61
 
62
62
  ## 🚀 快速开始
@@ -65,12 +65,10 @@ https://github.com/user-attachments/assets/2b402fa6-c5c4-495a-b85b-f5d4a25daa4a
65
65
  ### 0. 前置条件
66
66
 
67
67
  #### 安装 AI 开发工具
68
- 例如 [Cursor](https://www.cursor.com/) | [WindSurf](https://windsurf.com/editor) | [CodeBuddy](https://copilot.tencent.com/)
68
+ 例如 [Cursor](https://www.cursor.com/) | [WindSurf](https://windsurf.com/editor) | [CodeBuddy](https://copilot.tencent.com/) 等,点击查看 [支持的 AI 开发工具列表](#2-配置你的-ai-ide)
69
69
 
70
- #### 开通云开发环境并获取环境 ID
71
- 1. 访问 [腾讯云开发控制台](https://tcb.cloud.tencent.com/dev)开通环境,新用户可以免费开通体验
72
- 2. 在控制台「概览」页面右侧获取 **环境ID**
73
- (后续部署需要此 ID)
70
+ #### 开通云开发环境
71
+ 访问 [腾讯云开发控制台](https://tcb.cloud.tencent.com/dev)开通环境,新用户可以免费开通体验。
74
72
 
75
73
  ### 1. 快速初始化或增强你的项目
76
74
 
@@ -86,35 +84,23 @@ https://github.com/user-attachments/assets/2b402fa6-c5c4-495a-b85b-f5d4a25daa4a
86
84
  - **微信小程序 + 云开发模板**
87
85
  [下载代码包](https://static.cloudbase.net/cloudbase-examples/miniprogram-cloudbase-miniprogram-template.zip?v=2025053001) | [开源代码地址](https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/miniprogram/cloudbase-miniprogram-template)
88
86
 
89
- - **通用云开发模板**
87
+ - **AI 规则通用云开发模板** :不限定语言和框架,内置 CloudBase AI 规则和MCP,适用于任意云开发项目
88
+
90
89
  [下载代码包](https://static.cloudbase.net/cloudbase-examples/web-cloudbase-project.zip) | [开源代码地址](https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/web/cloudbase-project)
91
90
 
92
91
  #### 🛠️ 已有项目增强
93
92
 
94
- 如果你已经有自己的项目,只需在配置好 MCP 后,让 AI 调用 `downloadTemplate` 工具,选择 `rules` 模板,即可一键下载并补全 AI 编辑器规则配置到当前项目目录,无需手动操作。
93
+ 如果你已经有自己的项目,只需在配置好 MCP 后,只需要对 AI "在当前项目中下载云开发 AI 规则",即可一键下载并补全 AI 编辑器规则配置到当前项目目录,无需手动操作。
95
94
 
96
95
 
97
96
  ### 2. 配置你的 AI IDE
98
97
 
99
- > 💡 **使用提示**:如果你在 Cursor 等工具中开启了自动执行(auto-run)模式,建议在"Command denylist"中添加敏感命令,避免自动运行如删除数据等敏感的操作
100
- >
101
- > 默认模式下需要手动确认执行,较为安全。
102
-
103
- #### 环境登录
104
-
105
- CloudBase AI ToolKit 提供了简单的环境登录管理:
106
-
107
- - **登录环境**: 使用 `login` 工具登录并选择云开发环境
108
- - **退出登录**: 使用 `logout` 工具退出当前环境
109
-
110
- 登录成功后会自动保存环境配置,无需重启服务即可生效。
111
-
112
- 以下工具均支持 CloudBase AI ToolKit,可根据你的开发环境选择合适的工具:
98
+ 以下工具均支持 CloudBase AI ToolKit,选择合适的工具并按说明配置:
113
99
 
114
100
  | 工具 | 支持平台 |
115
101
  |------|----------|
116
102
  | [Cursor](https://cursor.com/) | 独立 IDE|
117
- | [WindSurf](https://windsurf.com/editor) | 独立 IDE,VSCode、JetBrains 插件 |
103
+ | [WindSurf](https://windsurf.com/editor) | 独立 IDE, VSCode、JetBrains 插件 |
118
104
  | [CodeBuddy](https://copilot.tencent.com/) | VS Code、JetBrains、微信开发者工具插件 |
119
105
  | [CLINE](https://cline.so/) | VS Code 插件 |
120
106
  | [GitHub Copilot](https://github.com/features/copilot) | VS Code 插件 |
@@ -122,70 +108,61 @@ CloudBase AI ToolKit 提供了简单的环境登录管理:
122
108
  | [通义灵码](https://tongyi.aliyun.com/lingma) | 独立 IDE,VS Code、 JetBrains插件 |
123
109
  | [RooCode](https://roocode.com/) | VS Code插件 |
124
110
  | [文心快码](https://comate.baidu.com/) | VS Code、JetBrains插件|
111
+ | [Augment Code](https://www.augmentcode.com/) | VS Code、JetBrains 插件 |
125
112
 
126
-
127
- 选择工具后,请按照下方对应的配置说明进行设置。每个工具都需要配置云开发环境 ID 才能使用 MCP 功能。如果你还没有云开发环境,请先[开通云开发环境](#0前置条件)。
113
+ 如果你使用的是模板项目,所有配置都已经预置完成,请按照指引进行检查和开启工具。如果不是从模板开始,需要按具体的说明手动添加相应配置:
128
114
 
129
115
  <details>
130
116
  <summary><strong>🔧 Cursor 配置</strong></summary>
131
117
 
118
+ #### 步骤1:使用 AI 规则
132
119
 
133
- #### 步骤1:自动应用 AI 规则
134
-
135
- 模板中已包含 `.cursor/rules/` 目录,AI 会自动识别云开发最佳实践。
120
+ 模板中已包含 `.cursor/rules/` 目录,AI 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
136
121
 
137
122
  #### 步骤2:配置 MCP
138
123
 
139
- 模板中已经包含 mcp 配置,如果不是从模板开始,可以点击下方按钮安装到 Cursor
124
+ 如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,可以点击下方按钮安装到 Cursor 中:
140
125
 
141
126
  [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=CloudBase&config=eyJjb21tYW5kIjoibnB4IEBjbG91ZGJhc2UvY2xvdWRiYXNlLW1jcEBsYXRlc3QiLCJlbnYiOnsiQ0xPVURCQVNFX0VOVl9JRCI6IllPVVJfRU5WX0lEIn0sImRpc2FibGVkIjpmYWxzZX0%3D)
142
127
 
143
- 1. 请修改项目中的 `.cursor/mcp.json` ,填写你的云开发环境 ID
128
+ 或手动添加配置到 `.cursor/mcp.json`:
144
129
 
145
130
  ```json
146
131
  {
147
132
  "mcpServers": {
148
133
  "cloudbase-mcp": {
149
134
  "command": "npx",
150
- "args": ["@cloudbase/cloudbase-mcp@latest"],
151
- "env": {
152
- "CLOUDBASE_ENV_ID": "你的云开发环境ID"
153
- }
135
+ "args": ["@cloudbase/cloudbase-mcp@latest"]
154
136
  }
155
137
  }
156
138
  }
157
139
  ```
158
140
 
159
- 2. 启用云开发 MCP Server
160
-
161
- 点击 Cursor 客户端右上角的 ⚙️ 图标,点击进入之后,选择"MCP",在 MCP Server 页面,找到 cloudbase 右边的开关按钮,点击启用
141
+ 然后点击 Cursor 客户端右上角的 ⚙️ 图标,进入"MCP"设置,找到 cloudbase 并启用。
162
142
 
163
143
  #### 步骤3:切换到 Agent 模式
164
144
 
165
- 对话窗口中使用 Agent 进行代码生成和自动化操作
145
+ 在对话窗口中使用 Agent 进行代码生成和自动化操作。
166
146
 
167
147
  </details>
168
148
 
169
149
  <details>
170
150
  <summary><strong>🌊 Codeium/WindSurf 配置</strong></summary>
171
151
 
172
- #### 步骤1:自动应用 AI 规则
152
+ #### 步骤1:使用 AI 规则
173
153
 
174
- 模板中的 `.windsurf/` 目录包含专为 WindSurf 优化的配置。
154
+ 模板中的 `.windsurf/` 目录包含专为 WindSurf 优化的配置。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
175
155
 
176
156
  #### 步骤2:配置 MCP
177
157
 
178
- 点击 windsurf 的 Plugins icon,点击"View raw config",在其中加入 clodubase-mcp,同时设置环境 id
158
+ 如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 WindSurf 的 Plugins 配置中添加:
179
159
 
180
160
  ```json
181
161
  {
182
162
  "mcpServers": {
183
163
  "cloudbase-mcp": {
184
164
  "command": "npx",
185
- "args": ["@cloudbase/cloudbase-mcp@latest"],
186
- "env": {
187
- "CLOUDBASE_ENV_ID": "你的云开发环境ID"
188
- }
165
+ "args": ["@cloudbase/cloudbase-mcp@latest"]
189
166
  }
190
167
  }
191
168
  }
@@ -193,68 +170,48 @@ CloudBase AI ToolKit 提供了简单的环境登录管理:
193
170
 
194
171
  #### 步骤3:切换到 Write 模式
195
172
 
196
- 在对话中切换到 Write 模式,这样可以智能进行生成
197
-
173
+ 在对话中切换到 Write 模式进行智能生成。
198
174
 
199
175
  </details>
200
176
 
201
177
  <details>
202
-
203
178
  <summary><strong>👥 CodeBuddy 配置</strong></summary>
204
179
 
180
+ #### 步骤1:使用 AI 规则
205
181
 
206
- #### 步骤1:自动应用 AI 规则
207
-
208
- 模板中已包含 `.rules/` 目录,CodeBuddy 会自动识别云开发最佳实践
209
-
210
- #### 步骤 2:配置 MCP
182
+ 模板中已包含 `.rules/` 目录,CodeBuddy 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
211
183
 
212
- **配置云开发 MCP Server**
213
-
214
- 点击 CodeBuddy 右上角的 MCP 图标
215
-
216
- 点击进入之后,点击右侧的 + 号,在打开的文件中修改 MCP 配置
184
+ #### 步骤2:配置 MCP
217
185
 
218
- 其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
186
+ 如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP 配置中添加:
219
187
 
220
188
  ```json
221
189
  {
222
190
  "mcpServers": {
223
191
  "cloudbase-mcp": {
224
192
  "command": "npx",
225
- "args": ["@cloudbase/cloudbase-mcp@latest"],
226
- "env": {
227
- "CLOUDBASE_ENV_ID": "你的云开发环境ID"
228
- }
193
+ "args": ["@cloudbase/cloudbase-mcp@latest"]
229
194
  }
230
195
  }
231
196
  }
232
197
  ```
233
198
 
234
- #### 步骤 3:切换到 Craft 智能体
235
-
236
- 在对话窗口中切换到 Craft 模式,这样可以智能生成项目
199
+ #### 步骤3:切换到 Craft 智能体
237
200
 
238
- 注意,在 CodeBuddy 的 Craft 中使用时,需要在右侧的设置按钮中,关闭确认计划功能,这样可以更好的执行工具。
201
+ 在对话窗口中切换到 Craft 模式。建议在右侧设置中关闭确认计划功能,以获得更流畅的体验。
239
202
 
240
203
  </details>
241
204
 
242
-
243
205
  <details>
244
206
  <summary><strong>🤖 CLINE 配置</strong></summary>
245
207
 
208
+ #### 步骤1:使用 AI 规则
246
209
 
247
- #### 步骤1:自动应用 AI 规则
248
-
249
- 模板中已包含 `.clinerules/` 目录,AI 会自动识别云开发最佳实践
250
-
251
- #### 步骤 2:配置 MCP
210
+ 模板中已包含 `.clinerules/` 目录,AI 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
252
211
 
253
- **配置云开发 MCP Server**
254
-
255
- 在 Cline 的面板中找到 MCP Server 图标,点击进入,点击 ⚙️ 设置图标,然后点击 Configure MCP Servers
212
+ #### 步骤2:配置 MCP
256
213
 
257
- 加入以下内容,其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
214
+ 如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP Server 配置中添加:
258
215
 
259
216
  ```json
260
217
  {
@@ -266,9 +223,6 @@ CloudBase AI ToolKit 提供了简单的环境登录管理:
266
223
  "args": [
267
224
  "@cloudbase/cloudbase-mcp@latest"
268
225
  ],
269
- "env": {
270
- "CLOUDBASE_ENV_ID": "你的云开发环境ID"
271
- },
272
226
  "transportType": "stdio",
273
227
  "disabled": false
274
228
  }
@@ -276,29 +230,22 @@ CloudBase AI ToolKit 提供了简单的环境登录管理:
276
230
  }
277
231
  ```
278
232
 
279
- #### 步骤 3:使用 AI 对话
280
-
281
- 回到对话界面,建议使用代码生成能力较好和支持 function call 的模型
282
-
233
+ #### 步骤3:使用 AI 对话
283
234
 
235
+ 建议使用支持代码生成和 function call 的模型。
284
236
 
285
237
  </details>
286
238
 
287
-
288
239
  <details>
289
240
  <summary><strong>🐙 GitHub Copilot 配置</strong></summary>
290
241
 
291
- #### GitHub Copilot Chat 配置
242
+ #### 步骤1:使用 AI 规则
292
243
 
293
- #### 步骤1:自动应用 AI 规则
244
+ 模板中的 `.github/` 目录包含 Copilot 优化配置。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
294
245
 
295
- 模板中的 `.github/` 目录包含 Copilot 优化配置。
296
-
297
- #### 步骤2:启用云开发 MCP
298
-
299
- 模板中的 `.vscode/mcp.json` 目录已经包含云开发 MCP 配置
246
+ #### 步骤2:配置 MCP
300
247
 
301
- 请修改其中的环境 Id 为你的云开发环境 Id
248
+ 如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 `.vscode/mcp.json` 中添加:
302
249
 
303
250
  ```json
304
251
  {
@@ -307,112 +254,86 @@ CloudBase AI ToolKit 提供了简单的环境登录管理:
307
254
  "command": "npx",
308
255
  "args": [
309
256
  "@cloudbase/cloudbase-mcp@latest"
310
- ],
311
- "env": {
312
- "CLOUDBASE_ENV_ID": "你的云开发环境ID"
313
- }
257
+ ]
314
258
  }
315
259
  }
316
260
  }
317
261
  ```
318
262
 
319
- #### 步骤 3:切换到 Agent 模式
320
-
321
- 在对话窗口左下角切换到 Agent 模式,进行对话
263
+ #### 步骤3:切换到 Agent 模式
322
264
 
265
+ 在对话窗口左下角切换到 Agent 模式进行对话。
323
266
 
324
267
  </details>
325
268
 
326
269
  <details>
327
270
  <summary><strong>🎯 Trae 配置</strong></summary>
328
271
 
329
- 本操作指引支持 Trae 国际版和 Trae CN 版本,建议使用 Claude/DeepSeek V3 0324 等模型进行测试
330
-
331
- #### 步骤1:自动应用 AI 规则
272
+ 本操作指引支持 Trae 国际版和 Trae CN 版本,建议使用 Claude/DeepSeek V3 0324 等模型进行测试。
332
273
 
333
- 模板中的 `.trae/rules` 目录包含面向 Trae 的云开发规则配置,AI 会自动应用,无需修改。
274
+ #### 步骤1:使用 AI 规则
334
275
 
335
- #### 步骤2:启用云开发 MCP
276
+ 模板中的 `.trae/rules` 目录包含面向 Trae 的云开发规则配置。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
336
277
 
337
- Trae 右上角点击 ⚙️设置图标,点击进入 MCP,点击设置中的手动配置,粘贴如下配置
278
+ #### 步骤2:配置 MCP
338
279
 
339
- 其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
280
+ 如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP 配置中添加:
340
281
 
341
282
  ```json
342
283
  {
343
284
  "mcpServers": {
344
285
  "cloudbase-mcp": {
345
286
  "command": "npx",
346
- "args": ["@cloudbase/cloudbase-mcp@latest"],
347
- "env": {
348
- "CLOUDBASE_ENV_ID": "你的云开发环境ID"
349
- }
287
+ "args": ["@cloudbase/cloudbase-mcp@latest"]
350
288
  }
351
289
  }
352
290
  }
353
291
  ```
354
- #### 步骤3:使用 Builder with MCP 对话
355
292
 
356
- 回到对话窗口,在智能体中选择使用 Builder with MCP 对话
293
+ #### 步骤3:使用 Builder with MCP 对话
357
294
 
295
+ 在智能体中选择 Builder with MCP 进行对话。
358
296
 
359
297
  </details>
360
298
 
361
299
  <details>
362
300
  <summary><strong>🧩 通义灵码 配置</strong></summary>
363
301
 
302
+ #### 步骤1:使用 AI 规则
364
303
 
365
- #### 步骤1:自动应用 AI 规则
366
-
367
- 模板中已包含 `.lingma/` 通义灵码会自动识别云开发最佳实践
368
-
369
- #### 步骤 2:配置 MCP
370
-
371
- **配置云开发 MCP Server**
304
+ 模板中已包含 `.lingma/` 目录,通义灵码会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
372
305
 
373
- 点击通义灵码右上角的昵称,然后选择个人设置,点击进入 MCP 设置
374
-
375
-
376
-
377
- 点击进入之后,点击右侧的打开配置文件按钮,在打开的文件中修改 MCP 配置
306
+ #### 步骤2:配置 MCP
378
307
 
379
- 其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
308
+ 如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP 配置中添加:
380
309
 
381
310
  ```json
382
311
  {
383
312
  "mcpServers": {
384
313
  "cloudbase-mcp": {
385
314
  "command": "npx",
386
- "args": ["@cloudbase/cloudbase-mcp@latest"],
387
- "env": {
388
- "CLOUDBASE_ENV_ID": "你的云开发环境ID"
389
- }
315
+ "args": ["@cloudbase/cloudbase-mcp@latest"]
390
316
  }
391
317
  }
392
318
  }
393
319
  ```
394
320
 
395
- #### 步骤 3:切换到智能体模式
396
-
397
- 在对话窗口左下角中切换到智能体模式,这样可以智能生成项目
321
+ #### 步骤3:切换到智能体模式
398
322
 
323
+ 在对话窗口左下角切换到智能体模式。
399
324
 
400
325
  </details>
401
326
 
402
327
  <details>
403
328
  <summary><strong>🤖 RooCode 配置</strong></summary>
404
329
 
405
- #### 步骤1:自动应用 AI 规则
406
-
407
- 模板中已包含 `.roo/rules` 目录,RooCode 会自动识别云开发最佳实践
408
-
409
- #### 步骤2:配置 MCP
330
+ #### 步骤1:使用 AI 规则
410
331
 
411
- **配置云开发 MCP Server**
332
+ 模板中已包含 `.roo/rules` 目录,RooCode 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
412
333
 
413
- 点击 RooCode 右上角的设置图标,选择 MCP 配置,在打开的文件中修改 MCP 配置
334
+ #### 步骤2:配置 MCP
414
335
 
415
- 其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
336
+ 如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP 配置中添加:
416
337
 
417
338
  ```json
418
339
  {
@@ -422,9 +343,6 @@ CloudBase AI ToolKit 提供了简单的环境登录管理:
422
343
  "args": [
423
344
  "@cloudbase/cloudbase-mcp@latest"
424
345
  ],
425
- "env": {
426
- "CLOUDBASE_ENV_ID": "你的云开发环境ID"
427
- },
428
346
  "disabled": false
429
347
  }
430
348
  }
@@ -433,26 +351,20 @@ CloudBase AI ToolKit 提供了简单的环境登录管理:
433
351
 
434
352
  #### 步骤3:使用 AI 对话
435
353
 
436
- 在对话窗口中使用 AI 进行代码生成和自动化操作
354
+ 在对话窗口中进行代码生成和自动化操作。
437
355
 
438
356
  </details>
439
357
 
440
358
  <details>
441
359
  <summary><strong>🤖 文心快码(Baidu Comate) 配置</strong></summary>
442
360
 
443
- #### 步骤1:自动应用 AI 规则
444
-
445
- 模板中已包含 `.comate/rules` 目录,文心快码会自动识别云开发最佳实践
446
-
447
- #### 步骤2:配置 MCP
361
+ #### 步骤1:使用 AI 规则
448
362
 
449
- 模板中已包含 `.comate/mcp.json` 目录,文心快码会自动识别项目中的 MCP
363
+ 模板中已包含 `.comate/rules` 目录,文心快码会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
450
364
 
451
- **配置云开发 MCP Server**
452
-
453
- 在文心快码的 Zulu 模式中,选择 MCP 配置-设置,在打开的文件中修改 MCP 配置
365
+ #### 步骤2:配置 MCP
454
366
 
455
- 其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
367
+ 如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP 配置中添加:
456
368
 
457
369
  ```json
458
370
  {
@@ -462,24 +374,99 @@ CloudBase AI ToolKit 提供了简单的环境登录管理:
462
374
  "args": [
463
375
  "@cloudbase/cloudbase-mcp@latest"
464
376
  ],
465
- "env": {
466
- "CLOUDBASE_ENV_ID": "你的云开发环境ID"
467
- },
468
377
  "disabled": false
469
378
  }
470
379
  }
471
380
  }
472
381
  ```
473
382
 
383
+
384
+
474
385
  #### 步骤3:使用 AI 对话
475
386
 
476
- 在对话窗口中切换到 Zulu 模式,然后使用 AI 进行代码生成和自动化操作
387
+ 在对话窗口中切换到 Zulu 模式进行操作。
388
+
389
+ </details>
390
+
391
+
392
+
393
+ <details>
394
+ <summary><strong>🚀 Augment Code 配置</strong></summary>
395
+
396
+ #### 步骤1:使用 AI 规则
397
+
398
+ 模板中已包含 `.augment-guidelines` 文件,Augment Code 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则
399
+
400
+ #### 步骤2:配置 MCP
401
+
402
+ 如果使用模板项目,MCP 配置已经预置完成(内置在`.vscode/settings.json`中)。如果不是从模板开始,需要在 Augment的 MCP 配置中添加云开发 MCP,[参考文档](https://docs.augmentcode.com/setup-augment/mcp):
403
+
404
+ ```json
405
+ {
406
+ "augment.advanced": {
407
+ "mcpServers": {
408
+ "cloudbase": {
409
+ "command": "npx",
410
+ "args": [
411
+ "@cloudbase/cloudbase-mcp@latest"
412
+ ]
413
+ }
414
+ }
415
+ }
416
+ }
417
+ ```
418
+
419
+ #### 步骤3:使用 Agent 模式
420
+
421
+ 在对话窗口中使用 Agent 模式进行智能代码生成和自动化操作。
477
422
 
478
423
  </details>
479
424
 
425
+ <details>
426
+ <summary><strong>🔄 更新 CloudBase AI ToolKit</strong></summary>
427
+
428
+ **更新 AI 规则**
429
+
430
+ 如果你想在现有项目中更新到最新的云开发 AI 规则,只需对 AI 说:
431
+
432
+ ```
433
+ 下载云开发 AI 规则
434
+ ```
435
+
436
+ AI 会自动下载并更新最新的规则配置到你的项目目录。
437
+
438
+ **更新 MCP 工具**
439
+
440
+ 当有新版本的 MCP 工具发布时,你可以通过以下方式更新:
441
+
442
+ 1. **自动更新(推荐)**:在你的 AI 开发工具的 MCP 列表中,找到 cloudbase-mcp 并重新启用或刷新 MCP 列表即可自动安装最新版本
443
+
444
+ 2. **手动更新**:如果自动更新不成功,可以先禁用再重新启用 cloudbase-mcp,或者重启你的 AI IDE
445
+
446
+ 由于 MCP 配置中使用了 `@latest` 标签,通常会自动获取最新版本。
447
+
448
+ </details>
449
+
450
+
480
451
  ### 3. 开始开发
481
452
 
482
- 确认 AI 已经连接到云开发
453
+
454
+ 在开始使用前,只需要对 AI 说
455
+
456
+ ```
457
+ 登录云开发
458
+ ```
459
+ AI 就会自动完成弹出登录腾讯云界面以及云开发的环境选择
460
+
461
+ 后续如需切换环境,可以说
462
+
463
+ ```
464
+ 退出云开发
465
+ ```
466
+
467
+ AI 就会清理本地的配置,后续可以再要求 AI 登录云开发来重新登录。
468
+
469
+ 在登录成功后,可以确认 AI 已经连接到云开发
483
470
 
484
471
  ```
485
472
  查询当前云开发环境信息
@@ -587,7 +574,7 @@ AI 会自动:
587
574
 
588
575
  - **⚡ 极速部署**:国内节点,访问速度比海外更快
589
576
  - **🛡️ 稳定可靠**:330 万开发者选择的 Serverless 平台
590
- - **🔧 开发友好**:专为AI时代设计的全栈平台
577
+ - **🔧 开发友好**:专为AI时代设计的全栈平台,支持自动环境配置
591
578
  - **💰 成本优化**:Serverless 架构更具弹性,新用户开发期间可以免费体验
592
579
 
593
580
 
@@ -632,7 +619,7 @@ AI 会自动:
632
619
 
633
620
  | 工具名称 | 功能简介 |
634
621
  |----------|----------|
635
- | login | 登录并选择云开发环境 |
622
+ | login | 登录并自动配置云开发环境 |
636
623
  | logout | 登出当前云开发账户 |
637
624
  | downloadTemplate | 下载CloudBase项目模板(React、小程序、AI编辑器配置等) |
638
625
  | listEnvs | 获取所有云开发环境信息 |
@@ -656,11 +643,8 @@ AI 会自动:
656
643
  | listFiles | 获取静态网站托管的文件列表 |
657
644
  | deleteFiles | 删除静态网站托管的文件或文件夹 |
658
645
  | findFiles | 搜索静态网站托管的文件 |
659
- | createHostingDomain | 绑定自定义域名 |
660
- | deleteHostingDomain | 解绑自定义域名 |
646
+ | domainManagement | 统一的域名管理工具,支持绑定、解绑、查询和修改域名配置 |
661
647
  | getWebsiteConfig | 获取静态网站配置 |
662
- | tcbCheckResource | 获取域名配置 |
663
- | tcbModifyAttribute | 修改域名配置 |
664
648
  | getFunctionList | 获取云函数列表 |
665
649
  | createFunction | 创建云函数 |
666
650
  | updateFunctionCode | 更新云函数代码 |
@@ -673,6 +657,7 @@ AI 会自动:
673
657
  | downloadRemoteFile | 下载远程文件到本地临时文件 |
674
658
  | uploadFile | 上传文件到云存储(适合存储业务数据文件) |
675
659
  | searchKnowledgeBase | 智能检索云开发知识库(支持云开发与云函数),通过向量搜索快速获取专业文档与答案。|
660
+ | interactiveDialog | 统一的交互式对话工具,支持需求澄清和任务确认 |
676
661
 
677
662
  ## 🏗️ 架构原理
678
663
 
@@ -701,5 +686,5 @@ graph TD
701
686
 
702
687
  ---
703
688
 
704
- ⭐ 如果这个项目对你有帮助,请给我们一个 Star!
689
+ ⭐ 如果这个项目对你有帮助,请给我们一个 Star!
705
690