CloudBase AI Toolkit

AI 写代码，CloudBase 管后端。

面向 AI 编程工具的 CloudBase 接入层：用 Plugin 装好工具，用 Skills 约束写法，用 MCP 在对话里操作数据库、云函数、存储与部署。

简体中文 · English · 文档 · 更新日志 · Issues

最近更新

v2.34.x（2026-09）

• 多语言 / IDE：工具文案全量国际化，新增实例级 lang 与 auth 的 site / region 参数，国际站登录与地域路由更准确
• 云 API：callCloudApi 服务白名单扩至 57 个并内置版本映射（tke / mongodb / vod 等多版本服务需显式传 version）
• 部署 / 环境：新增 appBuild 工具与托管构建中和；queryEnv 如实回执 region 生效情况，domains 尊重传入的 envId
• Skills / 文档：skill 兜底读取改指官方分发仓并返回 references 地址清单；cloudrun 增加 SDK-first 数据库访问决策闸门；官网文档链接改指站点当前 Markdown 寻址；专家包与部署 skill 在交付后可执行「部署分享」（脱敏、至多一次、可拒绝）
• 部署 / 应用：云端上传通道可完整跑通（deployApp 接受 getUploadUrl 返回的时间戳，getBuildLog 接受部署返回的构建 ID）；网关路由创建前会校验上游资源是否存在

v2.33.x（2026-09）

• 云函数 / 应用：支持自定义容器镜像部署与异步状态查询；云端上传通道（getUploadUrl + deployApp cosTimestamp）
• 环境绑定：cloudbaserc.json 可作为 envId / region / site 的字段级回退（字面量与 {{env.KEY}}）
• 错误引导 / Skills：按结构化 Code 集中引导；虚拟支付参考；CodeBuddy IDE MCP 升级 skill；WorkBuddy experts
• 云 API / 部署：callCloudApi 开放 monitor / postgres 服务；声明式部署 deployPlan / deployApply；新增 cloud-api-operations skill

Releases · Star · Watch → Releases

它是什么

AI IDE（Cursor、Claude Code、Codex、CodeBuddy 等）擅长生成代码。真正卡住的往往是后端：库表、权限、函数、存储、环境与发布。

CloudBase 是腾讯云的 AI 原生后端一体化平台（数据库、存储、身份认证、云函数、云托管等）。本仓库提供把这套后端接到 AI 工具里的 Toolkit：

本仓库同时发布 npm 包 @cloudbase/cloudbase-mcp、Skills 与 AI 插件。

你仍需要：开通自己的云开发环境，并在 IDE 中确认 AI 发起的敏感操作。Toolkit 提供能力与路径，不替代判断。

相关仓库

发布与同步仓集中在 TencentCloudBase 组织。与本 Toolkit 直接相关的如下：

优先用 Plugin 拿齐全套；只需知识约束时可只装 Skills。marketplace 类 IDE 请用本仓库，不要与 npx plugins add 对同一工具重复安装。

快速开始

最快上手（推荐）

复制下面的 AI Prompt，粘贴到你的 AI IDE。Agent 会读取 skill.md 完成接入：

帮我把 CloudBase 接好，按下面做：
1. 打开 https://docs.cloudbase.net/skill.md，按说明完成接入。
2. 接入完成后告诉我，并建议最相关的下一步。

npx plugins add TencentCloudBase/cloudbase-plugin

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

首次对话

登录云开发

使用 CloudBase Skills 开发一个带登录的待办应用，包含数据库与权限，并部署

Skills 负责写法与结构；MCP 负责环境与资源操作。完成后应能在自己的环境中验证数据与接口，而不只是得到一段本地代码。

支持的 AI IDE

完整配置见 IDE 配置指南。

能力

接入后，AI 可以在你的环境中完成典型后端工作（需你确认关键步骤）：

• 数据库：PostgreSQL 与文档型库、数据模型、CRUD、权限与安全规则
• 计算：云函数与云托管的编写、部署、调用与日志
• 身份与存储：登录方式、对象存储、与业务数据的权限联动
• 发布与排障：静态托管 / 小程序发布；根据日志定位问题并再部署

适用形态包括 Web、微信小程序与后端服务。平台能力总览见 CloudBase 文档。

评测说明

在受控条件下，以同一待办（Todo）应用需求与同一前端脚手架为输入，比较两类后端实现路径：传统云主机（自行搭建运行时、进程与网络暴露）与 CloudBase（托管数据库、匿名登录等后端能力）。评测由 AI Agent 端到端完成开发与验证；在给定模型与任务设定下，CloudBase 路径在完成时延、Token 用量与工具调用次数上更优。上述结果受模型、Agent 框架与任务定义约束，不宜外推为一般性结论。

方法、数据与边界条件见：传统云主机与 CloudBase 同任务评测报告

安装与连接

前置条件

• Node.js v18.15.0+
• 已开通 云开发环境
• 已安装支持 Plugin / Skills / MCP 的 AI 工具

配置方式

1. Plugin（推荐，能装插件时）
   npx plugins add TencentCloudBase/cloudbase-plugin
2. CloudBase AI CLI
   npm i -g @cloudbase/cli && tcb ai
3. 手动 MCP（按 IDE 写入配置文件）

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

其他 IDE：完整配置指南。

MCP 连接模式

本地模式（默认）：本机 npx 启动，功能最全（含依赖本地文件系统的上传、模板等）。

托管模式：IDE 通过 HTTP 连接腾讯云上的 MCP，无需本机 Node；部分本地文件能力不可用。

{
  "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 可用 site（domestic / intl）指定登录站点（国内站新加坡需 site=domestic），也可用 enable_plugins / disable_plugins 裁剪工具集。名称以 mcp/src/server.ts 为准。

云端 Hosted MCP E2E（官方 SDK 客户端）：npm run test:hosted-mcp:e2e，环境变量与双模式说明见 tests/hosted-mcp-e2e/README.md。缺凭证时相关用例 skip（退出码 0）。

自建 Cloud Mode：在自有服务器部署时设置 CLOUDBASE_MCP_CLOUD_MODE=true（或 MCP_CLOUD_MODE=true），禁用本地文件与本地进程类工具，避免远程调用方操作宿主机。

案例

双人在线五子棋：需求描述后生成 Web + 云数据库与实时能力并部署。
体验：五子棋 · 更多：教程与案例

文档

• MCP 工具说明（tools.json）
• 快速开始
• IDE 配置
• AI 插件
• 模板
• FAQ

常见问题

社区

_{微信技术交流群}

项目活跃度

Contributors

MIT · TencentCloudBase