CloudBase AI Toolkit

AI writes the code. CloudBase runs the backend.

The CloudBase integration layer for AI coding tools: Plugin installs the stack, Skills steer how code is written, MCP operates databases, functions, storage, and deploys from chat.

English · 简体中文 · [Docs][docs] · [Changelog][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]

Recent updates

v2.33.x (2026-09)

• Functions / Apps: custom container-image deploy for cloud functions with async status query; cloud upload channel (getUploadUrl + deployApp cosTimestamp)
• Env binding: cloudbaserc.json as field-level fallback for envId / region / site (literal + {{env.KEY}})
• Errors / Skills: centralized error guidance by structured Code; virtual-pay reference; CodeBuddy IDE MCP upgrade skill; WorkBuddy experts
• Cloud API / Deploy: callCloudApi opens monitor & postgres services; declarative deploy with deployPlan / deployApply; cloud-api-operations skill

v2.32.x (2026-08)

• Auth / Security / IDE: international-site (TCB_SITE=intl) login routing; default env-var masking in queryFunctions/queryCloudRun; Kimi Code & Kimi Work support
• Mini Program: queryMessagePush / manageMessagePush for event and message-type subscriptions (virtual-pay defaults, idempotent merge, optional appid)
• Mini Program: message push aware of cloudfunction vs container mode (ensureContainerMode / setContainerCallback, function-existence check)
• Gateway: manageGateway verifies HTTP service before custom-domain / route create, with certificate auto-select and clearer DNS guidance

v2.31.x (2026-08)

• CloudRun: getDeployLog failures (CODING login / image deploy with no build) now rewrite to getProcessLog / getDeployRecords next steps instead of raw English errors

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

What it is

AI IDEs (Cursor, Claude Code, Codex, CodeBuddy, and others) are strong at generating code. What usually blocks you is the backend: schemas, permissions, functions, storage, environments, and release.

CloudBase is Tencent Cloud’s AI-native all-in-one backend (database, storage, auth, cloud functions, Cloud Run, and more). This repo is the Toolkit that connects that backend to AI tools:

This repository ships the npm package @cloudbase/cloudbase-mcp, Skills, and AI plugins.

You still need your own CloudBase environment, and you should confirm sensitive actions the AI proposes. The Toolkit provides capability and path—not judgment.

Related repositories

Publishing and sync repos live under TencentCloudBase. Directly related to this Toolkit:

Prefer Plugin for the full stack; Skills alone when you only need knowledge constraints. For marketplace IDEs use this repo—do not also run npx plugins add on the same tool.

Quick start

Fastest way to get started

Copy this AI prompt into your AI IDE. The agent reads skill.md and completes the setup:

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

First prompts

Login to CloudBase

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

Skills shape structure and practice; MCP handles environment and resources. You should be able to verify data and APIs in your own environment—not only get local source files.

Supported AI IDEs