Gathering detailed insights and metrics for @cloudbase/cloudbase-mcp
Gathering detailed insights and metrics for @cloudbase/cloudbase-mcp
Gathering detailed insights and metrics for @cloudbase/cloudbase-mcp
Gathering detailed insights and metrics for @cloudbase/cloudbase-mcp
npm install @cloudbase/cloudbase-mcp
Typescript
Module System
Node Version
NPM Version
Cumulative downloads
Total Downloads
Last Day
0%
NaN
Compared to previous day
Last Week
0%
NaN
Compared to previous week
Last Month
0%
NaN
Compared to previous month
Last Year
0%
NaN
Compared to previous year
12
21
🪐 用 AI IDE 一键生成、部署和托管你的全栈 Web 应用与小程序、数据库和后端服务,无需运维,极速上线你的创意 💫
🌍 Languages: 中文 | English
当你在Cursor/ VSCode GitHub Copilot/WinSurf/CodeBuddy/Augment Code/Claude Code/OpenAI Codex CLI等AI编程工具里写代码时,它能自动帮你生成可直接部署的前后端应用+小程序,并一键发布到腾讯云开发 CloudBase。
📹 完整视频演示 ⬇️
🚀 核心能力 | 🛠️ 支持平台 |
---|---|
🤖 AI智能开发: AI自动生成代码和架构设计 ☁️ 云开发集成: 一键接入数据库、云函数、静态托管 ⚡ 快速部署: 几分钟内完成全栈应用上线 | Web应用: 现代化前端 + 静态托管 微信小程序: 云开发小程序解决方案 后端服务: 云数据库 + 无服务器函数+云托管 |
📚 快速开始 | 🛠️ IDE配置 | 🎨 项目模板 | 📖 开发指南 | 🎮 使用案例 | 🎓 教程 | 🔌 插件系统 | 🔧 MCP工具 | ❓ 常见问题
例如 Cursor | WindSurf | CodeBuddy 等,点击查看 支持的 AI 开发工具列表
访问 腾讯云开发控制台开通环境,新用户可以免费开通体验。
确保您的计算机上安装了 Node.js v18 及以上版本。您可以从 Node.js 官网 下载并安装最新版本。
为了提高依赖包的下载速度,建议将 npm 源设置为腾讯镜像源。您可以在终端命令行中运行以下命令:
1npm config set registry https://mirrors.cloud.tencent.com/npm/
这样可以加快依赖包的下载速度,特别是在中国大陆地区。
在终端命令行中运行以下命令:
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 插件 | 查看指引 |
Claude Code | 命令行工具 | 查看指引 |
Gemini CLI | 命令行工具 | 查看指引 |
OpenAI Codex CLI | 命令行工具 | 查看指引 |
模板中已包含 .cursor/rules/
目录,AI 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成,请点击左下角的弹出的窗口启用MCP。如果不是从模板开始,可以点击下方按钮安装到 Cursor 中:
或手动添加配置到 .cursor/mcp.json
:
1{ 2 "mcpServers": { 3 "cloudbase-mcp": { 4 "command": "npx", 5 "args": ["-y", "@cloudbase/cloudbase-mcp@latest"] 6 } 7 } 8}
然后点击 Cursor 客户端右上角的 ⚙️ 图标,进入"MCP"设置,找到 cloudbase 并启用。
在对话窗口中使用 Agent 进行代码生成和自动化操作。
模板中的 .windsurf/
目录包含专为 WindSurf 优化的配置。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 WindSurf 的 Plugins 配置中添加:
1{ 2 "mcpServers": { 3 "cloudbase-mcp": { 4 "command": "npx", 5 "args": ["-y", "@cloudbase/cloudbase-mcp@latest"] 6 } 7 } 8}
在对话中切换到 Write 模式进行智能生成。
模板中已包含 .rules/
目录,CodeBuddy 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
如果安装以后工具数量一直为 0,请参考常见问题
可以在 点开 CodeBuddy 右上角的 MCP 按钮,在 MCP 市场中搜索 CloudBase,然后点击安装即可。
也可以手动添加,点开 CodeBuddy 右上角的 MCP 按钮,点击右侧的添加,在 MCP 配置中添加云开发的 MCP
1{ 2 "mcpServers": { 3 "cloudbase": { 4 "command": "npx", 5 "args": ["-y", "@cloudbase/cloudbase-mcp@latest"] 6 } 7 } 8}
在对话窗口中切换到 Craft 模式。建议在右侧设置中关闭确认计划功能,以获得更流畅的体验。
模板中已包含 .clinerules/
目录,AI 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP Server 配置中添加:
1{ 2 "mcpServers": { 3 "cloudbase": { 4 "autoApprove": [], 5 "timeout": 60, 6 "command": "npx", 7 "args": [ 8 "@cloudbase/cloudbase-mcp@latest" 9 ], 10 "transportType": "stdio", 11 "disabled": false 12 } 13 } 14}
建议使用支持代码生成和 function call 的模型。
模板中的 .github/
目录包含 Copilot 优化配置。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 .vscode/mcp.json
中添加:
1{ 2 "servers": { 3 "cloudbase": { 4 "command": "npx", 5 "args": [ 6 "@cloudbase/cloudbase-mcp@latest" 7 ] 8 } 9 } 10}
在对话窗口左下角切换到 Agent 模式进行对话。
本操作指引支持 Trae 国际版和 Trae CN 版本,建议使用 Claude/DeepSeek V3 0324 等模型进行测试。
模板中的 .trae/rules
目录包含面向 Trae 的云开发规则配置。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
需要在 Trae 的MCP 配置中添加:
1{ 2 "mcpServers": { 3 "cloudbase-mcp": { 4 "command": "npx", 5 "args": ["-y", "@cloudbase/cloudbase-mcp@latest"] 6 } 7 } 8}
在智能体中选择 Builder with MCP 进行对话。
模板中已包含 .lingma/
目录,通义灵码会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP 配置中添加:
1{ 2 "mcpServers": { 3 "cloudbase-mcp": { 4 "command": "npx", 5 "args": ["-y", "@cloudbase/cloudbase-mcp@latest"] 6 } 7 } 8}
在对话窗口左下角切换到智能体模式。
模板中已包含 .roo/rules
目录,RooCode 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP 配置中添加:
1{ 2 "mcpServers": { 3 "cloudbase": { 4 "command": "npx", 5 "args": [ 6 "@cloudbase/cloudbase-mcp@latest" 7 ], 8 "disabled": false 9 } 10 } 11}
在对话窗口中进行代码生成和自动化操作。
模板中已包含 .comate/rules
目录,文心快码会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则。
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在 MCP 配置中添加:
1{ 2 "mcpServers": { 3 "cloudbase": { 4 "command": "npx", 5 "args": [ 6 "@cloudbase/cloudbase-mcp@latest" 7 ], 8 "disabled": false 9 } 10 } 11}
在对话窗口中切换到 Zulu 模式进行操作。
模板中已包含 .augment-guidelines
文件,Augment Code 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成(内置在.vscode/settings.json
中)。如果不是从模板开始,需要在 Augment的 MCP 配置中添加云开发 MCP,参考文档:
1{ 2 "augment.advanced": { 3 "mcpServers": { 4 "cloudbase": { 5 "command": "npx", 6 "args": [ 7 "@cloudbase/cloudbase-mcp@latest" 8 ] 9 } 10 } 11 } 12}
在对话窗口中使用 Agent 模式进行智能代码生成和自动化操作。
模板中已包含 CLAUDE.md
文件,Claude Code 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,需要在项目根目录创建 .mcp.json
文件:
1{ 2 "mcpServers": { 3 "cloudbase": { 4 "command": "npx", 5 "args": [ 6 "-y", 7 "@cloudbase/cloudbase-mcp@latest" 8 ] 9 } 10 } 11}
在 Claude Code 中直接与 AI 对话进行智能代码生成和自动化操作。
确保安装 Node.js 18+,然后全局安装 Gemini CLI:
1npm install -g @google/gemini-cli
或直接运行:
1npx @google/gemini-cli
首次运行时,使用个人 Google 账户登录即可获得免费额度(每分钟 60 次请求,每天 1000 次请求)。
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成。
如果不是从模板开始,可以在用户主目录(~
)或项目目录中创建 .gemini/settings.json
文件:
1{ 2 "mcpServers": { 3 "cloudbase-mcp": { 4 "command": "npx", 5 "args": ["-y", "@cloudbase/cloudbase-mcp@latest"] 6 } 7 } 8}
模板项目根目录已经包含 GEMINI.md
文件,包含 CloudBase 开发规则。
如果是现有项目,在 Gemini CLI 中对 AI 说:
在当前项目中下载云开发 AI 规则
启动 Gemini CLI:
1gemini
然后对 AI 说:
登录云开发
常用命令:
/tools
- 查看可用工具/mcp
- 查看 MCP 服务器状态/memory show
- 查看当前规则!command
- 执行 Shell 命令确保安装 Node.js 18+,然后全局安装 OpenAI Codex CLI:
1npm install -g @openai/codex
或直接运行:
1npx @openai/codex
[!TIP] 如果安装以后工具数量一直为 0,请参考常见问题
如果使用模板项目,MCP 配置已经预置完成。如果不是从模板开始,有两种配置方式:
方式一:使用项目配置文件(推荐)
在项目根目录创建 .codex/config.toml
文件:
1[mcp_servers.cloudbase] 2command = "npx" 3args = ["-y", "@cloudbase/cloudbase-mcp@latest"]
然后启动时指定配置文件:
1codex --config .codex/config.toml
方式二:全局配置
在用户主目录创建 ~/.codex/config.toml
文件:
1[mcp_servers.cloudbase] 2command = "npx" 3args = ["-y", "@cloudbase/cloudbase-mcp@latest"]
模板中已包含 AGENTS.md
文件,OpenAI Codex CLI 会自动识别云开发最佳实践。如果不是从模板开始,可以让 AI 帮你下载云开发规则:
在当前项目中下载云开发 AI 规则
启动 OpenAI Codex CLI:
1codex
如果使用项目配置文件:
1codex --config .codex/config.toml
在 Codex CLI 中与 AI 对话:
登录云开发
然后就可以进行需求的开发了
更新 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,请查看日志和数据进行调试,并进行修复
CloudBase MCP 采用插件化架构,支持按需启用工具模块。查看详细文档
1{ 2 "env": { 3 "CLOUDBASE_MCP_PLUGINS_ENABLED": "env,database,functions,hosting" 4 } 5}
开发过程:
👉 体验地址: 五子棋游戏
开发过程 | 最终效果 |
---|---|
![]() | ![]() |
![]() | 支持双人在线对战 实时棋局同步 |
开发过程:
🖥️ 开发截图![]() ![]() |
📱 小程序预览![]() ![]() 📲 体验二维码 ![]() |
当应用出现问题时:
如有迁移、集成等常见疑问,请查阅 FAQ 常见问题。
遇到问题或想要交流经验?加入我们的技术社区!
群内你可以:
平台 | 链接 | 说明 |
---|---|---|
官方文档 | 📖 查看文档 | 完整的云开发文档 |
Issue 反馈 | 🐛 提交问题 | Bug 反馈和功能请求 |
目前共有 36 个工具,涵盖环境管理、数据库操作、云函数管理、静态托管等核心功能。
📋 完整工具文档: 查看 MCP 工具详细说明 | 查看工具规格 JSON
分类 | 工具数量 | 主要功能 |
---|---|---|
🌍 环境管理 | 4 个 | 登录认证、环境信息查询、域名管理 |
🗄️ 数据库操作 | 11 个 | 集合管理、文档 CRUD、索引操作、数据模型 |
⚡ 云函数管理 | 9 个 | 函数创建、更新、调用、日志、触发器 |
🌐 静态托管 | 5 个 | 文件上传管理、域名配置、网站部署 |
📁 文件操作 | 2 个 | 远程文件下载、云存储上传 |
🛠️ 工具支持 | 4 个 | 项目模板、知识库搜索、联网搜索、交互对话 |
🔌 HTTP访问 | 1 个 | HTTP 函数访问配置 |
工具类型 | 工具名称 | 功能亮点 |
---|---|---|
🔐 身份认证 | login / logout | 一键登录云开发,自动环境选择 |
📊 环境查询 | envQuery | 🔄 合并工具 - 环境列表、信息、域名一体化查询 |
🗄️ 数据库 | collectionQuery | 🔄 合并工具 - 集合存在性、详情、列表统一管理 |
⚡ 云函数 | createFunction | 支持完整配置、自动依赖安装、触发器设置 |
🌐 静态托管 | uploadFiles | 批量文件上传、智能忽略规则、CDN 加速 |
🧠 AI 增强 | searchKnowledgeBase | 向量搜索云开发知识库,智能问答支持 |
我们将原来 40 个工具优化为 36 个,通过合并相关功能提供更好的使用体验
🔗 想了解每个工具的详细功能? 请查看 MCP 工具完整文档
1graph TD 2 A[开发者] --> B[AI IDE] 3 B -->|使用| C[CloudBase AI 规则] 4 C --> D[生成代码] 5 B -->|调用| E[CloudBase MCP] 6 E --> F{检测部署} 7 F -->|成功| G[云开发平台] 8 F -->|失败| H[返回日志] 9 H --> I[AI 修复] 10 I --> E 11 G --> J[线上应用] 12 J --> K[Web/小程序/API]
为了改进产品体验,CloudBase AI ToolKit 会收集匿名使用统计信息:
可通过环境变量 CLOUDBASE_MCP_TELEMETRY_DISABLED
设置为 true
禁用数据统计
欢迎提交 Issue 和 Pull Request!请查看我们的贡献指南了解如何参与项目开发。
MIT © TencentCloudBase
⭐ 如果这个项目对你有帮助,请给我们一个 Star!
No vulnerabilities found.
No security vulnerabilities found.