CloudBase AI Toolkit

AI 写代码，CloudBase 管后端。

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

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

[][github-stars-link]

最近更新

v2.26.x（2026-08）

• 网关：支持启用/禁用 HTTP 路由（enableRoute / disableRoute）；托管与环境查询在返回访问地址前会识别默认域名路由已禁用的情况（#901、#902、#903）
• 认证：支持 CLOUDBASE_APIKEY 作为 API Key 环境变量回退（#900）
• Skills：首次会话 MCP 工具尚未加载时，提供 MCP→CLI 工具回退指引（#889）
• 模板 / CI：兼容 AGENTS 指南压缩至 40 KiB 内；加固 ClawHub 发布幂等与 upload-ticket 重试（#895、#893、#894）

v2.25.x（2026-08）

• Skills / RAG：minimal-web-baas-demo；云托管/网关 VPC 与自定义域名访问；PG 迁移加固等——完整列表见 Releases

Releases · [Star][github-stars-link] · 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 可用 enable_plugins / disable_plugins 裁剪工具集。名称以 mcp/src/server.ts 为准。

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

案例

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

文档

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

常见问题

社区

_{微信技术交流群}

项目活跃度

Contributors

MIT · TencentCloudBase