logo
0
0
WeChat Login
Forkfromtencent/cloud/cloudbase/CloudBase-AI-ToolKit, behindmain769 commits

🌟 CloudBase AI ToolKit

Smarter, faster development with AI prompts, MCP protocol, and CloudBase.

🌍 Languages: 中文 | English

License: MIT npm version NPM Downloads GitHub stars GitHub forks

GitHub issues GitHub pull requests GitHub last commit GitHub contributors

Turn your ideas into deployable full-stack applications with just a prompt. Works seamlessly with Cursor, VSCode GitHub Copilot, WindSurf, CodeBuddy and other AI IDEs, automatically generating and deploying web apps, mini-programs, and backend services to Tencent CloudBase.

CloudBase AI Tookit - Prompt to Production: Full-stack, DB & functions—zero setup. | Product Hunt

🚀 Three Core Capabilities

🤖 AI-Powered Development: AI auto-generates code and architecture
☁️ Cloud Integration: One-click access to database, cloud functions, static hosting
⚡ Rapid Deployment: Full-stack apps online in minutes

🛠️ Supported Platforms

Web Apps: Modern frontend + static hosting
WeChat Mini-Programs: Cloud-native mini-program solutions
Backend Services: Cloud database + serverless functions + cloud hosting

Full Video Demo

https://github.com/user-attachments/assets/2b402fa6-c5c4-495a-b85b-f5d4a25daa4a

✨ Key Features

FeatureDescriptionAdvantage
🤖 AI-NativeRule library designed for AI programming toolsCode follows CloudBase best practices
🚀 One-Click DeployMCP automated deployment to Tencent CloudBaseServerless, no server management
📱 Full-Stack SupportWeb + Mini-programs + Database + BackendSupports various app types, backend hosting, and database
🔧 Smart DebuggingAI reviews logs and fixes issuesLower ops cost
⚡ Lightning FastChina CDN accelerationFaster than overseas platforms
📚 Smart Knowledge BaseBuilt-in vector search for CloudBase, WeChat Mini-Program docs

🚀 Quick Start

0. Prerequisites

Install AI Development Tools

Such as Cursor | WindSurf | CodeBuddy etc.

Set Up CloudBase Environment and Get Environment ID

  1. Visit Tencent CloudBase Console to create an environment. New users can start for free.
  2. Get your Environment ID from the "Overview" page in the console (needed for deployment)

1. Initialize or Enhance Your Project

We provide templates with CloudBase best practices and AI IDE rules. Two recommended ways:

🚀 For New Projects

Choose a template and initialize with one click:

🛠️ Enhance Existing Projects

If you already have a project, after configuring MCP, just tell the AI "Download CloudBase AI rules in the current project" to instantly add and configure AI editor rules in your project directory—no manual steps needed.

2. Configure Your AI IDE

💡 Tip: If you enable auto-run in tools like Cursor, add sensitive commands to the "Command denylist" to avoid accidental execution (e.g., data deletion). By default, manual confirmation is required for safety.

Supported tools:

ToolPlatform
CursorStandalone IDE
WindSurfStandalone IDE, VSCode, JetBrains plugin
CodeBuddyVS Code, JetBrains, WeChat DevTools plugin
CLINEVS Code plugin
GitHub CopilotVS Code plugin
TraeStandalone IDE
Tongyi LingmaStandalone IDE, VS Code, JetBrains plugin
RooCodeVS Code plugin
Baidu ComateVS Code, JetBrains plugin

Follow the configuration guide for your tool below. Each tool requires your CloudBase environment ID for MCP features. If you don't have an environment, create one first.

🔧 Cursor Configuration

Step 1: Auto-Apply AI Rules

Templates include .cursor/rules/ directory, AI will auto-detect CloudBase best practices.

Step 2: Configure MCP

Templates include MCP config. If not using a template, click below to install in Cursor:

Install MCP Server

  1. Edit .cursor/mcp.json in your project, set your CloudBase environment ID:
{ "mcpServers": { "cloudbase-mcp": { "command": "npx", "args": ["-y", "@cloudbase/cloudbase-mcp@latest"], "env": { "CLOUDBASE_ENV_ID": "your-cloudbase-env-id" } } } }
  1. Enable CloudBase MCP Server

Click the ⚙️ icon in Cursor, go to "MCP", find cloudbase and enable it.

Step 3: Switch to Agent Mode

Use Agent mode in chat for code generation and automation.

🌊 Codeium/WindSurf Configuration

Step 1: Auto-Apply AI Rules

Templates include .windsurf/ directory with WindSurf-optimized configurations.

Step 2: Configure MCP

