![](scripts/assets/toolkit-better.gif)

CloudBase MCP

**🪐 AI 编程，一键上线**
连接 AI IDE 与腾讯云 CloudBase 的部署桥梁，让你的 AI 应用即刻上线 [English](./README-EN.md) · **简体中文** · [文档][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] [![MCP Badge](https://lobehub.com/badge/mcp/tencentcloudbase-cloudbase-ai-toolkit)](https://lobehub.com/mcp/tencentcloudbase-cloudbase-ai-toolkit) **发现了一个让 AI 编程一键上线的神器，推荐给正在用 AI 编程的朋友** [![][share-x-shield]][share-x-link] [![][share-telegram-shield]][share-telegram-link] [![][share-weibo-shield]][share-weibo-link] ^{从 AI 提示词到应用上线的最短路径} Clipboard_Screenshot_1764660604

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

](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-工具) - [📚 更多资源](#-更多资源)

## 🚀 快速开始 ### 一行配置，立即使用在支持 MCP 的 AI IDE 中（Cursor、WindSurf、CodeBuddy 等）添加下方任一配置即可。连接方式有两种： --- #### 方式一：本地模式（推荐） **含义**：MCP 服务在你本机通过 `npx` 启动，与 IDE 同机运行。 **优点**：功能最全（包含上传/下载、模板安装等依赖本地文件系统的能力）。 **要求**：本机已安装 Node.js，且能执行 `npx`。 ```json { "mcpServers": { "cloudbase": { "command": "npx", "args": ["@cloudbase/cloudbase-mcp@latest"] } } } ``` --- #### 方式二：托管模式 **含义**：MCP 服务运行在腾讯云上，IDE 通过 HTTP 连接云端服务，无需在本地安装或运行 Node。 **优点**：不依赖本机环境，配置好密钥即可使用。 **限制**：部分依赖本地文件系统的能力不可用（如本地文件上传、模板下载到本机等）。将下面配置中的 ``、`<腾讯云 Secret ID>`、`<腾讯云 Secret Key>` 替换为你的环境 ID 和腾讯云 API 密钥： ```json { "mcpServers": { "cloudbase": { "type": "http", "url": "https://tcb-api.cloud.tencent.com/mcp/v1?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 编程工具： > > ```bash > npm install @cloudbase/cli@latest -g > ``` > > 安装后运行 `tcb ai` 即可开始使用 > > [查看完整文档](https://docs.cloudbase.net/cli-v1/ai/introduce) | [详细案例教程](https://docs.cloudbase.net/practices/ai-cli-mini-program) ### 首次使用 1. **登录云开发** ``` 登录云开发 ``` AI 会自动打开登录界面并引导环境选择 2. **开始开发** ``` 做一个双人在线对战五子棋网站，支持联机对战，最后进行部署 ``` AI 会自动生成代码、部署到云端并返回访问链接 ### 支持的 AI IDE | 工具 | 支持平台 | 查看指引 | |------|----------|----------| | [CloudBase AI CLI](https://docs.cloudbase.net/cli-v1/ai/introduce) | 命令行工具 | [查看指引](https://docs.cloudbase.net/cli-v1/ai/introduce) | | [OpenClaw](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openclaw) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openclaw) | | [Cursor](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cursor) | 独立 IDE| [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cursor) | | [WindSurf](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/windsurf) | 独立 IDE, VSCode、JetBrains 插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/windsurf) | | [CodeBuddy](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/codebuddy) | 独立 IDE（已内置 CloudBase），VS Code、JetBrains、微信开发者工具| [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/codebuddy) | | [CLINE](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cline) | VS Code 插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cline) | | [GitHub Copilot](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/github-copilot) | VS Code 插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/github-copilot) | | [Trae](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/trae) | 独立 IDE | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/trae) | | [通义灵码](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/tongyi-lingma) | 独立 IDE，VS Code、 JetBrains插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/tongyi-lingma) | | [RooCode](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/roocode) | VS Code插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/roocode) | | [文心快码](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/baidu-comate) | VS Code、JetBrains插件| [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/baidu-comate) | | [Augment Code](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/augment-code) | VS Code、JetBrains 插件 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/augment-code) | | [Claude Code](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/claude-code) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/claude-code) | | [Gemini CLI](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/gemini-cli) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/gemini-cli) | | [OpenAI Codex CLI](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openai-codex-cli) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openai-codex-cli) | | [OpenCode](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/opencode) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/opencode) | | [Qwen Code](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/qwen-code) | 命令行工具 | [查看指引](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/qwen-code) | ## ✨ 如何实现 AI 编程"一键上线"？ ### 1. AI 原生（AI-Native）我们不是简单的"胶水代码"。内置的规则库专为 AI 编程设计，能让 AI 直接生成"可部署"的 CloudBase 最佳实践代码。 ```markdown 提示词：生成一个用户登录功能 - AI 自动生成符合云开发规范的代码 - 自动配置数据库、云函数、安全规则 - 一键部署到云端 ``` AI Native

### 2. 一键部署（One-Click Deploy） AI 自动化的 MCP 部署流，AI 帮你搞定从云函数、数据库到静态网站的**所有**云上资源配置。 ```markdown 提示词：部署当前项目到云开发 - 自动检测项目类型（Web/小程序/后端） - 智能配置部署参数 - 实时显示部署进度 - 自动返回访问链接 ``` One-Click Deploy

### 3. 智能调试（Smart Debugging）部署出错？不用怕。AI 会自动读取日志，帮你分析并修复问题，真正实现**开发-部署-调试**的闭环。 ```markdown 提示词：报错了，错误是 xxxx - AI 自动查看云函数日志 - 分析错误原因 - 生成修复代码 - 自动重新部署 ``` Smart Debugging

### 4. 全栈支持（Full-Stack Ready）无论是 Web 应用、小程序还是后端服务，AI 都能为你处理，你只需专注业务逻辑。 | 应用类型 | 技术栈 | 部署方式 | |---------|--------|---------| | **Web 应用** | React/Vue/Next.js | 静态托管 + CDN | | **微信小程序** | 原生/UniApp | 小程序发布 | | **后端服务** | Node.js/Python | 云函数/云托管 | Full-Stack Ready

### 5. 知识检索（Knowledge Search）内置云开发、微信小程序等专业知识库的智能向量检索，让 AI 更懂云开发。 ```markdown 提示词：如何使用云数据库实现实时数据同步？ - 智能检索云开发知识库 - 返回相关文档和最佳实践 - 提供代码示例 ```

### 6. 灵活工作流（Flexible Workflow）支持 /spec 和 /no_spec 命令，根据任务复杂度智能选择。 ```markdown /spec - 完整工作流（需求→设计→任务→实现） /no_spec - 快速迭代（直接实现） ```

## 📦 安装配置 ### 前置条件 - ✅ Node.js v18.15.0 及以上版本 - ✅ 已开通 [腾讯云开发环境](https://tcb.cloud.tencent.com/dev) - ✅ 安装支持 MCP 的 AI IDE（[查看支持的 IDE](#支持的-ai-ide)） ### 配置方式 #### 方式一：CloudBase AI CLI（推荐） ```bash # 安装 npm install @cloudbase/cli@latest -g # 使用 tcb ai ``` #### 方式二：手动配置 MCP 根据你使用的 AI IDE，添加 MCP 配置：

Cursor

在 `.cursor/mcp.json` 中添加： ```json { "mcpServers": { "cloudbase": { "command": "npx", "args": ["@cloudbase/cloudbase-mcp@latest"] } } } ```

WindSurf

在 `.windsurf/settings.json` 中添加： ```json { "mcpServers": { "cloudbase": { "command": "npx", "args": ["@cloudbase/cloudbase-mcp@latest"] } } } ```

CodeBuddy

CodeBuddy 已内置 CloudBase MCP，无需配置即可使用。

其他 IDE

查看 [完整配置指南](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/) 了解其他 IDE 的配置方式。

## 🎯 使用案例 ### 案例 1：双人在线对战五子棋 **开发过程：** 1. 输入需求："做个双人在线对战五子棋网站，支持联机对战" 2. AI 生成：Web 应用 + 云数据库 + 实时数据推送 3. 自动部署并获得访问链接 **体验地址：** [五子棋游戏](https://cloud1-5g39elugeec5ba0f-1300855855.tcloudbaseapp.com/gobang/#/)

查看开发截图

| 开发过程 | 最终效果 | |---------|---------| | ![][image-case1-dev] | ![][image-case1-result] |

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

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

![][image-case2]

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

查看智能诊断过程

![][image-case3]

## 🧩 MCP 工具覆盖环境管理、数据库、云函数、静态托管、小程序发布等核心功能。 | 分类 | 工具 | 核心功能 | |------|------|----------| | **环境** | 4 个 | 登录认证、环境查询、域名管理 | | **数据库** | 11 个 | 集合管理、文档 CRUD、索引、数据模型 | | **云函数** | 9 个 | 创建、更新、调用、日志、触发器 | | **静态托管** | 5 个 | 文件上传、域名配置、网站部署 | | **小程序** | 7 个 | 上传、预览、构建、配置、调试 | | **工具支持** | 4 个 | 模板、知识库搜索、联网搜索、交互对话 | [查看完整工具文档](doc/mcp-tools.md) | [工具规格 JSON](scripts/tools.json) ## 📚 更多资源 ### 文档 - [快速开始](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/getting-started) - [IDE 配置指南](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/) - [项目模板](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/templates) - [开发指南](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/development) - [插件系统](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/plugins) - [常见问题](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq) ## 💬 社区 ### 微信交流群

扫码加入微信技术交流群

### 其他交流方式 | 平台 | 链接 | 说明 | |------|------|------| | **官方文档** | [查看文档](https://docs.cloudbase.net/) | 完整的云开发文档 | | **Issue 反馈** | [提交问题](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues) | Bug 反馈和功能请求 | ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=TencentCloudBase/CloudBase-AI-ToolKit&type=Timeline)](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit) ## Contributors 感谢所有为 CloudBase MCP 做出贡献的开发者！ [![Contributors](https://contrib.rocks/image?repo=TencentCloudBase/CloudBase-AI-ToolKit)](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/graphs/contributors) ---

[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-AI-ToolKit/releases [github-issues-link]: https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues [github-stars-link]: https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/stargazers [github-forks-link]: https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/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-AI-ToolKit [deepwiki-link]: https://deepwiki.com/TencentCloudBase/CloudBase-AI-ToolKit [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-AI-ToolKit?color=F59E0B&label=stars&logo=github&style=flat-square [github-forks-shield]: https://img.shields.io/github/forks/TencentCloudBase/CloudBase-AI-ToolKit?color=8B5CF6&label=forks&logo=github&style=flat-square [github-issues-shield]: https://img.shields.io/github/issues/TencentCloudBase/CloudBase-AI-ToolKit?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-AI-ToolKit?color=06B6D4&label=contributors&logo=github&style=flat-square [github-contributors-link]: https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/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-AI-ToolKit?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-AI-ToolKit [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-AI-ToolKit&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-AI-ToolKit [share-weibo-shield]: https://img.shields.io/badge/-share%20on%20weibo-black?labelColor=black&logo=sinaweibo&logoColor=white&style=flat-square

Cloudbase Ai Toolkit

Install

Cloudbase Ai Toolkit

Install