CloudBase-AI-ToolKit

Recent updates

v2.32.x (2026-08)

• 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
• Skills: message-push / customer-service reference plus layered Chinese localization for miniprogram-development

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.

Pick one default path for your tool (Plugin / CLI / MCP)

Plugin

npx plugins add TencentCloudBase/cloudbase-plugin

Details and IDE differences: AI plugin docs.

MCP only

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

Hosted HTTP, self-hosted Cloud Mode, and plugin scoping: Install & connect.

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

Full setup: IDE guides.

Capabilities

After setup, the AI can do typical backend work in your environment (confirm critical steps):

• Database: PostgreSQL and document DB, data models, CRUD, permissions and security rules
• Compute: author, deploy, invoke, and debug cloud functions / Cloud Run
• Auth & storage: login methods, object storage, permission linkage with data
• Release & ops: static hosting / Mini Program publish; inspect logs and redeploy

Fits Web, WeChat Mini Programs, and backend services. Platform overview: CloudBase docs.

Evaluation

Under controlled conditions, the same Todo application brief and frontend scaffold were used to compare two backend paths: a traditional cloud VM (self-managed runtime, process, and network exposure) and CloudBase (managed database, anonymous auth, and related backend services). An AI agent performed end-to-end development and verification. Given the model and task setup, the CloudBase path was more favorable in completion latency, token usage, and tool-call count. These outcomes are conditioned on the model, agent framework, and task definition, and should not be generalized beyond that scope.

Methods, data, and limits: Same-task evaluation: cloud VM vs CloudBase

Install & connect

Prerequisites

• Node.js v18.15.0+
• A CloudBase environment
• An AI tool that supports Plugin / Skills / MCP

Setup options

1. Plugin (when the tool supports it)

`npx plugins add TencentCloudBase/cloudbase-plugin`

2. CloudBase AI CLI

`npm i -g @cloudbase/cli && tcb ai`

3. Manual MCP (write the IDE config file)

Cursor (.cursor/mcp.json)

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

WindSurf (.windsurf/settings.json)

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

CodeBuddy

CloudBase is built in (MCP / Skills); manual config is usually unnecessary.

You can also install via the plugin marketplace: see the CodeBuddy setup guide.

Others: IDE setup guide.

MCP connection modes

Local (default): `npx` on your machine—full features, including local filesystem upload/templates.

Hosted: IDE connects over HTTP to Tencent Cloud MCP; no local Node. Some local-file features are unavailable.

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

Hosted URLs can use `site` (`domestic` / `intl`) to pick the login site (e.g. domestic-site Singapore needs `site=domestic`), plus `enable_plugins` / `disable_plugins` to trim tools. Canonical names live in `mcp/src/server.ts`.

Self-hosted Cloud Mode: set `CLOUDBASE_MCP_CLOUD_MODE=true` (or `MCP_CLOUD_MODE=true`) so local file and process tools are disabled for remote callers.

Example

Online Gomoku: describe the need; get Web + cloud database / realtime and deploy.

Demo: Gomoku · More: tutorials

Docs

• MCP tools (tools.json)
• Getting started
• IDE setup
• AI plugins
• Templates
• FAQ

FAQ

How is this different from Vercel / Netlify?

Those focus on shipping frontends or containers. CloudBase provides backend building blocks (database, auth, functions). The Toolkit lets AI tools use them in chat. Deploy is only part of the path.

Can I use this without a GUI IDE?

Yes. Any tool that can configure an MCP Server or install the matching Plugin / Skills works—including Claude Code, Gemini CLI, OpenCode. Support list

Where does my code go?

Deploy targets your own CloudBase environment. In local mode MCP runs on your machine; code need not leave until you deploy. Cloud traffic uses HTTPS.

Is self-hosting the MCP server safe?

Local `npx` is equivalent to running tools yourself. For remote hosts, set `CLOUDBASE_MCP_CLOUD_MODE=true` to disable local file/process tools. Tencent Cloud hosted HTTP includes this protection.

Cost?

The Toolkit (including MCP) is open source under MIT. CloudBase has free quotas; usage beyond that is billed—see billing.

Login says environment does not exist?

Confirm an environment exists and is healthy in the console, then login again and pick the right one.

Domestic site env at `ap-singapore` is treated as international?

Both the domestic site (cloud.tencent.com) and the international site (tencentcloud.com) offer the `ap-singapore` region, so region alone is ambiguous. Without an explicit site, MCP defaults to `intl` for `ap-singapore` (backward compatible). Domestic-site Singapore users must set `TCB_SITE=domestic` (together with `TCB_REGION=ap-singapore`) in the MCP `env`, or add a `.cloudbase/project.json` at the project root:

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

Credentials are stored per site (`credential.domestic` / `credential.intl`) so domestic and international logins can coexist; legacy single-slot `auth.json` is read as `domestic` and migrated on first write.

Hosted mode: add `site=domestic` to the hosted URL (`https://tcb-api.cloud.tencent.com/mcp/v1?env_id=&site=domestic`), since the URL is the only place hosted mode can carry the site (there is no MCP `env` block for HTTP servers).

Community

Activity

Contributors

MIT · TencentCloudBase

[docs]: https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/

[changelog]: https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/releases

[github-issues-link]: https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/issues

[github-stars-link]: https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/stargazers

[github-forks-link]: https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/network/members

[npm-link]: https://www.npmjs.com/package/@cloudbase/cloudbase-mcp

[cnb-link]: https://cnb.cool/tencent/cloud/cloudbase/CloudBase-AI-Toolkit

[deepwiki-link]: https://deepwiki.com/TencentCloudBase/CloudBase-AI-Toolkit

[npm-version-shield]: https://img.shields.io/npm/v/@cloudbase/cloudbase-mcp?color=3B82F6&label=npm&logo=npm&style=flat-square

[npm-downloads-shield]: https://img.shields.io/npm/dw/@cloudbase/cloudbase-mcp?color=10B981&label=downloads&logo=npm&style=flat-square

[github-stars-shield]: https://img.shields.io/github/stars/TencentCloudBase/CloudBase-AI-Toolkit?color=F59E0B&label=stars&logo=github&style=flat-square

[github-forks-shield]: https://img.shields.io/github/forks/TencentCloudBase/CloudBase-AI-Toolkit?color=8B5CF6&label=forks&logo=github&style=flat-square

[github-issues-shield]: https://img.shields.io/github/issues/TencentCloudBase/CloudBase-AI-Toolkit?color=EC4899&label=issues&logo=github&style=flat-square

[github-license-shield]: https://img.shields.io/badge/license-MIT-6366F1?logo=github&style=flat-square

[github-contributors-shield]: https://img.shields.io/github/contributors/TencentCloudBase/CloudBase-AI-Toolkit?color=06B6D4&label=contributors&logo=github&style=flat-square

[cnb-shield]: https://img.shields.io/badge/CNB-CloudBase--AI--Toolkit-3B82F6?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHZpZXdCb3g9IjAgMCAxMiAxMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cmVjdCB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHJ4PSIyIiBmaWxsPSIjM0I4MkY2Ii8+PHBhdGggZD0iTTUgM0g3VjVINSIgc3Ryb2tlPSJ3aGl0ZSIgc3Ryb2tlLXdpZHRoPSIxLjUiLz48cGF0aCBkPSJNNSA3SDdWOUg1IiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjEuNSIvPjwvc3ZnPg==&style=flat-square

[deepwiki-shield]: https://deepwiki.com/badge.svg