Click WindSurf's Plugins icon, click "View raw config", add cloudbase-mcp and set environment ID

{ "mcpServers": { "cloudbase-mcp": { "command": "npx", "args": ["-y", "@cloudbase/cloudbase-mcp@latest"], "env": { "CLOUDBASE_ENV_ID": "your-cloudbase-env-id" } } } }

Step 3: Switch to Write Mode

Switch to Write mode in chat for intelligent generation.

👥 CodeBuddy Configuration

Step 1: Auto-Apply AI Rules

Templates include .rules/ directory, CodeBuddy will automatically recognize CloudBase best practices.

Step 2: Configure MCP

Click the MCP icon in the top-right corner of CodeBuddy, then click the + button to modify MCP configuration.

Set CLOUDBASE_ENV_ID to your CloudBase environment ID

{ "mcpServers": { "cloudbase-mcp": { "command": "npx", "args": ["-y", "@cloudbase/cloudbase-mcp@latest"], "env": { "CLOUDBASE_ENV_ID": "your-cloudbase-env-id" } } } }

Step 3: Switch to Craft Agent

Switch to Craft mode in the chat window for intelligent project generation.

Note: In CodeBuddy's Craft mode, disable the confirmation plan feature in the right-side settings for better tool execution.

🤖 CLINE Configuration

Step 1: Auto-Apply AI Rules

Templates include .clinerules/ directory, AI will automatically recognize CloudBase best practices.

Step 2: Configure MCP

Find the MCP Server icon in Cline's panel, click the ⚙️ settings icon, then click Configure MCP Servers

Add the following content, replace CLOUDBASE_ENV_ID with your CloudBase environment ID

{ "mcpServers": { "cloudbase": { "autoApprove": [], "timeout": 60, "command": "npx", "args": [ "@cloudbase/cloudbase-mcp@latest" ], "env": { "CLOUDBASE_ENV_ID": "your-cloudbase-env-id" }, "transportType": "stdio", "disabled": false } } }

Step 3: Use AI Chat

Return to the chat interface, recommend using models with good code generation capabilities and function call support.

🐙 GitHub Copilot Configuration

Step 1: Auto-Apply AI Rules

Templates include .github/ directory with Copilot-optimized configurations.

Step 2: Enable CloudBase MCP

Templates include .vscode/mcp.json with CloudBase MCP configuration

Modify the environment ID to your CloudBase environment ID

{ "servers": { "cloudbase": { "command": "npx", "args": [ "@cloudbase/cloudbase-mcp@latest" ], "env": { "CLOUDBASE_ENV_ID": "your-cloudbase-env-id" } } } }

Step 3: Switch to Agent Mode

Switch to Agent mode in the bottom-left corner of the chat window.

🎯 Trae Configuration

This guide supports both Trae International and Trae CN versions. Recommend using Claude/DeepSeek V3 0324 models for testing.

Step 1: Auto-Apply AI Rules

Templates include .trae/rules directory with Trae-specific CloudBase rule configurations that AI will auto-apply.

Step 2: Enable CloudBase MCP

Click the ⚙️ settings icon in Trae's top-right corner, enter MCP, click manual configuration in settings, and paste the following:

Replace CLOUDBASE_ENV_ID with your CloudBase environment ID

{ "mcpServers": { "cloudbase-mcp": { "command": "npx", "args": ["-y", "@cloudbase/cloudbase-mcp@latest"], "env": { "CLOUDBASE_ENV_ID": "your-cloudbase-env-id" } } } }

Step 3: Use Builder with MCP

Return to chat window, select Builder with MCP in agents.

🧩 Tongyi Lingma Configuration

Step 1: Auto-Apply AI Rules

Templates include .lingma/ directory, Tongyi Lingma will automatically recognize CloudBase best practices.

Step 2: Configure MCP

Click your avatar in Tongyi Lingma's top-right corner, select personal settings, enter MCP settings.

Click the open configuration file button on the right, modify MCP configuration in the opened file.

Set CLOUDBASE_ENV_ID to your CloudBase environment ID

{ "mcpServers": { "cloudbase-mcp": { "command": "npx", "args": ["-y", "@cloudbase/cloudbase-mcp@latest"], "env": { "CLOUDBASE_ENV_ID": "your-cloudbase-env-id" } } } }

Step 3: Switch to Agent Mode

Switch to agent mode in the bottom-left corner of the chat window.

3. Start Developing

Make sure AI is connected to CloudBase:

Query current CloudBase environment info

Describe your needs to the AI, e.g.:

Build a two-player online Gomoku game, support online battle, then deploy

