通过AI提示词和MCP协议+云开发，让开发更智能、更高效
🌍 Languages: 中文 | English
当你在Cursor/ VSCode GitHub Copilot/WinSurf/CodeBuddy/Augment Code等AI编程工具里写代码时，它能自动帮你生成可直接部署的前后端应用+小程序，并一键发布到腾讯云开发 CloudBase。
📹 完整视频演示 ⬇️
| 🚀 核心能力 | 🛠️ 支持平台 |
|---|---|
| 🤖 AI智能开发: AI自动生成代码和架构设计 ☁️ 云开发集成: 一键接入数据库、云函数、静态托管 ⚡ 快速部署: 几分钟内完成全栈应用上线 |
Web应用: 现代化前端 + 静态托管 微信小程序: 云开发小程序解决方案 后端服务: 云数据库 + 无服务器函数+云托管 |
- 🤖 AI 原生 - 专为 AI 编程工具设计的规则库，生成代码符合云开发最佳实践
- 🚀 一键部署 - MCP 自动化部署到腾讯云开发 CloudBase 平台，Serverless 架构无需购买服务器
- 📱 全栈应用 - Web + 小程序 + 数据库 + 后端一体化，支持多种应用形式和后端托管
- 🔧 智能修复 - AI 自动查看日志并修复问题，降低运维成本
- ⚡ 极速体验 - 国内 CDN 加速，比海外平台访问速度更快
- 📚 知识检索 - 内置云开发、微信小程序等专业知识库的智能向量检索
安装 AI 开发工具
例如 Cursor | WindSurf | CodeBuddy 等，点击查看 支持的 AI 开发工具列表
开通云开发环境
访问 腾讯云开发控制台开通环境，新用户可以免费开通体验。
安装 Node.js v18及以上版本
确保您的计算机上安装了 Node.js v18 及以上版本。您可以从 Node.js 官网 下载并安装最新版本。
可选：设置 npm 源
为了提高依赖包的下载速度，建议将 npm 源设置为腾讯镜像源。您可以在终端命令行中运行以下命令：
npm config set registry https://mirrors.cloud.tencent.com/npm/这样可以加快依赖包的下载速度，特别是在中国大陆地区。
可选：清理 npx 缓存
由于 npx 这个工具本身存在一个缓存的 bug，可能导致 CloudBase AI ToolKit 安装问题，您可以尝试清理 npx 缓存。在终端命令行中运行以下命令：
npx -y clear-npx-cache
我们为你准备了内置云开发最佳实践和 AI IDE 规则的项目模板，推荐如下两种方式：
选择适合你的模板，一键初始化：
-
AI 规则通用云开发模板 ：不限定语言和框架，内置 CloudBase AI 规则和MCP，适用于任意云开发项目
如果你已经有自己的项目，只需在配置好 MCP 后，只需要对 AI 说 "在当前项目中下载云开发 AI 规则"，即可一键下载并补全 AI 编辑器规则配置到当前项目目录，无需手动操作。
Tip
温馨提示：如果你使用的是模板项目，所有配置都已经预置完成,请按照指引进行检查和开启工具。如果不是从模板开始，需要按具体的说明手动添加相应配置：
以下工具均支持 CloudBase AI ToolKit，选择合适的工具并按说明配置：
| 工具 | 支持平台 |
|---|---|
| Cursor | 独立 IDE |
| WindSurf | 独立 IDE, VSCode、JetBrains 插件 |
| CodeBuddy | VS Code、JetBrains、微信开发者工具插件 |
| CLINE | VS Code 插件 |
| GitHub Copilot | VS Code 插件 |
| Trae | 独立 IDE |
| 通义灵码 | 独立 IDE，VS Code、 JetBrains插件 |
| RooCode | VS Code插件 |
| 文心快码 | VS Code、JetBrains插件 |
| Augment Code | VS Code、JetBrains 插件 |
🔧 Cursor 配置
模板中已包含 .cursor/rules/ 目录，AI 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。
如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，可以点击下方按钮安装到 Cursor 中：
或手动添加配置到 .cursor/mcp.json：
{
"mcpServers": {
"cloudbase-mcp": {
"command": "npx",
"args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
}
}
}然后点击 Cursor 客户端右上角的 ⚙️ 图标，进入"MCP"设置，找到 cloudbase 并启用。
在对话窗口中使用 Agent 进行代码生成和自动化操作。
🌊 Codeium/WindSurf 配置
模板中的 .windsurf/ 目录包含专为 WindSurf 优化的配置。如果不是从模板开始，可以让 AI 帮你下载云开发规则。
如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 WindSurf 的 Plugins 配置中添加：
{
"mcpServers": {
"cloudbase-mcp": {
"command": "npx",
"args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
}
}
}在对话中切换到 Write 模式进行智能生成。
👥 CodeBuddy 配置
模板中已包含 .rules/ 目录，CodeBuddy 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。
点开 CodeBuddy 右上角的 MCP 按钮，点击右侧的添加，在 MCP 配置中添加云开发的 MCP
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
}
}
}在对话窗口中切换到 Craft 模式。建议在右侧设置中关闭确认计划功能，以获得更流畅的体验。
🤖 CLINE 配置
模板中已包含 .clinerules/ 目录，AI 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。
如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP Server 配置中添加：
{
"mcpServers": {
"cloudbase": {
"autoApprove": [],
"timeout": 60,
"command": "npx",
"args": [
"@cloudbase/cloudbase-mcp@latest"
],
"transportType": "stdio",
"disabled": false
}
}
}建议使用支持代码生成和 function call 的模型。
🐙 GitHub Copilot 配置
模板中的 .github/ 目录包含 Copilot 优化配置。如果不是从模板开始，可以让 AI 帮你下载云开发规则。
如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 .vscode/mcp.json 中添加：
{
"servers": {
"cloudbase": {
"command": "npx",
"args": [
"@cloudbase/cloudbase-mcp@latest"
]
}
}
}在对话窗口左下角切换到 Agent 模式进行对话。
🎯 Trae 配置
本操作指引支持 Trae 国际版和 Trae CN 版本，建议使用 Claude/DeepSeek V3 0324 等模型进行测试。
模板中的 .trae/rules 目录包含面向 Trae 的云开发规则配置。如果不是从模板开始，可以让 AI 帮你下载云开发规则。
如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP 配置中添加：
{
"mcpServers": {
"cloudbase-mcp": {
"command": "npx",
"args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
}
}
}在智能体中选择 Builder with MCP 进行对话。
🧩 通义灵码 配置
模板中已包含 .lingma/ 目录，通义灵码会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。
如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP 配置中添加：
{
"mcpServers": {
"cloudbase-mcp": {
"command": "npx",
"args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
}
}
}在对话窗口左下角切换到智能体模式。
🤖 RooCode 配置
模板中已包含 .roo/rules 目录，RooCode 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。
如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP 配置中添加：
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": [
"@cloudbase/cloudbase-mcp@latest"
],
"disabled": false
}
}
}在对话窗口中进行代码生成和自动化操作。
🤖 文心快码(Baidu Comate) 配置
模板中已包含 .comate/rules 目录，文心快码会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。
如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP 配置中添加：
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": [
"@cloudbase/cloudbase-mcp@latest"
],
"disabled": false
}
}
}在对话窗口中切换到 Zulu 模式进行操作。
🚀 Augment Code 配置
模板中已包含 .augment-guidelines 文件，Augment Code 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则
如果使用模板项目，MCP 配置已经预置完成(内置在.vscode/settings.json中)。如果不是从模板开始，需要在 Augment的 MCP 配置中添加云开发 MCP，参考文档：
{
"augment.advanced": {
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": [
"@cloudbase/cloudbase-mcp@latest"
]
}
}
}
}在对话窗口中使用 Agent 模式进行智能代码生成和自动化操作。
🔄 更新 CloudBase AI ToolKit
更新 AI 规则
如果你想在现有项目中更新到最新的云开发 AI 规则，只需对 AI 说：
下载云开发 AI 规则
AI 会自动下载并更新最新的规则配置到你的项目目录。
更新 MCP 工具
当有新版本的 MCP 工具发布时，你可以通过以下方式更新：
-
自动更新（推荐）：在你的 AI 开发工具的 MCP 列表中，找到 cloudbase-mcp 并重新启用或刷新 MCP 列表即可自动安装最新版本
-
手动更新：如果自动更新不成功，可以先禁用再重新启用 cloudbase-mcp，或者重启你的 AI IDE
由于 MCP 配置中使用了 @latest 标签，通常会自动获取最新版本。
在开始使用前，只需要对 AI 说
登录云开发
AI 就会自动完成弹出登录腾讯云界面以及云开发的环境选择
后续如需切换环境，可以说
退出云开发
AI 就会清理本地的配置，后续可以再要求 AI 登录云开发来重新登录。
在登录成功后，可以确认 AI 已经连接到云开发
查询当前云开发环境信息
向 AI 描述你的需求,进行开发：
做一个双人在线对战五子棋网站，支持联机对战，最后进行部署
AI 会自动：
- 📝 生成前后端代码
- 🚀 部署到云开发
- 🔗 返回在线访问链接
开发过程中如果遇到报错，可以把错误信息发给 AI 来进行排障
报错了，错误是xxxx
也可以让 AI 结合云函数日志进行调试和修改代码
云函数代码运行不符合需求，需求是 xxx，请查看日志和数据进行调试，并进行修复
开发过程：
- 输入需求："做个双人在线对战五子棋网站，支持联机对战"
- AI 生成：Web 应用 + 云数据库 + 实时数据推送
- 自动部署并获得访问链接
👉 体验地址： 五子棋游戏
📸 查看开发截图
| 开发过程 | 最终效果 |
|---|---|
 |
 |
 |
