CloudBase AI Toolkit

AI 写代码，CloudBase 管后端。

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

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

最近更新

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 · 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. 手动 MCP（按 IDE 写入配置文件）

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

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

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

其他 IDE：完整配置指南。

MCP 连接模式

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

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

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

案例

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

文档

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

常见问题

社区

_{微信技术交流群}

项目活跃度

Contributors

MIT · TencentCloudBase