CloudBase AI ToolKit

CloudBase AI Toolkit

AI 编写代码，CloudBase 运行后端。

面向 AI 编码工具的 CloudBase 集成层：Plugin 安装技术栈，Skills 引导代码编写方式，MCP 操作数据库、函数、存储，并支持在对话中完成部署。

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

近期更新

v2.34.x（2026-09）

• i18n / IDE：完整的工具文案本地化，支持实例级 lang，以及 auth site / region 参数，确保国际站登录和区域路由正确解析
• Cloud API：callCloudApi 服务白名单扩展至 57 个，内置版本映射（多版本服务如 tke / mongodb / vod 需要显式指定 version）
• 部署 / 环境：新增 appBuild 工具，支持托管构建中和；queryEnv 报告实际生效的区域，domains 支持传入 envId
• Skills / 文档：skill 回退读取现在指向官方分发仓库并附带引用地址列表；cloudrun 采用 SDK 优先的数据库决策门；站点文档链接迁移至当前 Markdown 地址；专家包和部署 skills 在交付后提供部署后分享（可选、脱敏、最多一次）
• 部署 / 应用：云上传通道现已端到端打通（deployApp 接受 getUploadUrl 返回的时间戳，getBuildLog 接受部署返回的构建 ID），网关路由创建在写入前会验证上游是否存在
• Skills / 上下文：新增 PostgreSQL 访问模式最佳实践 skill（批处理、索引、RLS 角色门控、启动容量）；searchKnowledgeBase 的内联 skill / OpenAPI 目录现按需加载，每次 tools/list 将 43 个工具面缩减 9.1%
• 运行时 / 托管：CloudRun Function 模式不得绑定 PORT（函数框架会绑定），并增加命名 CLOUDBASE_APIKEY 的凭据决策门；托管路径和前缀已规范化，前导斜杠不再被读作空目录

v2.33.x（2026-09）

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

Releases · Star · Watch → Releases

这是什么

AI IDE（Cursor、Claude Code、Codex、CodeBuddy 等）擅长生成代码。通常阻碍你的是后端：schema、权限、函数、存储、环境和发布。

CloudBase 是腾讯云 AI 原生的一体化后端（数据库、存储、认证、云函数、Cloud Run 等）。本仓库是将该后端连接到 AI 工具的 Toolkit：

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

你仍然需要自己的 CloudBase 环境，并且应该确认 AI 提出的敏感操作。Toolkit 提供能力和路径——而非判断。

相关仓库

发布和同步仓库位于 TencentCloudBase 下。与本 Toolkit 直接相关的有：

完整技术栈优先使用 Plugin；只需要知识约束时单独使用 Skills。对于 marketplace IDE 请使用本仓库——不要在同一工具上同时运行 npx plugins add。

快速开始

最快的上手方式

将以下 AI 提示词复制到你的 AI IDE 中。Agent 会读取 skill.md 并完成设置：

Set up CloudBase for me:
1. Open https://docs.cloudbase.net/skill.md and complete the setup following its instructions.
2. Tell me when you're done, and suggest the most relevant next step.

npx plugins add TencentCloudBase/cloudbase-plugin

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

首批提示词

Login to CloudBase

Use CloudBase Skills to build a todo app with login, database and permissions, then deploy

Skills 塑造代码结构和实践；MCP 处理环境和资源。你应该能够在自己的环境中验证数据和 API——而不仅仅是获取本地源文件。

支持的 AI IDE

完整设置：IDE 指南。

能力

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

• 数据库：PostgreSQL 和文档数据库、数据模型、CRUD、权限和安全规则
• 计算：编写、部署、调用和调试云函数 / Cloud Run
• 认证与存储：登录方式、对象存储、与数据的权限联动
• 发布与运维：静态托管 / 小程序发布；查看日志并重新部署

适用于 Web、微信小程序和后端服务。平台概览：CloudBase 文档。

评测

在受控条件下，使用相同的 Todo 应用需求和前端脚手架，对比了两条后端路径：传统云虚拟机（自管理运行时、进程和网络暴露）和 CloudBase（托管数据库、匿名认证和相关后端服务）。AI Agent 执行了端到端的开发和验证。在给定的模型和任务设置下，CloudBase 路径在完成延迟、token 消耗和工具调用次数方面表现更优。这些结果受限于模型、Agent 框架和任务定义，不应推广到该范围之外。

方法、数据和限制：同任务评测：云虚拟机 vs CloudBase

安装与连接

前置条件

• Node.js v18.15.0+
• 一个 CloudBase 环境
• 支持 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 连接模式

远程（推荐）：你的 IDE 通过 HTTP 连接到腾讯云 MCP。无需本地 Node，交互式客户端在浏览器中完成授权。

选择与环境所在站点匹配的端点——两个站点使用独立的账号、控制台和凭据。

本地：在你的机器上运行 npx @cloudbase/cloudbase-mcp@latest——功能完整，包括本地文件系统上传和模板下载。

{
  "mcpServers": {
    "cloudbase": {
      "type": "http",
      "url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<env_id>",
      "headers": {
        "X-TencentCloud-SecretId": "<Tencent Cloud Secret ID>",
        "X-TencentCloud-SecretKey": "<Tencent Cloud Secret Key>"
      }
    }
  }
}

远程认证有两种方式：

• OAuth（交互式，推荐）：仅添加 URL。你的 IDE 会打开浏览器进行登录和授权——配置文件中无需密钥。
• 静态凭据（CI/CD）：添加上面的 env_id 和 X-TencentCloud-* 请求头。

远程模式的权衡：本地文件系统功能（上传、模板下载）不可用，且国际站暂未开放 NoSQL 工具。 远程 URL 也接受 site（domestic / intl，仅在 ap-singapore 的中国站点环境中需要，因为该地区存在歧义），以及 enable_plugins / disable_plugins 用于裁剪工具。规范名称位于 mcp/src/server.ts 中。

远程 MCP 端到端测试（官方 SDK 客户端）：npm run test:hosted-mcp:e2e — 参见 tests/hosted-mcp-e2e/README.md 了解 apikey/OAuth 模式、TLS 不安全暂存环境及环境变量。缺少凭据时跳过（退出码 0）。

自托管云模式：设置 CLOUDBASE_MCP_CLOUD_MODE=true（或 MCP_CLOUD_MODE=true），以便为远程调用者禁用本地文件和进程工具。

示例

在线五子棋：描述需求；获得 Web + 云数据库 / 实时能力并部署。
演示：五子棋 · 更多：教程

文档

• MCP 工具（tools.json）
• 快速开始
• IDE 配置
• AI 插件
• 模板
• 常见问题

常见问题

{ "site": "domestic", "region": "ap-singapore", "envId": "your-env-id" }

社区

活跃度

贡献者

MIT · TencentCloudBase