README.md
May 7, 2026 · View on GitHub

CloudBase MCP
🪐 AI 编程,一键上线
连接 AI IDE 与腾讯云 CloudBase 的部署桥梁,让你的 AI 应用即刻上线
💡 像 Vercel + Supabase,但全程 AI 驱动——从提示词直达生产环境
English · 简体中文 · 文档 · 更新日志 · 反馈问题
⭐ 喜欢这个项目?点个 Star,新版本发布时你会收到通知~
发现了一个让 AI 编程一键上线的神器,推荐给正在用 AI 编程的朋友
从 AI 提示词到应用上线的最短路径
为什么你需要 CloudBase MCP?
AI 编程工具(如 OpenClaw、Cursor、CodeBuddy)解决了代码生成的难题。
但是,从"生成代码"到"应用上线"(部署、配置数据库、CDN、域名),依然存在一条鸿沟。
CloudBase MCP(原 CloudBase AI ToolKit)填补了这条鸿沟。
你不再需要:
- ❌ 繁琐的 DevOps 配置和 YAML 文件
- ❌ 手动设置云函数和数据库
- ❌ 在 IDE 和云控制台之间反复横跳
你只需要在 AI IDE 中,用自然语言完成从"想法"到"上线"的全过程。
🚀 快速开始
一行配置,立即使用
在支持 MCP 的 AI IDE 中(Cursor、WindSurf、CodeBuddy 等)添加下方任一配置即可。连接方式有两种:
方式一:本地模式(推荐)
含义:MCP 服务在你本机通过 npx 启动,与 IDE 同机运行。
优点:功能最全(包含上传/下载、模板安装等依赖本地文件系统的能力)。
要求:本机已安装 Node.js,且能执行 npx。
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"]
}
}
}
方式二:托管模式
含义:MCP 服务运行在腾讯云上,IDE 通过 HTTP 连接云端服务,无需在本地安装或运行 Node。 优点:不依赖本机环境,配置好密钥即可使用。 限制:部分依赖本地文件系统的能力不可用(如本地文件上传、模板下载到本机等)。
将下面配置中的 <env_id>、<腾讯云 Secret ID>、<腾讯云 Secret Key> 替换为你的环境 ID 和腾讯云 API 密钥:
{
"mcpServers": {
"cloudbase": {
"type": "http",
"url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<env_id>",
"headers": {
"X-TencentCloud-SecretId": "<腾讯云 Secret ID>",
"X-TencentCloud-SecretKey": "<腾讯云 Secret Key>"
}
}
}
}
托管模式可选:通过 URL 控制插件启用范围
在 url 里可通过 query 参数控制插件启用范围:
enable_plugins:仅启用指定插件,多个插件使用逗号分隔,例如只启用env和databasedisable_plugins:从默认插件集合中禁用指定插件,多个插件使用逗号分隔,例如禁用rag和env
# 只启用指定插件
https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&enable_plugins=env,database
# 禁用指定插件
https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&disable_plugins=rag,env
当前可配置的插件名以 mcp/src/server.ts 为准,建议优先使用 canonical 名称:env, database, functions, hosting, storage, setup, rag, download, gateway, cloudrun, app-auth, permissions, logs, agents, invite-code, capi, apps。
Tip
推荐使用 CloudBase AI CLI
一键安装,自动配置,支持多种 AI 编程工具:
npm install @cloudbase/cli@latest -g
安装后运行 tcb ai 即可开始使用
首次使用
-
登录云开发
登录云开发AI 会自动打开登录界面并引导环境选择
-
开始开发
做一个双人在线对战五子棋网站,支持联机对战,最后进行部署AI 会自动生成代码、部署到云端并返回访问链接
支持的 AI IDE
| 工具 | 支持平台 | 查看指引 |
|---|---|---|
| CloudBase AI CLI | 命令行工具 | 查看指引 |
| OpenClaw | 命令行工具 | 查看指引 |
| Cursor | 独立 IDE | 查看指引 |
| WindSurf | 独立 IDE, VSCode、JetBrains 插件 | 查看指引 |
| CodeBuddy | 独立 IDE(已内置 CloudBase),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 | 命令行工具 | 查看指引 |
| OpenCode | 命令行工具 | 查看指引 |
| Qwen Code | 命令行工具 | 查看指引 |
✨ 如何实现 AI 编程"一键上线"?
1. AI 原生(AI-Native)
我们不是简单的"胶水代码"。内置的规则库专为 AI 编程设计,能让 AI 直接生成"可部署"的 CloudBase 最佳实践代码。
提示词:生成一个用户登录功能
- AI 自动生成符合云开发规范的代码
- 自动配置数据库、云函数、安全规则
- 一键部署到云端
2. 一键部署(One-Click Deploy)
AI 自动化的 MCP 部署流,AI 帮你搞定从云函数、数据库到静态网站的所有云上资源配置。
提示词:部署当前项目到云开发
- 自动检测项目类型(Web/小程序/后端)
- 智能配置部署参数
- 实时显示部署进度
- 自动返回访问链接
3. 智能调试(Smart Debugging)
部署出错?不用怕。AI 会自动读取日志,帮你分析并修复问题,真正实现开发-部署-调试的闭环。
提示词:报错了,错误是 xxxx
- AI 自动查看云函数日志
- 分析错误原因
- 生成修复代码
- 自动重新部署
4. 全栈支持(Full-Stack Ready)
无论是 Web 应用、小程序还是后端服务,AI 都能为你处理,你只需专注业务逻辑。
| 应用类型 | 技术栈 | 部署方式 |
|---|---|---|
| Web 应用 | React/Vue/Next.js | 静态托管 + CDN |
| 微信小程序 | 原生/UniApp | 小程序发布 |
| 后端服务 | Node.js/Python | 云函数/云托管 |
5. 知识检索(Knowledge Search)
内置云开发、微信小程序等专业知识库的智能向量检索,让 AI 更懂云开发。
提示词:如何使用云数据库实现实时数据同步?
- 智能检索云开发知识库
- 返回相关文档和最佳实践
- 提供代码示例
6. 灵活工作流(Flexible Workflow)
支持 /spec 和 /no_spec 命令,根据任务复杂度智能选择。
/spec - 完整工作流(需求→设计→任务→实现)
/no_spec - 快速迭代(直接实现)
📦 安装配置
前置条件
配置方式
方式一:CloudBase AI CLI(推荐)
# 安装
npm install @cloudbase/cli@latest -g
# 使用
tcb ai
方式二:手动配置 MCP
根据你使用的 AI IDE,添加 MCP 配置:
Cursor
在 .cursor/mcp.json 中添加:
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"]
}
}
}
WindSurf
在 .windsurf/settings.json 中添加:
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"]
}
}
}
CodeBuddy
CodeBuddy 已内置 CloudBase MCP,无需配置即可使用。
其他 IDE
查看 完整配置指南 了解其他 IDE 的配置方式。
🎯 使用案例
案例 1:双人在线对战五子棋
开发过程:
- 输入需求:"做个双人在线对战五子棋网站,支持联机对战"
- AI 生成:Web 应用 + 云数据库 + 实时数据推送
- 自动部署并获得访问链接
体验地址: 五子棋游戏
查看开发截图
| 开发过程 | 最终效果 |
|---|---|
![]() | ![]() |
案例 2:AI 宠物养成小程序
开发过程:
- 输入:"开发一个宠物小精灵养成小程序,使用 AI 增强互动"
- AI 生成:小程序 + 云数据库 + AI 云函数
- 导入微信开发者工具即可发布
查看开发截图与小程序预览

