🌟 CloudBase AI ToolKit

🪐 用 AI IDE 一键生成、部署和托管你的全栈 Web 应用与小程序、数据库和后端服务，无需运维，极速上线你的创意 💫

🌍 Languages: 中文 | English

当你在Cursor/ VSCode GitHub Copilot/WinSurf/CodeBuddy/Augment Code/Claude Code等AI编程工具里写代码时，它能自动帮你生成可直接部署的前后端应用+小程序，并一键发布到腾讯云开发 CloudBase。

📹 完整视频演示 ⬇️

🚀 核心能力	🛠️ 支持平台
🤖 AI智能开发: AI自动生成代码和架构设计 ☁️ 云开发集成: 一键接入数据库、云函数、静态托管 ⚡ 快速部署: 几分钟内完成全栈应用上线	Web应用: 现代化前端 + 静态托管微信小程序: 云开发小程序解决方案后端服务: 云数据库 + 无服务器函数+云托管

✨ 核心特性

🤖 AI 原生 - 专为 AI 编程工具设计的规则库，生成代码符合云开发最佳实践
🚀 一键部署 - MCP 自动化部署到腾讯云开发 CloudBase 平台，Serverless 架构无需购买服务器
📱 全栈应用 - Web + 小程序 + 数据库 + 后端一体化，支持多种应用形式和后端托管
🔧 智能修复 - AI 自动查看日志并修复问题，降低运维成本
⚡ 极速体验 - 国内 CDN 加速，比海外平台访问速度更快
📚 知识检索 - 内置云开发、微信小程序等专业知识库的智能向量检索

🚀 快速开始

0. 前置条件

安装 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

1. 快速初始化或增强你的项目

我们为你准备了内置云开发最佳实践和 AI IDE 规则的项目模板，推荐如下两种方式：

🚀 新项目推荐

选择适合你的模板，一键初始化：

微信小程序 + 云开发模板
下载代码包｜开源代码地址
React Web 应用 + 云开发模板
下载代码包｜开源代码地址
Vue Web 应用 + 云开发模板
下载代码包｜开源代码地址
UniApp 跨端应用 + 云开发模板
下载代码包｜开源代码地址
AI 规则通用云开发模板 ：不限定语言和框架，内置 CloudBase AI 规则和MCP，适用于任意云开发项目

下载代码包｜开源代码地址

🛠️ 已有项目增强

如果你已经有自己的项目，只需在配置好 MCP 后，只需要对 AI 说 "在当前项目中下载云开发 AI 规则"，即可一键下载并补全 AI 编辑器规则配置到当前项目目录，无需手动操作。

2. 配置你的 AI IDE

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 插件
Claude Code	命令行工具
Gemini CLI	命令行工具

🔧 Cursor 配置

步骤1：使用 AI 规则

模板中已包含 .cursor/rules/ 目录，AI 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。

步骤2：配置 MCP

如果使用模板项目，MCP 配置已经预置完成，请点击左下角的弹出的窗口启用MCP。如果不是从模板开始，可以点击下方按钮安装到 Cursor 中：

或手动添加配置到 .cursor/mcp.json：

