CloudBase MCP

CloudBase MCP

🪐 AI 编程，一键上线

连接 AI IDE 与腾讯云 CloudBase 的部署桥梁，让你的 AI 应用即刻上线

English · 简体中文 · 文档 · 更新日志 · 反馈问题

发现了一个让 AI 编程一键上线的神器，推荐给正在用 AI 编程的朋友

从 AI 提示词到应用上线的最短路径

为什么你需要 CloudBase MCP？

AI 编程工具（如 Cursor、CodeBuddy）解决了代码生成的难题。

但是，从"生成代码"到"应用上线"（部署、配置数据库、CDN、域名），依然存在一条鸿沟。

CloudBase MCP（原 CloudBase AI ToolKit）填补了这条鸿沟。

你不再需要：

• ❌ 繁琐的 DevOps 配置和 YAML 文件
• ❌ 手动设置云函数和数据库
• ❌ 在 IDE 和云控制台之间反复横跳

你只需要在 AI IDE 中，用自然语言完成从"想法"到"上线"的全过程。

目录

• 🚀 快速开始
• ✨ 核心特性
• 📦 安装配置
• 🎯 使用案例
• 🧩 MCP 工具
• 📚 更多资源

🚀 快速开始

一行配置，立即使用

在支持 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。
优点：不依赖本机环境，配置好密钥即可使用。
限制：部分依赖本地文件系统的能力不可用（如本地文件上传、模板下载到本机等）。

将下面配置中的 、、`` 替换为你的环境 ID 和腾讯云 API 密钥：

{
  "mcpServers": {
    "cloudbase": {
      "type": "http",
      "url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=",
      "headers": {
        "X-TencentCloud-SecretId": "",
        "X-TencentCloud-SecretKey": ""
      }
    }
  }
}

托管模式可选：通过 URL 控制启用哪些插件

在 url 里加上 query 参数可禁用指定插件，例如禁用 rag 和 env：

https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&disable_plugins=rag&disable_plugins=env

当前可配置的插件名：env, database, functions, hosting, storage, setup, interactive, rag, cloudrun, gateway, download, security-rule, invite-code, capi。

Tip:

推荐使用 CloudBase AI CLI

一键安装，自动配置，支持多种 AI 编程工具：

npm install @cloudbase/cli@latest -g

安装后运行 tcb ai 即可开始使用

查看完整文档 | 详细案例教程

首次使用

1. 登录云开发

   登录云开发
   

   AI 会自动打开登录界面并引导环境选择

2. 开始开发

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

   AI 会自动生成代码、部署到云端并返回访问链接

支持的 AI IDE

工具	支持平台	查看指引
CloudBase AI CLI	命令行工具	查看指引
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 - 快速迭代（直接实现）

📦 安装配置

前置条件

• ✅ Node.js v18.15.0 及以上版本
• ✅ 已开通 腾讯云开发环境
• ✅ 安装支持 MCP 的 AI IDE（查看支持的 IDE）

配置方式

方式一：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：双人在线对战五子棋

开发过程：

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

体验地址： 五子棋游戏

查看开发截图

开发过程	最终效果

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

开发过程：

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

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

案例 3：智能问题诊断

当应用出现问题时，AI 自动查看日志、分析错误并生成修复代码。

查看智能诊断过程

🧩 MCP 工具

覆盖环境管理、数据库、云函数、静态托管、小程序发布等核心功能。

分类	工具	核心功能
环境	4 个	登录认证、环境查询、域名管理
数据库	11 个	集合管理、文档 CRUD、索引、数据模型
云函数	9 个	创建、更新、调用、日志、触发器
静态托管	5 个	文件上传、域名配置、网站部署
小程序	7 个	上传、预览、构建、配置、调试
工具支持	4 个	模板、知识库搜索、联网搜索、交互对话

查看完整工具文档 | 工具规格 JSON

📚 更多资源

文档

• 快速开始
• IDE 配置指南
• 项目模板
• 开发指南
• 插件系统
• 常见问题

💬 社区

微信交流群

扫码加入微信技术交流群

其他交流方式

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

Star History

Contributors

感谢所有为 CloudBase MCP 做出贡献的开发者！

---

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

MIT © TencentCloudBase