GitHub - TencentCloudBase/CloudBase-AI-Toolkit

Backend for AI coding agents on CloudBase — database, auth, functions via Plugin, Skills & MCP. - Te

体验作品 ↗

CloudBase AI Toolkit

AI 写代码，CloudBase 管后端。

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

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

它是什么

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

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

组件	作用
Plugin	一次安装 MCP Server、Agent Skills 与 Hooks，减少按 IDE 分别配置
Agent Skills	场景化技能（Web / 小程序 / 数据库 / 认证 / 云函数等），约束可落地的 CloudBase 实践
MCP	在对话中登录环境、查改数据、管理函数与托管、读日志排障

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

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

仓库	内容	常用入口
CloudBase-AI-Toolkit（本仓库）	MCP Server 源码；Claude Code / Codex 等原生 marketplace 来源	`npx @cloudbase/cloudbase-mcp@latest`
cloudbase-plugin	Open Plugin Spec 发布仓（由本仓库 CI 同步）：MCP + Skills + Hooks	`npx plugins add TencentCloudBase/cloudbase-plugin`
cloudbase-sites-plugin	Sites 插件：Vite Web 创建与部署	`npx plugins add TencentCloudBase/cloudbase-sites-plugin`
cloudbase-skills	Agent Skills 合集	`npx skills add TencentCloudBase/cloudbase-skills`
skills	可按单个 skill 安装的目录（亦用于 skills.sh）	`npx skills add tencentcloudbase/skills --skill <name>`
awesome-cloudbase-examples	云开发案例与示例集合	浏览 / 克隆示例
OpenVibeCoding	基于 CloudBase 的 vibecoding 模板	作为项目起点使用

快速开始

最快上手（推荐）

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

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

按你的工具选一条默认路径（Plugin / CLI / MCP）

你的工具	建议做法
Claude Code / Codex（原生 marketplace）	添加本仓库为 marketplace，再安装 `cloudbase` 插件（见插件文档）
支持 Open Plugin Spec 的工具	`npx plugins add TencentCloudBase/cloudbase-plugin`
希望 CLI 统一配置多种工具	CloudBase AI CLI：`npm i -g @cloudbase/cli && tcb ai`
CodeBuddy / WorkBuddy / ZCode（已内置）	使用 IDE 内置的 CloudBase 插件或连接器；CodeBuddy 也可通过插件市场安装
其他支持 MCP 的 IDE	仅配置 MCP（见下方）

Plugin

npx plugins add TencentCloudBase/cloudbase-plugin

说明与各 IDE 差异见 AI 插件文档。

仅配置 MCP

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

托管 HTTP、自建 Cloud Mode、按插件裁剪工具集见安装与连接。

首次对话

登录云开发

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

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

支持的 AI IDE

工具	平台	指引
CloudBase AI CLI	CLI	指引
OpenClaw	CLI	指引
WorkBuddy	独立 IDE	指引
ZCode	独立 IDE（≥ 3.4.1 内置插件）	指引
Codex App	独立应用	指引
Cursor	独立 IDE	指引
WindSurf	独立 IDE / 插件	指引
CodeBuddy	独立 IDE（已内置）	指引
CLINE	VS Code 插件	指引
GitHub Copilot	VS Code 插件	指引
Trae	独立 IDE	指引
通义灵码	IDE / 插件	指引
RooCode	VS Code 插件	指引
文心快码	插件	指引
Augment Code	插件	指引
Claude Code	CLI	指引
Gemini CLI	CLI	指引
Codex CLI	CLI	指引
OpenCode	CLI	指引
Qwen Code	CLI	指引

完整配置见 IDE 配置指南。

能力

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

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

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

评测说明

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

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

安装与连接

前置条件

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

配置方式

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

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

已内置 CloudBase（含 MCP / Skills），一般无需再手写配置。

也可通过插件市场安装：见 CodeBuddy 配置指南。

其他 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 为准。

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

场景	建议
个人开发	本地 `npx`
团队 / 免运维	腾讯云托管 HTTP
自建 MCP 服务	必须开启 Cloud Mode

案例

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

文档

常见问题

和 Vercel / Netlify 这类部署平台有何不同？

它们侧重把前端或容器发布出去。CloudBase 提供数据库、认证、函数等后端能力；Toolkit 让 AI 工具在对话里使用这些能力。部署只是链路的一部分。

没有图形界面 IDE 也能用吗？

可以。凡能配置 MCP Server 或安装对应 Plugin / Skills 的工具均可，包括 Claude Code、Gemini CLI、OpenCode 等。支持列表

代码会到哪里？

部署目标是你自己的云开发环境。本地模式下 MCP 跑在本机；主动部署前代码不必离开本机。云端通信使用 HTTPS。

自建 MCP 服务是否安全？

本地 npx 等同于你在本机执行工具。远程部署务必设置 CLOUDBASE_MCP_CLOUD_MODE=true，以禁用本地文件与进程类工具。腾讯云托管 HTTP 模式已带该保护。

费用？

Toolkit（含 MCP）开源，MIT。云开发环境有免费额度；超出后按量计费，见计费说明。

登录提示环境不存在？

确认已在控制台开通且环境状态正常，然后再次「登录云开发」选择正确环境。

社区

_{微信技术交流群}


文档	docs.cloudbase.net
Issues	GitHub Issues
Releases	更新日志

项目活跃度

Repo Activity

Contributors

MIT · TencentCloudBase

登录后可在这里发帖，与作者讨论这个作品