Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@cloudbase/cloudbase-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
🌟 CloudBase AI ToolKit
通过AI提示词和MCP协议+云开发,让开发更智能、更高效
🌍 Languages: 中文 | English
当你在Cursor/ VSCode GitHub Copilot/WinSurf/CodeBuddy等AI编程工具里写代码时,它能自动帮你生成可直接部署的前后端应用+小程序,并一键发布到腾讯云开发 CloudBase。
🚀 三大核心能力
🤖 AI智能开发: AI自动生成代码和架构设计
☁️ 云开发集成: 一键接入数据库、云函数、静态托管
⚡ 快速部署: 几分钟内完成全栈应用上线
🛠️ 支持平台
Web应用: 现代化前端 + 静态托管
微信小程序: 云开发小程序解决方案
后端服务: 云数据库 + 无服务器函数+云托管
完整视频演示
https://github.com/user-attachments/assets/2b402fa6-c5c4-495a-b85b-f5d4a25daa4a
✨ 核心特性
特性 | 说明 | 优势 |
---|---|---|
🤖 AI 原生 | 专为 AI 编程工具设计的规则库 | 生成代码符合云开发最佳实践 |
🚀 一键部署 | MCP 自动化部署到腾讯云开发 CloudBase 平台 | Serverless 架构,无需购买服务器 |
📱 全栈应用支持 | Web + 小程序 + 数据库 + 后端一体化 | 支持小程序/web 等多种应用形式,提供后端托管和数据库 |
🔧 智能修复 | AI 自动查看日志并修复问题 | 降低运维成本 |
⚡ 极速体验 | 国内 CDN 加速 | 比海外平台访问速度更快 |
📚 智能知识库检索 | 内置支持云开发、微信小程序等专业知识库的智能向量检索 |
🚀 快速开始
0. 前置条件
安装 AI 开发工具
例如 Cursor | WindSurf | CodeBuddy 等
开通云开发环境并获取环境 ID
- 访问 腾讯云开发控制台开通环境,新用户可以免费开通体验
- 在控制台「概览」页面右侧获取 环境ID
(后续部署需要此 ID)
1. 快速初始化或增强你的项目
我们为你准备了内置云开发最佳实践和 AI IDE 规则的项目模板,推荐如下两种方式:
🚀 新项目推荐
选择适合你的模板,一键初始化:
🛠️ 已有项目增强
如果你已经有自己的项目,只需在配置好 MCP 后,让 AI 调用 downloadTemplate
工具,选择 rules
模板,即可一键下载并补全 AI 编辑器规则配置到当前项目目录,无需手动操作。
2. 配置你的 AI IDE
💡 使用提示:如果你在 Cursor 等工具中开启了自动执行(auto-run)模式,建议在"Command denylist"中添加敏感命令,避免自动运行如删除数据等敏感的操作
默认模式下需要手动确认执行,较为安全。
以下工具均支持 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插件 |
选择工具后,请按照下方对应的配置说明进行设置。每个工具都需要配置云开发环境 ID 才能使用 MCP 功能。如果你还没有云开发环境,请先开通云开发环境。
🔧 Cursor 配置
步骤1:自动应用 AI 规则
模板中已包含 .cursor/rules/
目录,AI 会自动识别云开发最佳实践。
步骤2:配置 MCP
模板中已经包含 mcp 配置,如果不是从模板开始,可以点击下方按钮安装到 Cursor 中
- 请修改项目中的
.cursor/mcp.json
,填写你的云开发环境 ID
{
"mcpServers": {
"cloudbase-mcp": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"],
"env": {
"CLOUDBASE_ENV_ID": "你的云开发环境ID"
}
}
}
}
- 启用云开发 MCP Server
点击 Cursor 客户端右上角的 ⚙️ 图标,点击进入之后,选择"MCP",在 MCP Server 页面,找到 cloudbase 右边的开关按钮,点击启用
步骤3:切换到 Agent 模式
在 对话窗口中使用 Agent 进行代码生成和自动化操作
🌊 Codeium/WindSurf 配置
步骤1:自动应用 AI 规则
模板中的 .windsurf/
目录包含专为 WindSurf 优化的配置。
步骤2:配置 MCP
点击 windsurf 的 Plugins icon,点击"View raw config",在其中加入 clodubase-mcp,同时设置环境 id
{
"mcpServers": {
"cloudbase-mcp": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"],
"env": {
"CLOUDBASE_ENV_ID": "你的云开发环境ID"
}
}
}
}
步骤3:切换到 Write 模式
在对话中切换到 Write 模式,这样可以智能进行生成
👥 CodeBuddy 配置
步骤1:自动应用 AI 规则
模板中已包含 .rules/
目录,CodeBuddy 会自动识别云开发最佳实践
步骤 2:配置 MCP
配置云开发 MCP Server
点击 CodeBuddy 右上角的 MCP 图标
点击进入之后,点击右侧的 + 号,在打开的文件中修改 MCP 配置
其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
{
"mcpServers": {
"cloudbase-mcp": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"],
"env": {
"CLOUDBASE_ENV_ID": "你的云开发环境ID"
}
}
}
}
步骤 3:切换到 Craft 智能体
在对话窗口中切换到 Craft 模式,这样可以智能生成项目
注意,在 CodeBuddy 的 Craft 中使用时,需要在右侧的设置按钮中,关闭确认计划功能,这样可以更好的执行工具。
🤖 CLINE 配置
步骤1:自动应用 AI 规则
模板中已包含 .clinerules/
目录,AI 会自动识别云开发最佳实践
步骤 2:配置 MCP
配置云开发 MCP Server
在 Cline 的面板中找到 MCP Server 图标,点击进入,点击 ⚙️ 设置图标,然后点击 Configure MCP Servers
加入以下内容,其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
{
"mcpServers": {
"cloudbase": {
"autoApprove": [],
"timeout": 60,
"command": "npx",
"args": [
"@cloudbase/cloudbase-mcp@latest"
],
"env": {
"CLOUDBASE_ENV_ID": "你的云开发环境ID"
},
"transportType": "stdio",
"disabled": false
}
}
}
步骤 3:使用 AI 对话
回到对话界面,建议使用代码生成能力较好和支持 function call 的模型
🐙 GitHub Copilot 配置
GitHub Copilot Chat 配置
步骤1:自动应用 AI 规则
模板中的 .github/
目录包含 Copilot 优化配置。
步骤2:启用云开发 MCP
模板中的 .vscode/mcp.json
目录已经包含云开发 MCP 配置
请修改其中的环境 Id 为你的云开发环境 Id
{
"servers": {
"cloudbase": {
"command": "npx",
"args": [
"@cloudbase/cloudbase-mcp@latest"
],
"env": {
"CLOUDBASE_ENV_ID": "你的云开发环境ID"
}
}
}
}
步骤 3:切换到 Agent 模式
在对话窗口左下角切换到 Agent 模式,进行对话
🎯 Trae 配置
本操作指引支持 Trae 国际版和 Trae CN 版本,建议使用 Claude/DeepSeek V3 0324 等模型进行测试
步骤1:自动应用 AI 规则
模板中的 .trae/rules
目录包含面向 Trae 的云开发规则配置,AI 会自动应用,无需修改。
步骤2:启用云开发 MCP
在 Trae 右上角点击 ⚙️设置图标,点击进入 MCP,点击设置中的手动配置,粘贴如下配置
其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
{
"mcpServers": {
"cloudbase-mcp": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"],
"env": {
"CLOUDBASE_ENV_ID": "你的云开发环境ID"
}
}
}
}
步骤3:使用 Builder with MCP 对话
回到对话窗口,在智能体中选择使用 Builder with MCP 对话
🧩 通义灵码 配置
步骤1:自动应用 AI 规则
模板中已包含 .lingma/
通义灵码会自动识别云开发最佳实践
步骤 2:配置 MCP
配置云开发 MCP Server
点击通义灵码右上角的昵称,然后选择个人设置,点击进入 MCP 设置
点击进入之后,点击右侧的打开配置文件按钮,在打开的文件中修改 MCP 配置
其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
{
"mcpServers": {
"cloudbase-mcp": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"],
"env": {
"CLOUDBASE_ENV_ID": "你的云开发环境ID"
}
}
}
}
步骤 3:切换到智能体模式
在对话窗口左下角中切换到智能体模式,这样可以智能生成项目
🤖 RooCode 配置
步骤1:自动应用 AI 规则
模板中已包含 .roo/rules
目录,RooCode 会自动识别云开发最佳实践
步骤2:配置 MCP
配置云开发 MCP Server
点击 RooCode 右上角的设置图标,选择 MCP 配置,在打开的文件中修改 MCP 配置
其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": [
"@cloudbase/cloudbase-mcp@latest"
],
"env": {
"CLOUDBASE_ENV_ID": "你的云开发环境ID"
},
"disabled": false
}
}
}
步骤3:使用 AI 对话
在对话窗口中使用 AI 进行代码生成和自动化操作
🤖 文心快码(Baidu Comate) 配置
步骤1:自动应用 AI 规则
模板中已包含 .comate/rules
目录,文心快码会自动识别云开发最佳实践
步骤2:配置 MCP
模板中已包含 .comate/mcp.json
目录,文心快码会自动识别项目中的 MCP
配置云开发 MCP Server
在文心快码的 Zulu 模式中,选择 MCP 配置-设置,在打开的文件中修改 MCP 配置
其中 CLOUDBASE_ENV_ID 填写你的云开发环境 ID
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": [
"@cloudbase/cloudbase-mcp@latest"
],
"env": {
"CLOUDBASE_ENV_ID": "你的云开发环境ID"
},
"disabled": false
}
}
}
步骤3:使用 AI 对话
在对话窗口中切换到 Zulu 模式,然后使用 AI 进行代码生成和自动化操作
3. 开始开发
确认 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 工具一览
工具名称 | 功能简介 |
---|---|
logout | 登出当前云开发账户 |
downloadTemplate | 下载CloudBase项目模板(React、小程序、AI编辑器配置等) |
listEnvs | 获取所有云开发环境信息 |
getEnvAuthDomains | 获取云开发环境的合法域名列表 |
createEnvDomain | 为云开发环境添加安全域名 |
deleteEnvDomain | 删除云开发环境的指定安全域名 |
getEnvInfo | 获取当前云开发环境信息 |
updateEnvInfo | 修改云开发环境别名 |
createCollection | 创建一个新的云开发数据库集合 |
checkCollectionExists | 检查云开发数据库集合是否存在 |
updateCollection | 更新云开发数据库集合配置(创建或删除索引) |
describeCollection | 获取云开发数据库集合的详细信息 |
listCollections | 获取云开发数据库集合列表 |
checkIndexExists | 检查索引是否存在 |
distribution | 查询数据库中集合的数据分布情况 |
insertDocuments | 向集合中插入文档 |
queryDocuments | 查询集合中的文档 |
updateDocuments | 更新集合中的文档 |
deleteDocuments | 删除集合中的文档 |
uploadFiles | 上传文件到静态网站托管 |
listFiles | 获取静态网站托管的文件列表 |
deleteFiles | 删除静态网站托管的文件或文件夹 |
findFiles | 搜索静态网站托管的文件 |
createHostingDomain | 绑定自定义域名 |
deleteHostingDomain | 解绑自定义域名 |
getWebsiteConfig | 获取静态网站配置 |
tcbCheckResource | 获取域名配置 |
tcbModifyAttribute | 修改域名配置 |
getFunctionList | 获取云函数列表 |
createFunction | 创建云函数 |
updateFunctionCode | 更新云函数代码 |
updateFunctionConfig | 更新云函数配置 |
getFunctionDetail | 获取云函数详情 |
invokeFunction | 调用云函数 |
getFunctionLogs | 获取云函数日志 |
createFunctionTriggers | 创建云函数触发器 |
deleteFunctionTrigger | 删除云函数触发器 |
downloadRemoteFile | 下载远程文件到本地临时文件 |
uploadFile | 上传文件到云存储(适合存储业务数据文件) |
searchKnowledgeBase | 智能检索云开发知识库(支持云开发与云函数),通过向量搜索快速获取专业文档与答案。 |
🏗️ 架构原理
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]
🤝 贡献指南
欢迎提交 Issue 和 Pull Request!请查看我们的贡献指南了解如何参与项目开发。
📄 开源协议
MIT © TencentCloudBase
⭐ 如果这个项目对你有帮助,请给我们一个 Star!