案例 3:智能问题诊断
当应用出现问题时,AI 自动查看日志、分析错误并生成修复代码。
查看智能诊断过程

🧩 MCP 工具
覆盖环境管理、数据库、云函数、静态托管、小程序发布等核心功能。
| 分类 | 工具 | 核心功能 |
|---|---|---|
| 环境 | 4 个 | 登录认证、环境查询、域名管理 |
| 数据库 | 11 个 | 集合管理、文档 CRUD、索引、数据模型 |
| 云函数 | 9 个 | 创建、更新、调用、日志、触发器 |
| 静态托管 | 5 个 | 文件上传、域名配置、网站部署 |
| 小程序 | 7 个 | 上传、预览、构建、配置、调试 |
| 工具支持 | 4 个 | 模板、知识库搜索、联网搜索、交互对话 |
📚 更多资源
文档
最新文章
❓ 常见问题
跟 Vercel / Railway / Netlify 有什么不同?
这些平台解决的是"部署",CloudBase MCP 解决的是"从 AI 生成代码到部署上线"的完整链路。你不需要离开 IDE,不需要写配置文件,AI 自动帮你搞定云函数、数据库、CDN、域名等所有云资源。一句话:它们是部署工具,我们是 AI 原生的全栈开发+部署平台。
不用 Cursor / Copilot 这些 AI IDE 也能用吗?
CloudBase MCP 基于标准 MCP 协议,支持所有兼容 MCP 的工具——包括 Claude Code、Gemini CLI、OpenCode 等命令行工具。只要你的工具能配置 MCP Server,就能用。查看完整支持列表。
我的代码会被上传到哪里?安全吗?
代码只会部署到你自己的腾讯云开发环境,不经过任何第三方。本地模式下 MCP 服务运行在你本机,代码不会离开你的电脑直到你主动部署。所有云端通信均走 HTTPS 加密。
支持哪些类型的项目?
几乎所有主流场景:React/Vue/Next.js 等 Web 应用、微信小程序、Node.js/Python/Go/Java 后端服务。AI 会自动检测项目类型并选择合适的部署策略(静态托管、云函数、云托管容器)。
免费吗?需要付费吗?
CloudBase MCP 工具本身完全开源免费(MIT)。云开发环境有免费额度,个人开发和小项目通常够用。超出免费额度后按量计费,详见 计费说明。
登录提示"环境不存在"怎么办?
- 确认已在 云开发控制台 开通环境
- 检查环境是否处于正常运行状态(非欠费/隔离)
- 重新执行"登录云开发"让 AI 引导选择正确的环境
💬 社区
微信交流群
扫码加入微信技术交流群
其他交流方式
| 平台 | 链接 | 说明 |
|---|---|---|
| 官方文档 | 查看文档 | 完整的云开发文档 |
| Issue 反馈 | 提交问题 | Bug 反馈和功能请求 |
项目活跃度
Contributors
感谢所有为 CloudBase MCP 做出贡献的开发者!