支持双人在线对战 实时棋局同步 |
开发过程：
- 输入："开发一个宠物小精灵养成小程序，使用 AI 增强互动"
- AI 生成：小程序 + 云数据库 + AI 云函数
- 导入微信开发者工具即可发布
📸 查看开发截图与小程序预览
🖥️ 开发截图
|
📱 小程序预览
📲 体验二维码 
|
当应用出现问题时：
- AI 自动查看云函数日志
- 分析错误原因并生成修复代码
- 自动重新部署
📸 查看智能诊断过程
AI 自动分析日志并生成修复方案
- ⚡ 极速部署：国内节点,访问速度比海外更快
- 🛡️ 稳定可靠：330 万开发者选择的 Serverless 平台
- 🔧 开发友好：专为AI时代设计的全栈平台，支持自动环境配置
- 💰 成本优化：Serverless 架构更具弹性，新用户开发期间可以免费体验
如有迁移、集成等常见疑问，请查阅 FAQ 常见问题。
遇到问题或想要交流经验？加入我们的技术社区！
扫码加入微信技术交流群
群内你可以：
- 💡 分享你的 AI + 云开发项目
- 🤝 技术交流和开发问题沟通
- 📢 获取最新功能更新和最佳实践
- 🎯 参与产品功能讨论和建议
| 平台 | 链接 | 说明 |
|---|---|---|
| 官方文档 | 📖 查看文档 | 完整的云开发文档 |
| Issue 反馈 | 🐛 提交问题 | Bug 反馈和功能请求 |
- 每周技术分享：群内定期分享 AI + 云开发最佳实践
- 项目展示：展示你用 AI 开发的精彩项目
- 问题答疑：腾讯云开发团队成员在线答疑
- 新功能预览：第一时间体验最新功能
| 工具名称 | 功能简介 |
|---|---|
| login | 登录并自动配置云开发环境 |
| logout | 登出当前云开发账户 |
| downloadTemplate | 下载CloudBase项目模板（React、小程序、AI编辑器配置等） |
| listEnvs | 获取所有云开发环境信息 |
| getEnvAuthDomains | 获取云开发环境的合法域名列表 |
| createEnvDomain | 为云开发环境添加安全域名 |
| deleteEnvDomain | 删除云开发环境的指定安全域名 |
| getEnvInfo | 获取当前云开发环境信息 |
| updateEnvInfo | 修改云开发环境别名 |
| createCollection | 创建一个新的云开发数据库集合 |
| checkCollectionExists | 检查云开发数据库集合是否存在 |
| updateCollection | 更新云开发数据库集合配置（创建或删除索引） |
| describeCollection | 获取云开发数据库集合的详细信息 |
| listCollections | 获取云开发数据库集合列表 |
| checkIndexExists | 检查索引是否存在 |
| distribution | 查询数据库中集合的数据分布情况 |
| insertDocuments | 向集合中插入文档 |
| queryDocuments | 查询集合中的文档 |
| updateDocuments | 更新集合中的文档 |
| deleteDocuments | 删除集合中的文档 |
| manageDataModel | 数据模型查询工具，支持查询和列表数据模型（只读操作）。list操作返回基础信息，get操作返回详细信息含Schema（字段列表、格式、关联关系等），docs操作生成SDK使用文档 |
| uploadFiles | 上传文件到静态网站托管 |
| listFiles | 获取静态网站托管的文件列表 |
| deleteFiles | 删除静态网站托管的文件或文件夹 |
| findFiles | 搜索静态网站托管的文件 |
| domainManagement | 统一的域名管理工具，支持绑定、解绑、查询和修改域名配置 |
| getWebsiteConfig | 获取静态网站配置 |
| getFunctionList | 获取云函数列表 |
| createFunction | 创建云函数 |
| updateFunctionCode | 更新云函数代码 |
| updateFunctionConfig | 更新云函数配置 |
| getFunctionDetail | 获取云函数详情 |
| invokeFunction | 调用云函数 |
| getFunctionLogs | 获取云函数日志 |
| createFunctionTriggers | 创建云函数触发器 |
| deleteFunctionTrigger | 删除云函数触发器 |
| downloadRemoteFile | 下载远程文件到本地临时文件 |
| uploadFile | 上传文件到云存储（适合存储业务数据文件） |
| searchKnowledgeBase | 智能检索云开发知识库（支持云开发与云函数以及小程序知识），通过向量搜索快速获取专业文档与答案。 |
| interactiveDialog | 统一的交互式对话工具，支持需求澄清和任务确认 |
graph TD
A[开发者] --> B[AI IDE]
B -->|使用| C[CloudBase AI 规则]
C --> D[生成代码]
B -->|调用| E[CloudBase MCP]
E --> F{检测部署}
F -->|成功| G[云开发平台]
F -->|失败| H[返回日志]
H --> I[AI 修复]
I --> E
G --> J[线上应用]
J --> K[Web/小程序/API]
为了改进产品体验，CloudBase AI ToolKit 会收集匿名使用统计信息：
- 收集内容：工具调用情况、基础环境信息（操作系统、Node.js版本等）
- 隐私保护：不收集代码内容、文件路径等敏感信息，仅用于产品改进
可通过环境变量 CLOUDBASE_MCP_TELEMETRY_DISABLED 设置为 true 禁用数据统计
欢迎提交 Issue 和 Pull Request！请查看我们的贡献指南了解如何参与项目开发。
MIT © TencentCloudBase
⭐ 如果这个项目对你有帮助，请给我们一个 Star！
