CloudBase AI ToolKit

CloudBase AI Toolkit

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

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

English · 简体中文 · 文档 · 更新日志 · 问题反馈

近期更新

v2.25.x (2026-07)

• CloudRun / 网关：使用 TCP 数据库时的 VPC 指导；域名/路由支持 upstreamResourceType 和路径透传
• CloudRun / 网关：重新部署时保留远程 VPC 和环境配置；部署后优先使用自定义域名访问 URL
• 插件：通过 Open Plugin / 市场打包更便捷地安装

发布版本 · Star · Watch → Releases

这是什么

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

CloudBase 是腾讯云面向 AI 的原生一站式后端（数据库、存储、认证、云函数、Cloud Run 等）。本仓库是将此后端连接到 AI 工具的工具集：

此仓库提供 npm 包 @cloudbase/cloudbase-mcp、Skills 和 AI 插件。

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

相关仓库

发布和同步仓库位于 TencentCloudBase 下。与此工具集直接相关的有：

推荐使用插件获取完整技术栈；仅需要知识约束时单独使用 Skills。对于市场类 IDE，请使用此仓库——不要在同一工具上同时运行 npx plugins add。

快速开始

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

插件

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

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

评估

在受控条件下，使用相同的 Todo 应用简介和前端脚手架来比较两种后端路径：传统云虚拟机（自管理运行时、进程和网络暴露）和 CloudBase（托管数据库、匿名认证和相关后端服务）。AI 代理执行了端到端的开发和验证。鉴于模型和任务设置，CloudBase 路径在完成延迟、Token 使用量和工具调用次数方面更有利。这些结果受限于模型、代理框架和任务定义，不应泛化到该范围之外。

方法、数据和局限性：同任务评估：云虚拟机 vs CloudBase

安装与连接

前提条件

• Node.js v18.15.0+
• 一个 CloudBase 环境
• 一个支持 Plugin / Skills / MCP 的 AI 工具

设置选项

1. 插件（当工具支持时）
   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 插件
• 模板
• 常见问题

常见问题

社区

活动

贡献者

MIT · TencentCloudBase