cloudbase-ai-toolkit

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

将下面配置中的 <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>"
      }
    }
  }
}

方式三：自建服务器部署（Cloud Mode）

含义：在自有服务器上运行 MCP 服务，通过环境变量 CLOUDBASE_MCP_CLOUD_MODE=true 启用云端模式。 适用场景：需要在远程服务器上自行部署 MCP 服务端，对外提供 Streamable HTTP 接口。 安全机制：启用 Cloud Mode 后，所有涉及本地文件系统读写和本地进程启动的工具将自动禁用，确保远程调用方无法操作服务器本地资源。

# 启用云端模式的环境变量（二选一）
export CLOUDBASE_MCP_CLOUD_MODE=true
# 或
export MCP_CLOUD_MODE=true

Cloud Mode 下被禁用的工具包括：downloadRemoteFile、downloadTemplate、manageCloudRun（本地运行）、manageApps（本地代码上传部署）、manageStorage（本地文件上传/下载）、createFunction（本地代码上传）等涉及本地文件 I/O 的操作。

[!IMPORTANT] 部署模式选择建议：

• 个人开发：使用本地模式（npx），功能最全
• 团队协作 / 远程服务：使用腾讯云托管模式（方式二），免运维
• 自建服务器：务必设置 CLOUDBASE_MCP_CLOUD_MODE=true，禁用本地文件操作类工具

---

托管模式可选：通过 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 编程工具：

npm install @cloudbase/cli@latest -g

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

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

首次使用

1. 登录云开发

   登录云开发
   

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

2. 开始开发

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

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

支持的 AI IDE