article

README

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

将下面配置中的 <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 参数可禁用指定插件，例如禁用 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 即可开始使用

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

首次使用

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

开始开发

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

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

开发过程：

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

体验地址： 五子棋游戏

查看开发截图

| 开发过程 | 最终效果 | |---------|---------| | | |

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

开发过程：

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

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

案例 3：智能问题诊断

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

查看智能诊断过程

🧩 MCP 工具

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

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

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

📚 更多资源

文档

💬 社区

微信交流群

扫码加入微信技术交流群

其他交流方式

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

Star History

Contributors

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

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

云开发MCP