logo
36
28
WeChat Login

CloudBase MCP

🪐 AI Coding, One-Click Deploy
The bridge that connects your AI IDE to Tencent CloudBase, getting your AI apps online instantly
💡 Like Vercel + Supabase, but fully AI-driven — from prompt to production

简体中文 · English · Documentation · Changelog · Report Issues

⭐ Like this project? Star it to get notified when new versions are released!

Found a game-changer for AI coding: one-click deploy from prompt to production

The shortest path from AI prompt to live application

Clipboard_Screenshot_1763724670

Why You Need CloudBase MCP

AI coding tools (like OpenClaw, Cursor, CodeBuddy) solve the code generation challenge.

However, there's still a gap between "generating code" and "application going live" (deployment, database configuration, CDN, domain setup).

CloudBase MCP (formerly CloudBase AI ToolKit) bridges this gap.

You no longer need:

  • ❌ Complex DevOps configuration and YAML files
  • ❌ Manual setup of cloud functions and databases
  • ❌ Switching back and forth between IDE and cloud console

You only need to use natural language in your AI IDE to complete the entire journey from "idea" to "live".

Table of Contents

🚀 Quick Start

One-Line Configuration, Start Using Immediately

Add the following configuration to AI IDEs that support MCP (Cursor, WindSurf, CodeBuddy, etc.). There are two connection methods:


Method 1: Local Mode (Recommended)

Meaning: MCP service runs on your local machine via npx, running on the same machine as the IDE. Advantages: Full functionality (including upload/download, template installation, and other capabilities that depend on the local file system). Requirements: Node.js installed on the local machine, and can execute npx.

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

Method 2: Hosted Mode

Meaning: MCP service runs on Tencent Cloud, IDE connects to the cloud service via HTTP, no need to install or run Node locally. Advantages: Does not depend on the local machine environment, can be used after configuring the secret key. Limitations: Some capabilities that depend on the local file system are unavailable (such as local file upload, template download to local machine, etc.).

Replace <env_id>, <Tencent Cloud Secret ID>, <Tencent Cloud Secret Key> in the configuration below with your environment ID and Tencent Cloud API keys:

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

Optional for Hosted Mode: Control plugin enablement scope via URL

In the url, you can control the plugin enablement scope through query parameters:

  • enable_plugins: Only enable specified plugins, multiple plugins separated by commas, e.g., only enable env and database
  • disable_plugins: Disable specified plugins from the default plugin set, multiple plugins separated by commas, e.g., disable rag and env
# Only enable specified plugins https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&enable_plugins=env,database # Disable specified plugins https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&disable_plugins=rag,env

The currently configurable plugin names are subject to mcp/src/server.ts. It is recommended to use canonical names: env, database, functions, hosting, storage, setup, rag, download, gateway, cloudrun, app-auth, permissions, logs, agents, invite-code, capi, apps.

TIP

Recommended: CloudBase AI CLI

One-click installation, automatic configuration, supports multiple AI programming tools:

npm install @cloudbase/cli@latest -g

After installation, run tcb ai to start using

View complete documentation | Detailed case tutorial

First Time Use

  1. Login to CloudBase

    Login to CloudBase

    AI will automatically open the login interface and guide environment selection

  2. Start Developing

    Build a two-player online Gomoku game website, support online battle, and deploy it

    AI will automatically generate code, deploy to the cloud, and return the access link

Supported AI IDEs

ToolSupported PlatformGuide
CloudBase AI CLICLIGuide
CursorStandalone IDEGuide
WindSurfStandalone IDE, VSCode, JetBrains PluginGuide
CodeBuddyStandalone IDE (CloudBase built-in), VS Code, JetBrains, WeChat DevToolsGuide
CLINEVS Code PluginGuide
GitHub CopilotVS Code PluginGuide
TraeStandalone IDEGuide
Tongyi LingmaStandalone IDE, VS Code, JetBrains PluginGuide
RooCodeVS Code PluginGuide
Baidu ComateVS Code, JetBrains PluginGuide
Augment CodeVS Code, JetBrains PluginGuide
Claude CodeCLIGuide
Gemini CLICLIGuide
OpenAI Codex CLICLIGuide
OpenCodeCLIGuide
Qwen CodeCLIGuide

How to Achieve "One-Click Deploy" for AI Programming?

1. AI-Native

We're not just "glue code". Our built-in rule library is designed specifically for AI programming, enabling AI to directly generate "deployable" CloudBase best-practice code.

Prompt: Generate a user login feature - AI automatically generates code following CloudBase standards - Auto-configure database, cloud functions, security rules - One-click deploy to cloud
f1

2. One-Click Deploy

AI-automated MCP deployment flow, AI handles all cloud resource configuration from cloud functions, databases to static websites.

Prompt: Deploy current project to CloudBase - Auto-detect project type (Web/Mini-program/Backend) - Intelligent deployment parameter configuration - Real-time deployment progress display - Auto-return access link
f2

3. Smart Debugging

Deployment error? Don't worry. AI automatically reads logs, analyzes issues, and generates fixes, truly achieving a develop-deploy-debug closed loop.

Prompt: There's an error: xxxx - AI automatically views cloud function logs - Analyze error causes - Generate fix code - Auto redeploy
f5

4. Full-Stack Ready

