@cloudbase/cloudbase-mcp 1.8.21 → 1.8.23
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 +49 -572
- package/dist/cli.cjs +3 -3
- package/dist/index.cjs +3 -3
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/dist/440.cli.cjs +0 -1
- package/dist/440.index.cjs +0 -1
package/README.md
CHANGED
|
@@ -51,7 +51,52 @@
|
|
|
51
51
|
- **⚡ 极速体验** - 国内 CDN 加速,比海外平台访问速度更快
|
|
52
52
|
- **📚 知识检索** - 内置云开发、微信小程序等专业知识库的智能向量检索
|
|
53
53
|
|
|
54
|
+
> [!TIP]
|
|
55
|
+
>
|
|
56
|
+
> 🚩内置支持 Spec 工作流:让 AI 编程更工程化
|
|
57
|
+
>
|
|
58
|
+
> - 内置 Kiro 风格 Spec 工作流,支持 Cursor、Claude Code 等主流 AI IDE
|
|
59
|
+
> - 需求、设计、任务分明,自动生成 requirements.md、design.md、tasks.md
|
|
60
|
+
> - 摆脱“拉霸式” vibe coding,开发过程可控、可追溯
|
|
61
|
+
> - 让 AI 协助梳理需求、设计方案、拆分任务,人类专注决策与评审
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
🚩 **快速上手 CloudBase AI ToolKit**
|
|
65
|
+
|
|
66
|
+
1. **启用 CloudBase 工具(MCP 配置)**
|
|
67
|
+
在你的 AI IDE(如 Cursor)中添加以下配置,即可启用 CloudBase AI ToolKit 的全部能力:
|
|
68
|
+
|
|
69
|
+
```json
|
|
70
|
+
{
|
|
71
|
+
"mcpServers": {
|
|
72
|
+
"cloudbase-mcp": {
|
|
73
|
+
"command": "npx",
|
|
74
|
+
"args": ["@cloudbase/cloudbase-mcp@latest"]
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
2. **一键生成项目模板**
|
|
81
|
+
在 AI 对话框输入:
|
|
82
|
+
|
|
83
|
+
```
|
|
84
|
+
下载小程序云开发模板
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
3. **可选模板类型**
|
|
88
|
+
- 小程序云开发模板
|
|
89
|
+
- React 云开发模板
|
|
90
|
+
- Vue 云开发模板
|
|
91
|
+
- UniApp 云开发模板
|
|
92
|
+
- 通用云开发模板
|
|
93
|
+
|
|
94
|
+
👉 [查看全部官方模板及说明](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/templates)
|
|
54
95
|
|
|
96
|
+
4. **详细教程**
|
|
97
|
+
👉 [查看完整配置与使用教程](#2-配置你的-ai-ide)
|
|
98
|
+
|
|
99
|
+
---
|
|
55
100
|
|
|
56
101
|
## 🚀 快速开始
|
|
57
102
|
|
|
@@ -97,7 +142,7 @@ npm config set registry https://mirrors.cloud.tencent.com/npm/
|
|
|
97
142
|
|
|
98
143
|
在**终端命令行**中运行以下命令:
|
|
99
144
|
```
|
|
100
|
-
npx clear-npx-cache
|
|
145
|
+
npx clear-npx-cache
|
|
101
146
|
```
|
|
102
147
|
</details>
|
|
103
148
|
|
|
@@ -142,7 +187,7 @@ npx clear-npx-cache
|
|
|
142
187
|
|------|----------|----------|
|
|
143
188
|
| [Cursor](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cursor) | 独立 IDE| [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cursor) |
|
|
144
189
|
| [WindSurf](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/windsurf) | 独立 IDE, VSCode、JetBrains 插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/windsurf) |
|
|
145
|
-
| [CodeBuddy](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/codebuddy) | VS Code、JetBrains
|
|
190
|
+
| [CodeBuddy](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/codebuddy) | 独立 IDE(已内置 CloudBase),VS Code、JetBrains、微信开发者工具| [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/codebuddy) |
|
|
146
191
|
| [CLINE](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cline) | VS Code 插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cline) |
|
|
147
192
|
| [GitHub Copilot](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/github-copilot) | VS Code 插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/github-copilot) |
|
|
148
193
|
| [Trae](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/trae) | 独立 IDE | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/trae) |
|
|
@@ -153,578 +198,10 @@ npx clear-npx-cache
|
|
|
153
198
|
| [Claude Code](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/claude-code) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/claude-code) |
|
|
154
199
|
| [Gemini CLI](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/gemini-cli) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/gemini-cli) |
|
|
155
200
|
| [OpenAI Codex CLI](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openai-codex-cli) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openai-codex-cli) |
|
|
201
|
+
| [OpenCode](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/opencode) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/opencode) |
|
|
202
|
+
| [Qwen Code](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/qwen-code) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/qwen-code) |
|
|
156
203
|
|
|
157
204
|
|
|
158
|
-
<details>
|
|
159
|
-
<summary><strong>🔧 Cursor 配置</strong></summary>
|
|
160
|
-
|
|
161
|
-
#### 步骤1:使用 AI 规则
|
|
162
|
-
|
|
163
|
-
模板中已包含 `.cursor/rules/` 目录,AI 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
|
|
164
|
-
|
|
165
|
-
#### 步骤2:配置 MCP
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
> [!TIP]
|
|
169
|
-
> 如果安装以后工具数量一直为 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)
|
|
170
|
-
|
|
171
|
-
如果使用模板项目,MCP 配置已经预置完成,请点击左下角的弹出的窗口启用MCP。如果不是从模板开始,可以点击下方按钮安装到 Cursor 中:
|
|
172
|
-
|
|
173
|
-
[](https://cursor.com/install-mcp?name=CloudBase&config=eyJjb21tYW5kIjoibnB4IEBjbG91ZGJhc2UvY2xvdWRiYXNlLW1jcEBsYXRlc3QiLCJkaXNhYmxlZCI6ZmFsc2V9)
|
|
174
|
-
|
|
175
|
-
或手动添加配置到 `.cursor/mcp.json`:
|
|
176
|
-
|
|
177
|
-
```json
|
|
178
|
-
{
|
|
179
|
-
"mcpServers": {
|
|
180
|
-
"cloudbase-mcp": {
|
|
181
|
-
"command": "npx",
|
|
182
|
-
"args": ["@cloudbase/cloudbase-mcp@latest"]
|
|
183
|
-
}
|
|
184
|
-
}
|
|
185
|
-
}
|
|
186
|
-
```
|
|
187
|
-
|
|
188
|
-
然后点击 Cursor 客户端右上角的 ⚙️ 图标,进入"MCP"设置,找到 cloudbase 并启用。
|
|
189
|
-
|
|
190
|
-
#### 步骤3:切换到 Agent 模式
|
|
191
|
-
|
|
192
|
-
在对话窗口中使用 Agent 进行代码生成和自动化操作。
|
|
193
|
-
|
|
194
|
-
</details>
|
|
195
|
-
|
|
196
|
-
<details>
|
|
197
|
-
<summary><strong>🌊 Codeium/WindSurf 配置</strong></summary>
|
|
198
|
-
|
|
199
|
-
#### 步骤1:使用 AI 规则
|
|
200
|
-
|
|
201
|
-
模板中的 `.windsurf/` 目录包含专为 WindSurf 优化的配置。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
|
|
202
|
-
|
|
203
|
-
#### 步骤2:配置 MCP
|
|
204
|
-
|
|
205
|
-
> [!TIP]
|
|
206
|
-
> 如果安装以后工具数量一直为 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)
|
|
207
|
-
|
|
208
|
-
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 WindSurf 的 Plugins 配置中添加:
|
|
209
|
-
|
|
210
|
-
```json
|
|
211
|
-
{
|
|
212
|
-
"mcpServers": {
|
|
213
|
-
"cloudbase-mcp": {
|
|
214
|
-
"command": "npx",
|
|
215
|
-
"args": ["@cloudbase/cloudbase-mcp@latest"]
|
|
216
|
-
}
|
|
217
|
-
}
|
|
218
|
-
}
|
|
219
|
-
```
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
#### 步骤3:切换到 Write 模式
|
|
225
|
-
|
|
226
|
-
在对话中切换到 Write 模式进行智能生成。
|
|
227
|
-
|
|
228
|
-
</details>
|
|
229
|
-
|
|
230
|
-
<details>
|
|
231
|
-
<summary><strong>👥 CodeBuddy 配置</strong></summary>
|
|
232
|
-
|
|
233
|
-
#### 步骤1:使用 AI 规则
|
|
234
|
-
|
|
235
|
-
模板中已包含 `.rules/` 目录,CodeBuddy 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
|
|
236
|
-
|
|
237
|
-
#### 步骤2:配置 MCP
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
> 如果安装以后工具数量一直为 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)
|
|
241
|
-
|
|
242
|
-
1. 可以在 点开 CodeBuddy 右上角的 MCP 按钮,在 MCP 市场中搜索 CloudBase,然后点击安装即可。
|
|
243
|
-
|
|
244
|
-
2. 也可以手动添加,点开 CodeBuddy 右上角的 MCP 按钮,点击右侧的添加,在 MCP 配置中添加云开发的 MCP
|
|
245
|
-
|
|
246
|
-
```json
|
|
247
|
-
{
|
|
248
|
-
"mcpServers": {
|
|
249
|
-
"cloudbase": {
|
|
250
|
-
"command": "npx",
|
|
251
|
-
"args": ["@cloudbase/cloudbase-mcp@latest"]
|
|
252
|
-
}
|
|
253
|
-
}
|
|
254
|
-
}
|
|
255
|
-
```
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
#### 步骤3:切换到 Craft 智能体
|
|
261
|
-
|
|
262
|
-
在对话窗口中切换到 Craft 模式。建议在右侧设置中关闭确认计划功能,以获得更流畅的体验。
|
|
263
|
-
|
|
264
|
-
</details>
|
|
265
|
-
|
|
266
|
-
<details>
|
|
267
|
-
<summary><strong>🤖 CLINE 配置</strong></summary>
|
|
268
|
-
|
|
269
|
-
#### 步骤1:使用 AI 规则
|
|
270
|
-
|
|
271
|
-
模板中已包含 `.clinerules/` 目录,AI 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
|
|
272
|
-
|
|
273
|
-
#### 步骤2:配置 MCP
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
> [!TIP]
|
|
277
|
-
> 如果安装以后工具数量一直为 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)
|
|
278
|
-
|
|
279
|
-
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP Server 配置中添加:
|
|
280
|
-
|
|
281
|
-
```json
|
|
282
|
-
{
|
|
283
|
-
"mcpServers": {
|
|
284
|
-
"cloudbase": {
|
|
285
|
-
"autoApprove": [],
|
|
286
|
-
"timeout": 60,
|
|
287
|
-
"command": "npx",
|
|
288
|
-
"args": [
|
|
289
|
-
"@cloudbase/cloudbase-mcp@latest"
|
|
290
|
-
],
|
|
291
|
-
"transportType": "stdio",
|
|
292
|
-
"disabled": false
|
|
293
|
-
}
|
|
294
|
-
}
|
|
295
|
-
}
|
|
296
|
-
```
|
|
297
|
-
|
|
298
|
-
#### 步骤3:使用 AI 对话
|
|
299
|
-
|
|
300
|
-
建议使用支持代码生成和 function call 的模型。
|
|
301
|
-
|
|
302
|
-
</details>
|
|
303
|
-
|
|
304
|
-
<details>
|
|
305
|
-
<summary><strong>🐙 GitHub Copilot 配置</strong></summary>
|
|
306
|
-
|
|
307
|
-
#### 步骤1:使用 AI 规则
|
|
308
|
-
|
|
309
|
-
模板中的 `.github/` 目录包含 Copilot 优化配置。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
|
|
310
|
-
|
|
311
|
-
#### 步骤2:配置 MCP
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
> [!TIP]
|
|
315
|
-
> 如果安装以后工具数量一直为 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)
|
|
316
|
-
|
|
317
|
-
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 `.vscode/mcp.json` 中添加:
|
|
318
|
-
|
|
319
|
-
```json
|
|
320
|
-
{
|
|
321
|
-
"servers": {
|
|
322
|
-
"cloudbase": {
|
|
323
|
-
"command": "npx",
|
|
324
|
-
"args": [
|
|
325
|
-
"@cloudbase/cloudbase-mcp@latest"
|
|
326
|
-
]
|
|
327
|
-
}
|
|
328
|
-
}
|
|
329
|
-
}
|
|
330
|
-
```
|
|
331
|
-
|
|
332
|
-
#### 步骤3:切换到 Agent 模式
|
|
333
|
-
|
|
334
|
-
在对话窗口左下角切换到 Agent 模式进行对话。
|
|
335
|
-
|
|
336
|
-
</details>
|
|
337
|
-
|
|
338
|
-
<details>
|
|
339
|
-
<summary><strong>🎯 Trae 配置</strong></summary>
|
|
340
|
-
|
|
341
|
-
本操作指引支持 Trae 国际版和 Trae CN 版本,建议使用 Claude/DeepSeek V3 0324 等模型进行测试。
|
|
342
|
-
|
|
343
|
-
#### 步骤1:使用 AI 规则
|
|
344
|
-
|
|
345
|
-
模板中的 `.trae/rules` 目录包含面向 Trae 的云开发规则配置。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
|
|
346
|
-
|
|
347
|
-
#### 步骤2:配置 MCP
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
> [!TIP]
|
|
351
|
-
> 如果安装以后工具数量一直为 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)
|
|
352
|
-
|
|
353
|
-
需要在 Trae 的MCP 配置中添加:
|
|
354
|
-
|
|
355
|
-
```json
|
|
356
|
-
{
|
|
357
|
-
"mcpServers": {
|
|
358
|
-
"cloudbase-mcp": {
|
|
359
|
-
"command": "npx",
|
|
360
|
-
"args": ["@cloudbase/cloudbase-mcp@latest"]
|
|
361
|
-
}
|
|
362
|
-
}
|
|
363
|
-
}
|
|
364
|
-
```
|
|
365
|
-
|
|
366
|
-
#### 步骤3:使用 Builder with MCP 对话
|
|
367
|
-
|
|
368
|
-
在智能体中选择 Builder with MCP 进行对话。
|
|
369
|
-
|
|
370
|
-
</details>
|
|
371
|
-
|
|
372
|
-
<details>
|
|
373
|
-
<summary><strong>🧩 通义灵码 配置</strong></summary>
|
|
374
|
-
|
|
375
|
-
#### 步骤1:使用 AI 规则
|
|
376
|
-
|
|
377
|
-
模板中已包含 `.lingma/` 目录,通义灵码会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
|
|
378
|
-
|
|
379
|
-
#### 步骤2:配置 MCP
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
> [!TIP]
|
|
383
|
-
> 如果安装以后工具数量一直为 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)
|
|
384
|
-
|
|
385
|
-
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP 配置中添加:
|
|
386
|
-
|
|
387
|
-
```json
|
|
388
|
-
{
|
|
389
|
-
"mcpServers": {
|
|
390
|
-
"cloudbase-mcp": {
|
|
391
|
-
"command": "npx",
|
|
392
|
-
"args": ["@cloudbase/cloudbase-mcp@latest"]
|
|
393
|
-
}
|
|
394
|
-
}
|
|
395
|
-
}
|
|
396
|
-
```
|
|
397
|
-
|
|
398
|
-
#### 步骤3:切换到智能体模式
|
|
399
|
-
|
|
400
|
-
在对话窗口左下角切换到智能体模式。
|
|
401
|
-
|
|
402
|
-
</details>
|
|
403
|
-
|
|
404
|
-
<details>
|
|
405
|
-
<summary><strong>🤖 RooCode 配置</strong></summary>
|
|
406
|
-
|
|
407
|
-
#### 步骤1:使用 AI 规则
|
|
408
|
-
|
|
409
|
-
模板中已包含 `.roo/rules` 目录,RooCode 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
|
|
410
|
-
|
|
411
|
-
#### 步骤2:配置 MCP
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
> [!TIP]
|
|
415
|
-
> 如果安装以后工具数量一直为 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)
|
|
416
|
-
|
|
417
|
-
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP 配置中添加:
|
|
418
|
-
|
|
419
|
-
```json
|
|
420
|
-
{
|
|
421
|
-
"mcpServers": {
|
|
422
|
-
"cloudbase": {
|
|
423
|
-
"command": "npx",
|
|
424
|
-
"args": [
|
|
425
|
-
"@cloudbase/cloudbase-mcp@latest"
|
|
426
|
-
],
|
|
427
|
-
"disabled": false
|
|
428
|
-
}
|
|
429
|
-
}
|
|
430
|
-
}
|
|
431
|
-
```
|
|
432
|
-
|
|
433
|
-
#### 步骤3:使用 AI 对话
|
|
434
|
-
|
|
435
|
-
在对话窗口中进行代码生成和自动化操作。
|
|
436
|
-
|
|
437
|
-
</details>
|
|
438
|
-
|
|
439
|
-
<details>
|
|
440
|
-
<summary><strong>🤖 文心快码(Baidu Comate) 配置</strong></summary>
|
|
441
|
-
|
|
442
|
-
#### 步骤1:使用 AI 规则
|
|
443
|
-
|
|
444
|
-
模板中已包含 `.comate/rules` 目录,文心快码会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
|
|
445
|
-
|
|
446
|
-
#### 步骤2:配置 MCP
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
> [!TIP]
|
|
450
|
-
> 如果安装以后工具数量一直为 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)
|
|
451
|
-
|
|
452
|
-
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP 配置中添加:
|
|
453
|
-
|
|
454
|
-
```json
|
|
455
|
-
{
|
|
456
|
-
"mcpServers": {
|
|
457
|
-
"cloudbase": {
|
|
458
|
-
"command": "npx",
|
|
459
|
-
"args": [
|
|
460
|
-
"@cloudbase/cloudbase-mcp@latest"
|
|
461
|
-
],
|
|
462
|
-
"disabled": false
|
|
463
|
-
}
|
|
464
|
-
}
|
|
465
|
-
}
|
|
466
|
-
```
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
#### 步骤3:使用 AI 对话
|
|
471
|
-
|
|
472
|
-
在对话窗口中切换到 Zulu 模式进行操作。
|
|
473
|
-
|
|
474
|
-
</details>
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
<details>
|
|
479
|
-
<summary><strong>🚀 Augment Code 配置</strong></summary>
|
|
480
|
-
|
|
481
|
-
#### 步骤1:使用 AI 规则
|
|
482
|
-
|
|
483
|
-
模板中已包含 `.augment-guidelines` 文件,Augment Code 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则
|
|
484
|
-
|
|
485
|
-
#### 步骤2:配置 MCP
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
> [!TIP]
|
|
489
|
-
> 如果安装以后工具数量一直为 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)
|
|
490
|
-
|
|
491
|
-
如果使用模板项目,MCP 配置已经预置完成(内置在`.vscode/settings.json`中)。如果不是从模板开始,需要在 Augment的 MCP 配置中添加云开发 MCP,[参考文档](https://docs.augmentcode.com/setup-augment/mcp):
|
|
492
|
-
|
|
493
|
-
```json
|
|
494
|
-
{
|
|
495
|
-
"augment.advanced": {
|
|
496
|
-
"mcpServers": {
|
|
497
|
-
"cloudbase": {
|
|
498
|
-
"command": "npx",
|
|
499
|
-
"args": [
|
|
500
|
-
"@cloudbase/cloudbase-mcp@latest"
|
|
501
|
-
]
|
|
502
|
-
}
|
|
503
|
-
}
|
|
504
|
-
}
|
|
505
|
-
}
|
|
506
|
-
```
|
|
507
|
-
|
|
508
|
-
#### 步骤3:使用 Agent 模式
|
|
509
|
-
|
|
510
|
-
在对话窗口中使用 Agent 模式进行智能代码生成和自动化操作。
|
|
511
|
-
|
|
512
|
-
</details>
|
|
513
|
-
|
|
514
|
-
<details>
|
|
515
|
-
<summary><strong>🤖 Claude Code 配置</strong></summary>
|
|
516
|
-
|
|
517
|
-
#### 步骤1:使用 AI 规则
|
|
518
|
-
|
|
519
|
-
模板中已包含 `CLAUDE.md` 文件,Claude Code 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则
|
|
520
|
-
|
|
521
|
-
#### 步骤2:配置 MCP
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
> [!TIP]
|
|
525
|
-
> 如果安装以后工具数量一直为 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)
|
|
526
|
-
|
|
527
|
-
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在项目根目录创建 `.mcp.json` 文件:
|
|
528
|
-
|
|
529
|
-
```json
|
|
530
|
-
{
|
|
531
|
-
"mcpServers": {
|
|
532
|
-
"cloudbase": {
|
|
533
|
-
"command": "npx",
|
|
534
|
-
"args": [
|
|
535
|
-
"-y",
|
|
536
|
-
"@cloudbase/cloudbase-mcp@latest"
|
|
537
|
-
]
|
|
538
|
-
}
|
|
539
|
-
}
|
|
540
|
-
}
|
|
541
|
-
```
|
|
542
|
-
|
|
543
|
-
#### 步骤3:使用 AI 对话
|
|
544
|
-
|
|
545
|
-
在 Claude Code 中直接与 AI 对话进行智能代码生成和自动化操作。
|
|
546
|
-
|
|
547
|
-
</details>
|
|
548
|
-
|
|
549
|
-
<details>
|
|
550
|
-
<summary><strong>🔹 Gemini CLI 配置</strong></summary>
|
|
551
|
-
|
|
552
|
-
#### 步骤1:安装 Gemini CLI
|
|
553
|
-
|
|
554
|
-
确保安装 Node.js 18+,然后全局安装 Gemini CLI:
|
|
555
|
-
|
|
556
|
-
```bash
|
|
557
|
-
npm install -g @google/gemini-cli
|
|
558
|
-
```
|
|
559
|
-
|
|
560
|
-
或直接运行:
|
|
561
|
-
|
|
562
|
-
```bash
|
|
563
|
-
npx @google/gemini-cli
|
|
564
|
-
```
|
|
565
|
-
|
|
566
|
-
首次运行时,使用个人 Google 账户登录即可获得免费额度(每分钟 60 次请求,每天 1000 次请求)。
|
|
567
|
-
|
|
568
|
-
#### 步骤2:配置 MCP
|
|
569
|
-
|
|
570
|
-
> [!TIP]
|
|
571
|
-
> 如果安装以后工具数量一直为 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)
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
如果使用模板项目,MCP 配置已经预置完成。
|
|
575
|
-
|
|
576
|
-
如果不是从模板开始,可以在用户主目录(`~`)或项目目录中创建 `.gemini/settings.json` 文件:
|
|
577
|
-
|
|
578
|
-
```json
|
|
579
|
-
{
|
|
580
|
-
"mcpServers": {
|
|
581
|
-
"cloudbase-mcp": {
|
|
582
|
-
"command": "npx",
|
|
583
|
-
"args": ["@cloudbase/cloudbase-mcp@latest"]
|
|
584
|
-
}
|
|
585
|
-
}
|
|
586
|
-
}
|
|
587
|
-
```
|
|
588
|
-
|
|
589
|
-
#### 步骤3:启用 AI 规则
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
模板项目根目录已经包含 `GEMINI.md` 文件,包含 CloudBase 开发规则。
|
|
593
|
-
|
|
594
|
-
如果是现有项目,在 Gemini CLI 中对 AI 说:
|
|
595
|
-
|
|
596
|
-
```
|
|
597
|
-
在当前项目中下载云开发 AI 规则
|
|
598
|
-
```
|
|
599
|
-
|
|
600
|
-
#### 步骤4:开始开发
|
|
601
|
-
|
|
602
|
-
启动 Gemini CLI:
|
|
603
|
-
|
|
604
|
-
```bash
|
|
605
|
-
gemini
|
|
606
|
-
```
|
|
607
|
-
|
|
608
|
-
然后对 AI 说:
|
|
609
|
-
|
|
610
|
-
```
|
|
611
|
-
登录云开发
|
|
612
|
-
```
|
|
613
|
-
|
|
614
|
-
**常用命令:**
|
|
615
|
-
- `/tools` - 查看可用工具
|
|
616
|
-
- `/mcp` - 查看 MCP 服务器状态
|
|
617
|
-
- `/memory show` - 查看当前规则
|
|
618
|
-
- `!command` - 执行 Shell 命令
|
|
619
|
-
|
|
620
|
-
</details>
|
|
621
|
-
|
|
622
|
-
<details>
|
|
623
|
-
<summary><strong>🤖 OpenAI Codex CLI 配置</strong></summary>
|
|
624
|
-
|
|
625
|
-
#### 步骤1:安装 OpenAI Codex CLI
|
|
626
|
-
|
|
627
|
-
确保安装 Node.js 18+,然后全局安装 OpenAI Codex CLI:
|
|
628
|
-
|
|
629
|
-
```bash
|
|
630
|
-
npm install -g @openai/codex
|
|
631
|
-
```
|
|
632
|
-
|
|
633
|
-
或直接运行:
|
|
634
|
-
|
|
635
|
-
```bash
|
|
636
|
-
npx @openai/codex
|
|
637
|
-
```
|
|
638
|
-
|
|
639
|
-
#### 步骤2:配置 MCP
|
|
640
|
-
|
|
641
|
-
> [!TIP]
|
|
642
|
-
> 如果安装以后工具数量一直为 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)
|
|
643
|
-
|
|
644
|
-
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,有两种配置方式:
|
|
645
|
-
|
|
646
|
-
**方式一:使用项目配置文件(推荐)**
|
|
647
|
-
|
|
648
|
-
在项目根目录创建 `.codex/config.toml` 文件:
|
|
649
|
-
|
|
650
|
-
```toml
|
|
651
|
-
[mcp_servers.cloudbase]
|
|
652
|
-
command = "npx"
|
|
653
|
-
args = ["-y", "@cloudbase/cloudbase-mcp@latest"]
|
|
654
|
-
```
|
|
655
|
-
|
|
656
|
-
然后启动时指定配置文件:
|
|
657
|
-
|
|
658
|
-
```bash
|
|
659
|
-
codex --config .codex/config.toml
|
|
660
|
-
```
|
|
661
|
-
|
|
662
|
-
**方式二:全局配置**
|
|
663
|
-
|
|
664
|
-
在用户主目录创建 `~/.codex/config.toml` 文件:
|
|
665
|
-
|
|
666
|
-
```toml
|
|
667
|
-
[mcp_servers.cloudbase]
|
|
668
|
-
command = "npx"
|
|
669
|
-
args = ["-y", "@cloudbase/cloudbase-mcp@latest"]
|
|
670
|
-
```
|
|
671
|
-
|
|
672
|
-
#### 步骤3:启用 AI 规则
|
|
673
|
-
|
|
674
|
-
模板中已包含 `AGENTS.md` 文件,OpenAI Codex CLI 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则:
|
|
675
|
-
|
|
676
|
-
```
|
|
677
|
-
在当前项目中下载云开发 AI 规则
|
|
678
|
-
```
|
|
679
|
-
|
|
680
|
-
#### 步骤4:开始开发
|
|
681
|
-
|
|
682
|
-
启动 OpenAI Codex CLI:
|
|
683
|
-
|
|
684
|
-
```bash
|
|
685
|
-
codex
|
|
686
|
-
```
|
|
687
|
-
|
|
688
|
-
如果使用项目配置文件:
|
|
689
|
-
|
|
690
|
-
```bash
|
|
691
|
-
codex --config .codex/config.toml
|
|
692
|
-
```
|
|
693
|
-
|
|
694
|
-
在 Codex CLI 中与 AI 对话:
|
|
695
|
-
|
|
696
|
-
```
|
|
697
|
-
登录云开发
|
|
698
|
-
```
|
|
699
|
-
然后就可以进行需求的开发了
|
|
700
|
-
|
|
701
|
-
</details>
|
|
702
|
-
|
|
703
|
-
<details>
|
|
704
|
-
<summary><strong>🔄 更新 CloudBase AI ToolKit</strong></summary>
|
|
705
|
-
|
|
706
|
-
**更新 AI 规则**
|
|
707
|
-
|
|
708
|
-
如果你想在现有项目中更新到最新的云开发 AI 规则,只需对 AI 说:
|
|
709
|
-
|
|
710
|
-
```
|
|
711
|
-
下载云开发 AI 规则
|
|
712
|
-
```
|
|
713
|
-
|
|
714
|
-
AI 会自动下载并更新最新的规则配置到你的项目目录。
|
|
715
|
-
|
|
716
|
-
**更新 MCP 工具**
|
|
717
|
-
|
|
718
|
-
当有新版本的 MCP 工具发布时,你可以通过以下方式更新:
|
|
719
|
-
|
|
720
|
-
1. **自动更新(推荐)**:在你的 AI 开发工具的 MCP 列表中,找到 cloudbase-mcp 并重新启用或刷新 MCP 列表即可自动安装最新版本
|
|
721
|
-
|
|
722
|
-
2. **手动更新**:如果自动更新不成功,可以先禁用再重新启用 cloudbase-mcp,或者重启你的 AI IDE
|
|
723
|
-
|
|
724
|
-
由于 MCP 配置中使用了 `@latest` 标签,通常会自动获取最新版本。
|
|
725
|
-
|
|
726
|
-
</details>
|
|
727
|
-
|
|
728
205
|
|
|
729
206
|
### 3. 开始开发
|
|
730
207
|
|