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 · Changelog · Issues
Recent updates
v2.37.x (2026-11)
- Diagnostics: opaque backend errors become next-step guidance; function CLS failures carry RequestId and two parallel self-check paths; code updates say when Status is still running
- Safety / CloudRun: bulk deletes fail closed when the client cannot confirm; CloudRun target paths must stay inside the project and cannot point at host credential directories
- PostgreSQL: migrationVersion must be a real calendar timestamp; migrationDetail only needs a version; several false-positive path and SQL guards are relaxed
- Ecosystem: Codex plugin variant in Agent Plugins format; Qianwen skill-market packages; China-site WorkBuddy connector package
v2.36.x (2026-10)
- MCP Apps: three panels — environment, environment usage and deployment result — are on by default; set
CLOUDBASE_MCP_UI=off to hide them
- Safety: deletes, destructive SQL and the matching
callCloudApi delete actions pause for a confirmation that names the target; a credential-shaped argument gets one delta check (length plus a sha256 fingerprint, never the value itself)
- Environment: the usage panel gains a metrics view (QPS, invocations, errors, timeouts, MySQL and CloudRun load) with human names, and MySQL provisioning is retired from the tool surface
- Onboarding: every
initialize response carries instructions with the first read-only call to make; the remote setup docs now lead with OAuth
Releases · Star · 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:
| Piece | Role |
|---|
| Plugin | Installs MCP Server, Agent Skills, and Hooks together—less per-IDE wiring |
| Agent Skills | Scenario skills (Web / Mini Program / database / auth / functions, etc.) toward workable CloudBase practice |
| MCP | Login, query and change data, manage functions and hosting, read logs—from the conversation |
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:
| Repository | Contents | Typical entry |
|---|
| CloudBase-AI-Toolkit (this repo) | MCP Server source; marketplace source for Claude Code / Codex | npx @cloudbase/cloudbase-mcp@latest |
| dsh-plugin | DeepSeek Harness plugin (@cloudbase/dsh-plugin): MCP bridge + DB/Storage/Auth panel | dsh plugin add @cloudbase/dsh-plugin |
| cloudbase-plugin | Open Plugin Spec publish repo (CI-synced): MCP + Skills + Hooks | npx plugins add TencentCloudBase/cloudbase-plugin · CNB fallback: npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-plugin.git |
| cloudbase-sites-plugin | Sites plugin: Vite Web create & deploy | npx plugins add TencentCloudBase/cloudbase-sites-plugin · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-sites-plugin.git |
| cloudbase-skills | Agent Skills collection | npx skills add TencentCloudBase/cloudbase-skills · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills.git |
| skills | Per-skill install catalog (also on skills.sh) | npx skills add tencentcloudbase/skills --skill <name> |
| awesome-cloudbase-examples | CloudBase examples and case studies | Browse / clone examples |
| OpenVibeCoding | Vibecoding template on CloudBase | Use as a project starter |
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.
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
MCP connection modes
Remote (recommended): your IDE connects over HTTP to Tencent Cloud MCP. No local Node, and interactive clients finish authorization in the browser.
| Site | MCP endpoint |
|---|
| China (domestic) | https://tcb-api.cloud.tencent.com/mcp/v1 |
| International | https://tcb-api.tencentcloud.com/mcp/v1 |
Pick the endpoint matching the site your environment lives in—the two sites use separate accounts, consoles, and credentials.
OAuth (interactive, recommended): the URL is the whole configuration. Your IDE opens the browser for login and consent, and you pick the environment there—no keys in the config file, and nothing to rotate.
{
"mcpServers": {
"cloudbase": {
"type": "http",
"url": "https://tcb-api.cloud.tencent.com/mcp/v1"
}
}
}
Static credentials (for a client without OAuth, and for CI/CD): append env_id and a key pair created on the same site as the endpoint.
{
"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>"
}
}
}
}
A static key pair stays valid until it is rotated or deleted; an OAuth session ends when you log out. Use the static form only where the browser flow is impossible—and keep it out of a repository.
Local: runs npx @cloudbase/cloudbase-mcp@latest on your machine—full features, including local filesystem upload and template download.
Remote trade-off: local-filesystem features (upload, template download) are unavailable, and the international site does not yet expose NoSQL tools.
Remote URLs also accept site (domestic / intl, only needed for a China-site environment in ap-singapore, where the region is ambiguous), plus enable_plugins / disable_plugins to trim tools. Canonical names live in mcp/src/server.ts.
Remote MCP E2E (official SDK client): npm run test:hosted-mcp:e2e — see tests/hosted-mcp-e2e/README.md for apikey/OAuth modes, TLS-insecure staging, and env vars. Missing credentials skip (exit 0).
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.
| Scenario | Suggestion |
|---|
| Personal / fastest start | Remote URL (OAuth) |
| Need local file features | Local npx |
| CI / automation | Remote + static credentials |
| Self-hosted MCP | Cloud Mode required |
Example
Online Gomoku: describe the need; get Web + cloud database / realtime and deploy.
Demo: Gomoku · More: tutorials
Docs
FAQ
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.
Yes. Any tool that can configure an MCP Server or install the matching Plugin / Skills works—including Claude Code, Gemini CLI, OpenCode. Support list
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.
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 remote HTTP includes this protection.
The Toolkit (including MCP) is open source under MIT. CloudBase has free quotas; usage beyond that is billed—see billing.
Confirm an environment exists and is healthy in the console, then login again and pick the right one.
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.
Remote mode: nothing extra to pass — the endpoint host decides the site (tcb-api.cloud.tencent.com = China site, tcb-api.tencentcloud.com = international site), and there is no site query parameter. This also covers a China-site environment located in ap-singapore: keep using the China-site endpoint.
Community
Activity
Contributors
MIT · TencentCloudBase