AI will automatically:

  • 📝 Generate frontend & backend code
  • 🚀 Deploy to CloudBase
  • 🔗 Return online access link

If you encounter errors, send the error message to AI for troubleshooting:

Error: xxxx

You can also ask AI to debug and modify code using cloud function logs:

Cloud function code doesn't meet requirements: xxx. Please check logs and data, debug and fix.

🎯 Use Cases

Case 1: Two-Player Online Gomoku

Process:

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

👉 Try it: Gomoku Game

📸 See development screenshots
DevelopmentFinal Result
Dev Screenshot 1Gomoku Result
Dev Screenshot 2Supports two-player online battle
Real-time board sync

Case 2: AI Pet Mini-Program

Process:

  1. Input: "Build a pet-raising mini-program, use AI for enhanced interaction"
  2. AI generates: Mini-program + cloud database + AI cloud function
  3. Import to WeChat DevTools to publish
📸 See dev screenshots & preview
🖥️ Dev Screenshots
AI Pet Mini-Program Dev Screenshot
Mini-Program Dev Process
📱 Mini-Program Preview
Mini-Program UI 1 Mini-Program UI 2

📲 Experience QR Code
Mini-Program QR Code

Case 3: Smart Issue Diagnosis

When issues occur:

  1. AI checks cloud function logs
  2. Analyzes errors and generates fix code
  3. Auto-redeploys
📸 See smart diagnosis process
Smart Diagnosis Process
AI auto-analyzes logs and generates fixes

🌟 Why Choose CloudBase?

  • ⚡ Fast Deployment: China nodes, faster than overseas
  • 🛡️ Reliable: Trusted by 3.3M+ developers
  • 🔧 Dev-Friendly: Full-stack platform for the AI era
  • 💰 Cost-Effective: Serverless, free for new users during development

📋 FAQ

For migration, integration, and more, see FAQ.

💬 Community

Need help or want to connect? Join our tech community!

🔥 WeChat Group

WeChat Group QR
Scan to join the WeChat tech group

In the group you can:

  • 💡 Share your AI + CloudBase projects
  • 🤝 Tech exchange and Q&A
  • 📢 Get latest updates and best practices
  • 🎯 Join product discussions and suggestions

📱 Other Channels

PlatformLinkDescription
Docs📖 DocsFull CloudBase docs
Issue🐛 Submit IssueBug reports & feature requests

🎉 Community Events

  • Weekly Tech Sharing: Best practices for AI + CloudBase
  • Project Showcases: Share your AI-powered projects
  • Q&A: Tencent CloudBase team online support
  • Feature Previews: Try new features first

🛠️ CloudBase MCP Tools Overview

ToolDescription
logoutLog out current CloudBase account
downloadTemplateDownload CloudBase project templates (React, Mini-Program, AI editor config, etc.)
listEnvsGet all CloudBase environments
getEnvAuthDomainsGet valid domain list for environment
createEnvDomainAdd safe domain to environment
deleteEnvDomainRemove domain from environment
getEnvInfoGet current environment info
updateEnvInfoUpdate environment alias
createCollectionCreate new DB collection
checkCollectionExistsCheck if DB collection exists
updateCollectionUpdate DB collection config (create/delete index)
describeCollectionGet DB collection details
listCollectionsList DB collections
checkIndexExistsCheck if index exists
distributionQuery data distribution in collection
insertDocumentsInsert docs into collection
queryDocumentsQuery docs in collection
updateDocumentsUpdate docs in collection
deleteDocumentsDelete docs in collection
uploadFilesUpload files to static hosting
listFilesList static hosting files
deleteFilesDelete static hosting files/folders
findFilesSearch static hosting files
createHostingDomainBind custom domain
deleteHostingDomainUnbind custom domain
getWebsiteConfigGet static website config
tcbCheckResourceGet domain config
tcbModifyAttributeModify domain config
getFunctionListGet cloud function list
createFunctionCreate cloud function
updateFunctionCodeUpdate cloud function code
updateFunctionConfigUpdate cloud function config
getFunctionDetailGet cloud function details
invokeFunctionInvoke cloud function
getFunctionLogsGet cloud function logs
createFunctionTriggersCreate function trigger
deleteFunctionTriggerDelete function trigger
downloadRemoteFileDownload remote file to local temp
uploadFileUpload file to cloud storage (for business data)
searchKnowledgeBaseSmart search for CloudBase knowledge base (vector search for docs/answers)

🏗️ Architecture

🤝 Contributing

PRs and issues welcome! See our Contributing Guide for how to get involved.

📄 License

MIT © TencentCloudBase


⭐ If you find this project helpful, please give us a Star!

About

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