CloudBase AI ToolKit

CloudBase AI Toolkit

AI 写代码，CloudBase 跑后端。

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

English · 简体中文 · Docs · Changelog · Issues

近期更新

v2.25.x（2026-08）

• Skills / RAG：为最小化 Web+数据库演示（无需云函数 CRUD）添加 minimal-web-baas-demo 到 searchKnowledgeBase 技能指南 (#886)
• CLI：修复云模式↔日志器循环依赖导致的 cloudbase-mcp --cloud-mode 崩溃 (#879)
• 权限：PG 环境可通过 managePermissions 设置云函数访问权限——当 ModifyResourcePermission 不受支持时回退到 OPA / tcb policy (modifyEnvAuthzConfig) (#865)
• CloudRun / Gateway：使用 TCP 数据库时的 VPC 指南；带 upstreamResourceType 和路径传输的 Domain/Route
• CloudRun / Gateway：重新部署时保留远程 VPC 和环境配置；部署后优先使用自定义域名访问 URL
• Plugin：通过 Open Plugin / 市场打包简化安装
• 环境 / 数据库：创建环境时更清晰的计费摘要；优先 SDK 优先指南而非原始 TCP 数据库信息
• 认证 / 数据库：修复 createApiKey 假成功；PG 迁移未落地时安全失败
• Gateway / Auth：查询和切换 HTTP 网关主开关和访问认证（getPrivilege / enableService / authSwitch）；短信登录通过默认渠道开箱即用
• PG 迁移：applyMigration 现在会填充远程迁移历史并轮询 DescribeTaskResult；优先本地迁移树和原生 manager-node API (#857, #859, #863, #864)

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。对于市场 IDE 使用本仓库——不要在同一工具上同时运行 npx plugins add。

快速开始

为你的工具选择一条默认路径。

Plugin

npx plugins add TencentCloudBase/cloudbase-plugin

详情和 IDE 差异：AI 插件文档。

仅 MCP

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

托管 HTTP、自托管云模式和插件作用域：安装与连接。

首次提示

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 应用需求和前端脚手架比较两条后端路径：传统云 VM（自管理运行时、进程和网络暴露）和 CloudBase（托管数据库、匿名认证和相关后端服务）。AI 代理执行了端到端的开发和验证。在给定的模型和任务设置下，CloudBase 路径在完成延迟、token 使用量和工具调用次数方面更优。这些结果取决于模型、代理框架和任务定义，不应推广到该范围之外。

方法、数据和限制：同任务评估：云 VM 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 连接模式

本地（默认）：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": "<Tencent Cloud Secret ID>",
        "X-TencentCloud-SecretKey": "<Tencent Cloud Secret Key>"
      }
    }
  }
}

托管 URL 可以使用 enable_plugins / disable_plugins。规范名称位于 mcp/src/server.ts。

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

示例

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

文档

• MCP 工具（tools.json）
• 入门
• IDE 设置
• AI 插件
• 模板
• FAQ

FAQ

社区

活动

贡献者

MIT · TencentCloudBase