Whether it's Web apps, mini-programs, or backend services, AI handles it all for you. You just focus on business logic.

Application TypeTech StackDeployment Method
Web AppsReact/Vue/Next.jsStatic Hosting + CDN
WeChat Mini-ProgramsNative/UniAppMini-program Publishing
Backend ServicesNode.js/PythonCloud Functions/Cloud Run
f3

5. Knowledge Search

Built-in intelligent vector search for CloudBase, WeChat Mini-Program and other professional knowledge bases, making AI understand CloudBase better.

Prompt: How to use cloud database to achieve real-time data synchronization? - Intelligent search CloudBase knowledge base - Return relevant documentation and best practices - Provide code examples
f6

6. Flexible Workflow

Support /spec and /no_spec commands, intelligently choose based on task complexity.

/spec - Complete workflow (Requirements → Design → Tasks → Implementation) /no_spec - Fast iteration (Direct implementation)
f7

Installation & Configuration

Prerequisites

Configuration Methods

Method 1: CloudBase AI CLI (Recommended)

# Install npm install @cloudbase/cli@latest -g # Use tcb ai

Method 2: Manual MCP Configuration

Add MCP configuration according to your AI IDE:

Cursor

Add to .cursor/mcp.json:

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

Add to .windsurf/settings.json:

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

CodeBuddy has CloudBase MCP built-in, no configuration needed.

Other IDEs

View Complete configuration guide for other IDE configuration methods.

Use Cases

Case 1: Two-Player Online Gomoku

Development Process:

  1. Input requirement: "Build a two-player online Gomoku website, support online battle"
  2. AI generates: Web app + cloud database + real-time data push
  3. Auto-deploy and get access link

Demo: Gomoku Game

View development screenshots
Development ProcessFinal Result

Case 2: AI Pet Mini-Program

Development Process:

  1. Input: "Develop a pet-raising mini-program with AI-enhanced interaction"
  2. AI generates: Mini-program + cloud database + AI cloud function
  3. Import to WeChat DevTools to publish
View development screenshots and mini-program preview

Case 3: Smart Issue Diagnosis

When an app has issues, AI automatically views logs, analyzes errors, and generates fix code.

View smart diagnosis process

MCP Tools

39 tools covering environment management, database, cloud functions, static hosting, mini-program publishing, and other core features.

CategoryToolsCore Features
Environment4Login authentication, environment query, domain management
Database11Collection management, document CRUD, indexes, data models
Cloud Functions9Create, update, invoke, logs, triggers
Static Hosting5File upload, domain configuration, website deployment
Mini-Program7Upload, preview, build, configuration, debugging
Tool Support3Templates, knowledge base search, web search

View complete tool documentation | Tool specification JSON

More Resources

Documentation

Tutorials

Articles

Videos

Project Cases

❓ FAQ

How is it different from Vercel / Railway / Netlify?

These platforms solve "deployment", CloudBase MCP solves the complete chain from "AI-generated code to deployment". You don't need to leave the IDE, don't need to write configuration files - AI automatically handles all cloud resources including cloud functions, databases, CDN, domains, etc. In one sentence: They are deployment tools, we are an AI-native full-stack development + deployment platform.

Can I use it without Cursor / Copilot or other AI IDEs?

CloudBase MCP is based on the standard MCP protocol, supporting all MCP-compatible tools - including Claude Code, Gemini CLI, OpenCode, and other CLI tools. As long as your tool can configure an MCP Server, you can use it. View complete support list.

Where will my code be uploaded? Is it secure?

Code will only be deployed to your own Tencent CloudBase environment, and won't pass through any third party. In local mode, MCP service runs on your local machine, code won't leave your computer until you actively deploy. All cloud communications use HTTPS encryption.

What types of projects are supported?

Almost all mainstream scenarios: Web apps like React/Vue/Next.js, WeChat Mini-Programs, Node.js/Python/Go/Java backend services. AI will automatically detect the project type and choose the appropriate deployment strategy (static hosting, cloud functions, cloud-run containers).

Is it free? Do I need to pay?

The CloudBase MCP tool itself is completely open-source and free (MIT). CloudBase environment has free quotas, usually sufficient for personal development and small projects. After exceeding the free quota, pay-as-you-go billing applies. See Billing Instructions for details.

What if login says "environment doesn't exist"?
  1. Confirm you've activated an environment in the CloudBase Console
  2. Check if the environment is in normal running status (not suspended/isolated due to unpaid fees)
  3. Re-execute "Login to CloudBase" to let AI guide you to select the correct environment

Community

WeChat Group

WeChat Group QR Code
Scan to join WeChat tech exchange group

Other Communication Channels

PlatformLinkDescription
Official DocumentationView DocumentationComplete CloudBase documentation
Issue FeedbackSubmit IssueBug reports and feature requests

Project Activity

Repo Activity

Contributors

Thanks to all the developers who have contributed to CloudBase MCP!

Contributors


If this project is helpful to you, please give us a Star!

MIT © TencentCloudBase

About

🪐 用 AI IDE 一键生成、部署和托管你的全栈 Web 应用与小程序、数据库和后端服务,无需运维,极速上线你的创意 💫

webaiserverlessmcppromptcursortencentminiprogramcloudbase
Language
TypeScript61.2%
JavaScript24.7%
HTML13.3%
CSS0.8%