云开发后端工具包 TencentCloudBase/CloudBase-AI-Toolkit

CloudBase AI Toolkit

AI 写代码，CloudBase 管后端。

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

简体中文 · English · [文档][docs] · [更新日志][changelog] · [Issues][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]

最近更新

v2.36.x（2026-10）

- MCP Apps：三张面板（环境、环境用量、部署产物）默认开启，设 CLOUDBASE_MCP_UI=off 可以关掉
- 安全：删除类操作、破坏性 SQL 与对应的 callCloudApi 删除动作会先停下来确认并点名目标；参数里出现疑似密钥时只核对长度与 sha256 指纹，不回显明文
- 环境：用量面板新增指标视图（QPS、调用数、错误、超时、MySQL 与云托管负载），指标名一律用人话；工具面移除 MySQL 开通能力
- 上手引导：initialize 响应带 instructions，第一步就是只读调用；远程接入文档改为 OAuth 优先

v2.35.x（2026-10）

- 托管 / 认证：托管 MCP 每个请求使用独立 transport，客户端元数据按凭据隔离缓存；项目级凭据优先于账号级登录态
- 工具 / Skills：工具面移除 MySQL 开通能力；每个 skill 包在 SKILL.md 旁自带 LICENSE.md；新增 MCP 参考 skill，写明远程端点、插件开关与工具 schema
- 反馈：prepareFeedback 改为返回仓库的新建 issue 页面，不再自动拼错误报告；托管服务器默认启用的插件集与本地一致
- 上手引导 / 文档：initialize 响应现在带服务端 instructions（该先做的那个调用、首用顺序、可照抄的问法）；远程接入文档改为 OAuth 优先，只填地址即完成配置，密钥改为 CI 场景的写法

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）；网关路由创建前会校验上游资源是否存在
- Skills / 上下文：新增 PostgreSQL 访问模式最佳实践 skill（批量读写、索引、RLS 角色门禁、上线容量）；searchKnowledgeBase 内联的 skill / OpenAPI 清单改为按需返回，43 个工具的常驻面在每次 tools/list 时缩小 9.1%
- 运行态 / 托管：云托管 Function 模式不得监听 PORT（由函数框架绑定），并补上以 CLOUDBASE_APIKEY 为准的凭证决策门；静态托管的路径与前缀统一归一化，前导斜杠不再被误读成「目录为空」
- 连接器：新增国际站 WorkBuddy 连接器 cloudbase-intl，与国内 cloudbase 共用 config/source/** 内容源（远程 streamableHttp + 标准 MCP OAuth，取代本地 stdio），构建时把中国站域名改写为国际站

[Releases][changelog] · [Star][github-stars-link] · Watch → Releases

它是什么

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 提供能力与路径，不替代判断。

相关仓库

发布与同步仓集中在 TencentCloudBase 组织。与本 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 模板 | 作为项目起点使用 |

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

快速开始

最快上手（推荐）

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

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

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

| 你的工具 | 建议做法 |
| Claude Code / Codex（原生 marketplace） | 添加本仓库为 marketplace，再安装 cloudbase 插件（见插件文档） |
| 支持 Open Plugin Spec 的工具 | npx plugins add TencentCloudBase/cloudbase-plugin |
| CodeBuddy / WorkBuddy / 豆包 / MiniMax Code / DeepSeek Harness / ZCode / Kimi（已内置） | 使用 IDE 内置的 CloudBase 插件或连接器；CodeBuddy 也可通过插件市场安装 |
| 其他支持 MCP 的 IDE | 仅配置 MCP（见下方） |

已经在用 CloudBase CLI 的话，tcb ai 同样能配好 MCP 和 Skills（说明）。

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

| 工具 | 平台 | 指引 |
| OpenClaw | CLI | 指引 |
| WorkBuddy | 独立 IDE | 指引 |
| 豆包 | 桌面端 / 网页版（插件市场） | 指引 |
| MiniMax Code | 桌面端 / 终端 CLI（插件市场） | 指引 |
| DeepSeek Harness | 桌面应用（插件） | 指引 |
| ZCode | 独立 IDE（≥ 3.4.1 内置插件） | 指引 |
| Kimi Code | CLI（插件市场） | 指引 |
| Kimi Work | 桌面应用（插件面板） | 指引 |
| 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 工具

配置方式

1. Plugin（推荐，能装插件时） npx plugins add TencentCloudBase/cloudbase-plugin
2. 手动 MCP（按 IDE 写入配置文件）

已经在用 CloudBase CLI 的话，tcb ai 同样能配好 MCP 和 Skills（说明）。

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 连接模式

远端模式（推荐）：IDE 通过 HTTP 连接腾讯云上的 MCP，无需本机 Node；交互式客户端在浏览器里完成授权即可。

| 站点 | MCP 地址 |
| 国内站 | https://tcb-api.cloud.tencent.com/mcp/v1 |
| 国际站 | https://tcb-api.tencentcloud.com/mcp/v1 |

请选与环境所在站点匹配的地址 —— 两套站点的账号、控制台与凭证互相独立。

OAuth（交互式，推荐）：只填地址就是全部配置。IDE 会打开浏览器完成登录与授权，环境也在那里选 —— 配置文件里不放密钥，也没有需要轮换的东西。

{
"mcpServers": {
"cloudbase": {
"type": "http",
"url": "https://tcb-api.cloud.tencent.com/mcp/v1"
}
}
}

静态凭证（不支持 OAuth 的客户端，以及 CI/CD）：补上 env_id 与同一站点的密钥对。

{
"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>" } } } }

静态密钥不轮换、不删除就一直有效；OAuth 会话则可以靠退出登录结束。只在浏览器授权走不通的场景才用静态凭证，并且不要把它提交进仓库。

本地模式：本机 npx @cloudbase/cloudbase-mcp@latest 启动，功能最全（含依赖本地文件系统的上传、模板等）。

远端的取舍：依赖本地文件系统的能力（上传、模板下载）不可用；国际站暂未提供 NoSQL（文档数据库）工具。

远端 URL 支持 env_id、enable_plugins、disable_plugins、use_internal_endpoint 四个参数；没有 site——站点由域名决定，国内站环境落在 ap-singapore 也一样。插件名称以 mcp/src/server.ts 为准。

云端 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），禁用本地文件与本地进程类工具，避免远程调用方操作宿主机。

| 场景 | 建议 |
| 个人开发 / 最快上手 | 远端 URL（OAuth） |
| 需要本地文件能力 | 本地 npx |
| CI / 自动化 | 远端 + 静态凭证 |
| 自建 MCP 服务 | 必须开启 Cloud Mode |

案例

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

文档

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

常见问题

和 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 | [更新日志][changelog] |

项目活跃度

Contributors

Contributors

MIT · TencentCloudBase

[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
[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
[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