{
  "mcpServers": {
    "cloudbase-mcp": {
      "command": "npx",
      "args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

然后点击 Cursor 客户端右上角的 ⚙️ 图标，进入"MCP"设置，找到 cloudbase 并启用。

步骤3：切换到 Agent 模式

在对话窗口中使用 Agent 进行代码生成和自动化操作。

🌊 Codeium/WindSurf 配置

步骤1：使用 AI 规则

模板中的 .windsurf/ 目录包含专为 WindSurf 优化的配置。如果不是从模板开始，可以让 AI 帮你下载云开发规则。

步骤2：配置 MCP

如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 WindSurf 的 Plugins 配置中添加：

{
  "mcpServers": {
    "cloudbase-mcp": {
      "command": "npx",
      "args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

步骤3：切换到 Write 模式

在对话中切换到 Write 模式进行智能生成。

👥 CodeBuddy 配置

步骤1：使用 AI 规则

模板中已包含 .rules/ 目录，CodeBuddy 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。

步骤2：配置 MCP

可以在点开 CodeBuddy 右上角的 MCP 按钮，在 MCP 市场中搜索 CloudBase，然后点击安装即可。
也可以手动添加，点开 CodeBuddy 右上角的 MCP 按钮，点击右侧的添加，在 MCP 配置中添加云开发的 MCP

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

步骤3：切换到 Craft 智能体

在对话窗口中切换到 Craft 模式。建议在右侧设置中关闭确认计划功能，以获得更流畅的体验。

🤖 CLINE 配置

步骤1：使用 AI 规则

模板中已包含 .clinerules/ 目录，AI 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。

步骤2：配置 MCP

如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP Server 配置中添加：

{
  "mcpServers": {
    "cloudbase": {
      "autoApprove": [],
      "timeout": 60,
      "command": "npx",
      "args": [
        "@cloudbase/cloudbase-mcp@latest"
      ],
      "transportType": "stdio",
      "disabled": false
    }
  }
}

步骤3：使用 AI 对话

建议使用支持代码生成和 function call 的模型。

🐙 GitHub Copilot 配置

步骤1：使用 AI 规则

模板中的 .github/ 目录包含 Copilot 优化配置。如果不是从模板开始，可以让 AI 帮你下载云开发规则。

步骤2：配置 MCP

如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 .vscode/mcp.json 中添加：

{
    "servers": {
        "cloudbase": {
            "command": "npx",
            "args": [
                "@cloudbase/cloudbase-mcp@latest"
            ]
        }
    }
}

步骤3：切换到 Agent 模式

在对话窗口左下角切换到 Agent 模式进行对话。

🎯 Trae 配置

本操作指引支持 Trae 国际版和 Trae CN 版本，建议使用 Claude/DeepSeek V3 0324 等模型进行测试。

步骤1：使用 AI 规则

模板中的 .trae/rules 目录包含面向 Trae 的云开发规则配置。如果不是从模板开始，可以让 AI 帮你下载云开发规则。

步骤2：配置 MCP

需要在 Trae 的MCP 配置中添加：

{
  "mcpServers": {
    "cloudbase-mcp": {
      "command": "npx",
      "args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

步骤3：使用 Builder with MCP 对话

在智能体中选择 Builder with MCP 进行对话。

🧩 通义灵码配置

步骤1：使用 AI 规则

模板中已包含 .lingma/ 目录，通义灵码会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。

步骤2：配置 MCP

如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP 配置中添加：

{
  "mcpServers": {
    "cloudbase-mcp": {
      "command": "npx",
      "args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

步骤3：切换到智能体模式

在对话窗口左下角切换到智能体模式。

🤖 RooCode 配置

步骤1：使用 AI 规则

模板中已包含 .roo/rules 目录，RooCode 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。

步骤2：配置 MCP

如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP 配置中添加：

{
    "mcpServers": {
        "cloudbase": {
            "command": "npx",
            "args": [
                "@cloudbase/cloudbase-mcp@latest"
            ],
            "disabled": false
        }
    }
}

步骤3：使用 AI 对话

在对话窗口中进行代码生成和自动化操作。

🤖 文心快码(Baidu Comate) 配置

步骤1：使用 AI 规则

模板中已包含 .comate/rules 目录，文心快码会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则。

步骤2：配置 MCP

如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在 MCP 配置中添加：

{
    "mcpServers": {
        "cloudbase": {
            "command": "npx",
            "args": [
                "@cloudbase/cloudbase-mcp@latest"
            ],
            "disabled": false
        }
    }
}

步骤3：使用 AI 对话

在对话窗口中切换到 Zulu 模式进行操作。

🚀 Augment Code 配置

步骤1：使用 AI 规则

模板中已包含 .augment-guidelines 文件，Augment Code 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则

步骤2：配置 MCP

如果使用模板项目，MCP 配置已经预置完成(内置在.vscode/settings.json中)。如果不是从模板开始，需要在 Augment的 MCP 配置中添加云开发 MCP，参考文档：

{
  "augment.advanced": {
     "mcpServers": {
        "cloudbase": {
            "command": "npx",
            "args": [
                "@cloudbase/cloudbase-mcp@latest"
            ]
        }
    }
  }
}

步骤3：使用 Agent 模式

在对话窗口中使用 Agent 模式进行智能代码生成和自动化操作。

🤖 Claude Code 配置

步骤1：使用 AI 规则

模板中已包含 CLAUDE.md 文件，Claude Code 会自动识别云开发最佳实践。如果不是从模板开始，可以让 AI 帮你下载云开发规则

步骤2：配置 MCP

如果使用模板项目，MCP 配置已经预置完成。如果不是从模板开始，需要在项目根目录创建 .mcp.json 文件：

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": [
        "-y",
        "@cloudbase/cloudbase-mcp@latest"
      ]
    }
  }
}

步骤3：使用 AI 对话

在 Claude Code 中直接与 AI 对话进行智能代码生成和自动化操作。

🔹 Gemini CLI 配置

步骤1：安装 Gemini CLI

确保安装 Node.js 18+，然后全局安装 Gemini CLI：

npm install -g @google/gemini-cli

或直接运行：

npx @google/gemini-cli

首次运行时，使用个人 Google 账户登录即可获得免费额度（每分钟 60 次请求，每天 1000 次请求）。

步骤2：配置 MCP

如果使用模板项目，MCP 配置已经预置完成。

如果不是从模板开始，可以在用户主目录（~）或项目目录中创建 .gemini/settings.json 文件：

{
  "mcpServers": {
    "cloudbase-mcp": {
      "command": "npx",
      "args": ["-y", "@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

步骤3：启用 AI 规则

模板项目根目录已经包含 GEMINI.md 文件，包含 CloudBase 开发规则。

如果是现有项目，在 Gemini CLI 中对 AI 说：

在当前项目中下载云开发 AI 规则

步骤4：开始开发

启动 Gemini CLI：

gemini

然后对 AI 说：

登录云开发

常用命令：

/tools - 查看可用工具
/mcp - 查看 MCP 服务器状态
/memory show - 查看当前规则
!command - 执行 Shell 命令

🔄 更新 CloudBase AI ToolKit

更新 AI 规则

如果你想在现有项目中更新到最新的云开发 AI 规则，只需对 AI 说：

下载云开发 AI 规则

AI 会自动下载并更新最新的规则配置到你的项目目录。

更新 MCP 工具

当有新版本的 MCP 工具发布时，你可以通过以下方式更新：

自动更新（推荐）：在你的 AI 开发工具的 MCP 列表中，找到 cloudbase-mcp 并重新启用或刷新 MCP 列表即可自动安装最新版本
手动更新：如果自动更新不成功，可以先禁用再重新启用 cloudbase-mcp，或者重启你的 AI IDE

由于 MCP 配置中使用了 @latest 标签，通常会自动获取最新版本。

3. 开始开发

在开始使用前，只需要对 AI 说

登录云开发

AI 就会自动完成弹出登录腾讯云界面以及云开发的环境选择

后续如需切换环境，可以说

退出云开发

AI 就会清理本地的配置，后续可以再要求 AI 登录云开发来重新登录。

在登录成功后，可以确认 AI 已经连接到云开发

查询当前云开发环境信息

向 AI 描述你的需求,进行开发：

做一个双人在线对战五子棋网站，支持联机对战，最后进行部署

AI 会自动：

📝 生成前后端代码
🚀 部署到云开发
🔗 返回在线访问链接

开发过程中如果遇到报错，可以把错误信息发给 AI 来进行排障

报错了，错误是xxxx

也可以让 AI 结合云函数日志进行调试和修改代码

云函数代码运行不符合需求，需求是 xxx，请查看日志和数据进行调试，并进行修复

📚 教程

📄 文章

📱 应用项目

🎥 视频教程

🎯 使用案例

案例1：双人在线对战五子棋

开发过程：

输入需求："做个双人在线对战五子棋网站，支持联机对战"
AI 生成：Web 应用 + 云数据库 + 实时数据推送
自动部署并获得访问链接

👉 体验地址： 五子棋游戏

📸 查看开发截图

开发过程	最终效果

	支持双人在线对战实时棋局同步

案例2：AI 宠物养成小程序

开发过程：

输入："开发一个宠物小精灵养成小程序，使用 AI 增强互动"
AI 生成：小程序 + 云数据库 + AI 云函数
导入微信开发者工具即可发布

📸 查看开发截图与小程序预览

🖥️ 开发截图

📱 小程序预览

📲 体验二维码

案例3：智能问题诊断

当应用出现问题时：

AI 自动查看云函数日志
分析错误原因并生成修复代码
自动重新部署

📸 查看智能诊断过程

AI 自动分析日志并生成修复方案

🌟 为什么选择 CloudBase？

⚡ 极速部署：国内节点,访问速度比海外更快
🛡️ 稳定可靠：330 万开发者选择的 Serverless 平台
🔧 开发友好：专为AI时代设计的全栈平台，支持自动环境配置
💰 成本优化：Serverless 架构更具弹性，新用户开发期间可以免费体验

📋 常见问题 FAQ

如有迁移、集成等常见疑问，请查阅 FAQ 常见问题。

💬 技术交流群

遇到问题或想要交流经验？加入我们的技术社区！

🔥 微信交流群

扫码加入微信技术交流群

群内你可以：

💡 分享你的 AI + 云开发项目
🤝 技术交流和开发问题沟通
📢 获取最新功能更新和最佳实践
🎯 参与产品功能讨论和建议

📱 其他交流方式

平台	链接	说明
官方文档	📖 查看文档	完整的云开发文档
Issue 反馈	🐛 提交问题	Bug 反馈和功能请求

🎉 社区活动

每周技术分享：群内定期分享 AI + 云开发最佳实践
项目展示：展示你用 AI 开发的精彩项目
问题答疑：腾讯云开发团队成员在线答疑
新功能预览：第一时间体验最新功能

🛠️ 云开发 MCP 工具一览

目前共有 35 个工具，涵盖环境管理、数据库操作、云函数管理、静态托管等核心功能。

📋 完整工具文档: 查看 MCP 工具详细说明 | 查看工具规格 JSON

🔧 工具分类概览

分类	工具数量	主要功能
🌍 环境管理	4 个	登录认证、环境信息查询、域名管理
🗄️ 数据库操作	11 个	集合管理、文档 CRUD、索引操作、数据模型
⚡ 云函数管理	9 个	函数创建、更新、调用、日志、触发器
🌐 静态托管	5 个	文件上传管理、域名配置、网站部署
📁 文件操作	2 个	远程文件下载、云存储上传
🛠️ 工具支持	3 个	项目模板、知识库搜索、交互对话
🔌 HTTP访问	1 个	HTTP 函数访问配置

🌟 核心工具亮点

工具类型	工具名称	功能亮点
🔐 身份认证	`login` / `logout`	一键登录云开发，自动环境选择
📊 环境查询	`envQuery`	🔄 合并工具 - 环境列表、信息、域名一体化查询
🗄️ 数据库	`collectionQuery`	🔄 合并工具 - 集合存在性、详情、列表统一管理
⚡ 云函数	`createFunction`	支持完整配置、自动依赖安装、触发器设置
🌐 静态托管	`uploadFiles`	批量文件上传、智能忽略规则、CDN 加速
🧠 AI 增强	`searchKnowledgeBase`	向量搜索云开发知识库，智能问答支持

💡 工具优化说明

我们将原来 40 个工具优化为 35 个，通过合并相关功能提供更好的使用体验

🔗 想了解每个工具的详细功能？ 请查看 MCP 工具完整文档

🏗️ 架构原理

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！请查看我们的贡献指南了解如何参与项目开发。

📄 开源协议

⭐ 如果这个项目对你有帮助，请给我们一个 Star！

Name		Name	Last commit message	Last commit date
Latest commit History 184 Commits
config		config
doc		doc
mcp		mcp
scripts		scripts
.gitignore		.gitignore
.versionrc		.versionrc
.versionrc.json		.versionrc.json
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README-EN.md		README-EN.md
README.md		README.md
memory.md		memory.md
package-lock.json		package-lock.json
package.json		package.json

License

TencentCloudBase/CloudBase-AI-ToolKit

Folders and files

Latest commit

History

Repository files navigation

🌟 CloudBase AI ToolKit

✨ 核心特性

🚀 快速开始

0. 前置条件

1. 快速初始化或增强你的项目

🚀 新项目推荐

🛠️ 已有项目增强

2. 配置你的 AI IDE

步骤1：使用 AI 规则

步骤2：配置 MCP

步骤3：切换到 Agent 模式

步骤1：使用 AI 规则

步骤2：配置 MCP

步骤3：切换到 Write 模式

步骤1：使用 AI 规则

步骤2：配置 MCP

步骤3：切换到 Craft 智能体

步骤1：使用 AI 规则

步骤2：配置 MCP

步骤3：使用 AI 对话

步骤1：使用 AI 规则

步骤2：配置 MCP

步骤3：切换到 Agent 模式

步骤1：使用 AI 规则

步骤2：配置 MCP

步骤3：使用 Builder with MCP 对话

步骤1：使用 AI 规则

步骤2：配置 MCP

步骤3：切换到智能体模式

步骤1：使用 AI 规则

步骤2：配置 MCP

步骤3：使用 AI 对话

步骤1：使用 AI 规则

步骤2：配置 MCP

步骤3：使用 AI 对话

步骤1：使用 AI 规则

步骤2：配置 MCP

步骤3：使用 Agent 模式

步骤1：使用 AI 规则

步骤2：配置 MCP

步骤3：使用 AI 对话

步骤1：安装 Gemini CLI

步骤2：配置 MCP

步骤3：启用 AI 规则

步骤4：开始开发

3. 开始开发

📚 教程

📄 文章

📱 应用项目

🎥 视频教程

🎯 使用案例

案例1：双人在线对战五子棋

案例2：AI 宠物养成小程序

案例3：智能问题诊断

🌟 为什么选择 CloudBase？

📋 常见问题 FAQ

💬 技术交流群

🔥 微信交流群

📱 其他交流方式

🎉 社区活动

🛠️ 云开发 MCP 工具一览

🔧 工具分类概览

🌟 核心工具亮点

💡 工具优化说明

🏗️ 架构原理

🔒 数据统计说明

🤝 贡献指南

📄 开源协议

About

Topics

Resources

License

Code of conduct

Uh oh!

Packages