Cloudbase AI Toolkit


CloudBase MCP

🪐 AI 编程，一键上线

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

💡 像 Vercel + Supabase，但全程 AI 驱动——从提示词直达生产环境

English · 简体中文 · [文档][docs] · [更新日志][changelog] · [反馈问题][github-issues-link]

[![][npm-version-shield]][npm-link] [![][npm-downloads-shield]][npm-link] [![][github-stars-shield]][github-stars-link] [![][github-forks-shield]][github-forks-link] [![][github-issues-shield]][github-issues-link] ![][github-license-shield] ![][github-contributors-shield] [![][cnb-shield]][cnb-link] [![][deepwiki-shield]][deepwiki-link]

⭐ 喜欢这个项目？点个 Star，新版本发布时你会收到通知～

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

[![][share-x-shield]][share-x-link] [![][share-telegram-shield]][share-telegram-link] [![][share-weibo-shield]][share-weibo-link]

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

[![][github-trending-shield]](https://github.com/TencentCloudBase/CloudBase-MCP)

[](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/tutorials)

为什么你需要 CloudBase MCP？

AI 编程工具（如 OpenClaw、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 参数控制插件启用范围：

• enable_plugins：仅启用指定插件，多个插件使用逗号分隔，例如只启用 env 和 database
• disable_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 编程工具： ``bash npm install @cloudbase/cli@latest -g ` 安装后运行 tcb ai` 即可开始使用 查看完整文档 | 详细案例教程

首次使用

1. 登录云开发

   登录云开发

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

1. 开始开发

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

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

支持的 AI IDE

✨ 如何实现 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 都能为你处理，你只需专注业务逻辑。

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. 导入微信开发者工具即可发布

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

![][image-case2]

案例 3：智能问题诊断

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

查看智能诊断过程

![][image-case3]

🧩 MCP 工具

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

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

📚 更多资源

文档

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

最新文章

• 一个人就是一支团队：OpenClaw+CloudBase实现全自动开发上线
• Agent Skills实战分享：AI编程最后一公里，别让代码死在localhost里
• 查看更多视频与教程

❓ 常见问题

跟 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）。云开发环境有免费额度，个人开发和小项目通常够用。超出免费额度后按量计费，详见 计费说明。

登录提示"环境不存在"怎么办？

1. 确认已在 云开发控制台 开通环境
2. 检查环境是否处于正常运行状态（非欠费/隔离）
3. 重新执行"登录云开发"让 AI 引导选择正确的环境

💬 社区

微信交流群

扫码加入微信技术交流群

其他交流方式

项目活跃度

Contributors

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


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

[![][github-stars-shield]][github-stars-link]

MIT © TencentCloudBase

[image-overview]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/mcp/video-banner.png [image-ai-native]: https://via.placeholder.com/800x400/3B82F6/FFFFFF?text=AI+Native+Development [image-deploy]: https://via.placeholder.com/800x400/10B981/FFFFFF?text=One-Click+Deploy [image-fullstack]: https://via.placeholder.com/800x400/8B5CF6/FFFFFF?text=Full-Stack+Application [image-agent]: https://via.placeholder.com/800x400/EC4899/FFFFFF?text=AI+Agent+Development [image-debug]: https://via.placeholder.com/800x400/F59E0B/FFFFFF?text=Smart+Debugging [image-knowledge]: https://via.placeholder.com/800x400/06B6D4/FFFFFF?text=Knowledge+Search [image-workflow]: https://via.placeholder.com/800x400/6366F1/FFFFFF?text=Flexible+Workflow [image-case1-dev]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-001.png [image-case1-result]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-004.png [image-case2]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-005.png [image-case3]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-009.png

[docs]: https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ [changelog]: https://github.com/TencentCloudBase/CloudBase-MCP/releases [github-issues-link]: https://github.com/TencentCloudBase/CloudBase-MCP/issues [github-stars-link]: https://github.com/TencentCloudBase/CloudBase-MCP/stargazers [github-forks-link]: https://github.com/TencentCloudBase/CloudBase-MCP/network/members [github-trending-url]: https://github.com/trending [npm-link]: https://www.npmjs.com/package/@cloudbase/cloudbase-mcp [cnb-link]: https://cnb.cool/tencent/cloud/cloudbase/CloudBase-MCP [deepwiki-link]: https://deepwiki.com/TencentCloudBase/CloudBase-MCP

[npm-version-shield]: https://img.shields.io/npm/v/@cloudbase/cloudbase-mcp?color=3B82F6&label=npm&logo=npm&style=flat-square [npm-downloads-shield]: https://img.shields.io/npm/dw/@cloudbase/cloudbase-mcp?color=10B981&label=downloads&logo=npm&style=flat-square [github-stars-shield]: https://img.shields.io/github/stars/TencentCloudBase/CloudBase-MCP?color=F59E0B&label=stars&logo=github&style=flat-square [github-forks-shield]: https://img.shields.io/github/forks/TencentCloudBase/CloudBase-MCP?color=8B5CF6&label=forks&logo=github&style=flat-square [github-issues-shield]: https://img.shields.io/github/issues/TencentCloudBase/CloudBase-MCP?color=EC4899&label=issues&logo=github&style=flat-square [github-license-shield]: https://img.shields.io/badge/license-MIT-6366F1?logo=github&style=flat-square [github-contributors-shield]: https://img.shields.io/github/contributors/TencentCloudBase/CloudBase-MCP?color=06B6D4&label=contributors&logo=github&style=flat-square [github-contributors-link]: https://github.com/TencentCloudBase/CloudBase-MCP/graphs/contributors [cnb-shield]: https://img.shields.io/badge/CNB-CloudBase--AI--ToolKit-3B82F6?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHZpZXdCb3g9IjAgMCAxMiAxMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cmVjdCB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHJ4PSIyIiBmaWxsPSIjM0I4MkY2Ii8+PHBhdGggZD0iTTUgM0g3VjVINSIgc3Ryb2tlPSJ3aGl0ZSIgc3Ryb2tlLXdpZHRoPSIxLjUiLz48cGF0aCBkPSJNNSA3SDdWOUg1IiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjEuNSIvPjwvc3ZnPg==&style=flat-square [deepwiki-shield]: https://deepwiki.com/badge.svg [github-trending-shield]: https://img.shields.io/github/stars/TencentCloudBase/CloudBase-MCP?style=social

[share-x-link]: https://x.com/intent/tweet?hashtags=cloudbase,ai,devtools&text=AI%20编程%2C%20一键上线！告别繁琐的%20DevOps%20配置%2C%20从提示词到应用上线的最短路径%20🚀&url=https://github.com/TencentCloudBase/CloudBase-MCP [share-x-shield]: https://img.shields.io/badge/-share%20on%20x-black?labelColor=black&logo=x&logoColor=white&style=flat-square [share-telegram-shield]: https://img.shields.io/badge/-share%20on%20telegram-black?labelColor=black&logo=telegram&logoColor=white&style=flat-square [share-telegram-link]: https://t.me/share/url?url=https://github.com/TencentCloudBase/CloudBase-MCP&text=AI%20编程%2C%20一键上线！告别繁琐的%20DevOps%20配置%2C%20从提示词到应用上线的最短路径%20🚀 [share-weibo-link]: http://service.weibo.com/share/share.php?sharesource=weibo&title=AI%20编程%2C%20一键上线！告别繁琐的%20DevOps%20配置%2C%20从提示词到应用上线的最短路径%20🚀&url=https://github.com/TencentCloudBase/CloudBase-MCP [share-weibo-shield]: https://img.shields.io/badge/-share%20on%20weibo-black?labelColor=black&logo=sinaweibo&logoColor=white&style=flat-square