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

🌟 CloudBase AI ToolKit

🪐 Instantly generate, deploy, and host your full-stack Web apps, mini-programs, databases, and backend services with AI IDE—no DevOps required, launch your ideas at lightning speed 💫

🌍 Languages: 中文 | English

License: MIT npm version NPM Downloads GitHub stars GitHub forks

GitHub issues GitHub pull requests GitHub last commit GitHub contributors CNB Mirror Ask DeepWiki

When coding in Cursor/VSCode GitHub Copilot/WinSurf/CodeBuddy/Augment Code/Claude Code/OpenAI Codex CLI and other AI programming tools, it automatically helps you generate deployable full-stack apps + mini-programs, and publish them to Tencent CloudBase with one click.

📹 Full Video Demo ⬇️

Video Demo
🚀 Core Capabilities🛠️ Supported Platforms
🤖 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
Web Apps: Modern frontend + static hosting
WeChat Mini-Programs: Cloud-native mini-program solutions
Backend Services: Cloud database + serverless functions + cloud hosting

📚 Quick Start | 🛠️ IDE Setup | 🎨 Project Templates | 📖 Development Guide | 🎮 Use Cases | 🎓 Tutorials | 🔌 Plugin System | 🔧 MCP Tools | ❓ FAQ

✨ Key Features

  • 🤖 AI-Native - Rule library designed for AI programming tools, generates code following CloudBase best practices
  • 🚀 One-Click Deploy - MCP automated deployment to Tencent CloudBase platform, Serverless architecture without server management
  • 📱 Full-Stack Apps - Web + Mini-programs + Database + Backend integration, supports multiple app types and backend hosting
  • 🔧 Smart Debugging - AI automatically reviews logs and fixes issues, reducing operational costs
  • ⚡ Lightning Fast - Domestic CDN acceleration, faster access than overseas platforms
  • 📚 Knowledge Retrieval - Built-in intelligent vector search for CloudBase and WeChat Mini-Program professional knowledge bases

TIP

🚩 Built-in Spec Workflow: Make AI programming more engineering-oriented

  • Built-in Kiro-style Spec workflow, supports Cursor, Claude Code, and other mainstream AI IDEs
  • Clear requirements, design, and tasks, auto-generates requirements.md, design.md, tasks.md
  • Move beyond "slot machine" vibe coding, development process is controllable and traceable
  • Let AI assist in sorting out requirements, design solutions, and task breakdowns, while humans focus on decision-making and review

🚩 Get Started with CloudBase AI ToolKit

  1. Enable CloudBase Tools (MCP Config)
    Add the following config to your AI IDE (e.g., Cursor) to enable all CloudBase AI ToolKit capabilities:
{ "mcpServers": { "cloudbase-mcp": { "command": "npx", "args": ["@cloudbase/cloudbase-mcp@latest"] } } }
  1. One-Click Project Template Generation
    In the AI chat box, enter:
Download mini-program cloud development template
  1. Available Template Types
  • Mini-program cloud development template
  • React cloud development template
  • Vue cloud development template
  • UniApp cloud development template
  • Universal cloud development template

👉 View all official templates and docs

  1. Detailed Tutorial
    👉 View full configuration and usage tutorial

🚀 Quick Start

0. Prerequisites

Install an AI development tool

For example, Cursor | WindSurf | CodeBuddy, etc. See the Supported AI IDE List.

Enable CloudBase Environment

Visit the Tencent CloudBase Console to enable your environment. New users can try it for free.

Install Node.js v18.15.0 or above

Make sure your computer has Node.js v18.15.0 or above. Download the latest version from the Node.js official site.

Optional: Set npm registry

To speed up dependency downloads, set npm registry to Tencent mirror. Run in your terminal:

npm config set registry https://mirrors.cloud.tencent.com/npm/

This will speed up downloads, especially in mainland China.

Optional: Clear npx cache Due to a bug in npx, you may need to clear its cache if you encounter installation issues. Run:
npx clear-npx-cache

1. Initialize or Enhance Your Project

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

🚀 For New Projects

Choose a template and initialize in 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 automatically download and complete the AI editor rule configuration in your project directory.

2. Configure Your AI IDE

TIP

If you use a template project, all configs are preset. If not, follow the instructions below to add the required config manually.

All the following tools support CloudBase AI ToolKit. Choose your tool and follow the guide:

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

3. Start Developing

Before you start, just tell the AI:

Login to CloudBase

The AI will automatically pop up the Tencent Cloud login and environment selection.

To switch environments later, say:

Logout CloudBase

The AI will clear the local config. You can ask the AI to login again anytime.

After login, you can confirm the AI is connected:

Query current CloudBase environment info

Describe your requirements to the AI and start developing:

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

The AI will automatically:

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

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

There was an error: xxxx

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

The cloud function code does not meet the requirements, the requirement is xxx, please check the logs and data for debugging and fix it

🔌 Plugin System

CloudBase MCP uses a plugin architecture. See detailed docs

Quick Config

{ "env": { "CLOUDBASE_MCP_PLUGINS_ENABLED": "env,database,functions,hosting" } }

📚 Tutorials

📄 Articles

📱 App Projects

🎥 Video Tutorials


🎯 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

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

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
📸 See dev screenshots and mini-program 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 an app has issues:

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

🌟 Why Choose CloudBase?

  • ⚡ Lightning Fast Deployment: Domestic nodes, faster than overseas
  • 🛡️ Stable & Reliable: Trusted by 3.3 million developers
  • 🔧 Developer Friendly: Full-stack platform for the AI era, supports auto environment config
  • 💰 Cost-Effective: Serverless architecture, free for new users during development

📋 FAQ

For migration, integration, and other common questions, see the FAQ.

💬 Community

Need help or want to share? Join our 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 the latest updates and best practices
  • 🎯 Join product discussions and suggestions

📱 Other Channels

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

🎉 Community Events

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

🛠️ CloudBase MCP Tools Overview

There are 39 tools covering environment management, database, cloud functions, hosting, mini-program publishing, and more.

📋 Full tool docs: See MCP tool details | Tool spec JSON

🔧 Tool Categories

CategoryCountMain Features
🌍 Env Mgmt4Login, env info, domain mgmt
🗄️ Database11Collection mgmt, CRUD, indexes, data models
Cloud Functions9Create, update, invoke, logs, triggers
🌐 Hosting5File upload, domain config, site deploy
📁 File Ops2Remote download, cloud storage upload
📱 Mini-Program7Upload, preview, build, config, debug, QA
🛠️ Tool Support4Templates, knowledge search, web search, dialogs
🔌 HTTP Access1HTTP function access

🌟 Tool Highlights

TypeNameHighlights
🔐 Authlogin / logoutOne-click CloudBase login, auto env selection
📊 Env QueryenvQuery🔄 Merged Tool - env list, info, domain in one
🗄️ DatabasecollectionQuery🔄 Merged Tool - existence, detail, list mgmt
Cloud FunctionscreateFunctionFull config, auto deps install, trigger setup
🌐 HostinguploadFilesBatch upload, smart ignore, CDN acceleration
🧠 AI EnhancedsearchKnowledgeBaseVector search CloudBase KB, smart Q&A

💡 Tool Optimization

We optimized from 40 to 36 tools, added 3 mini-program debug tools, now 39 tools in total, with better experience via merging and full mini-program toolchain.

🔗 Want details for each tool? See MCP tool docs

🏗️ Architecture

🔒 Telemetry

To improve product experience, CloudBase AI ToolKit collects anonymous usage stats:

  • Collected: Tool calls, basic env info (OS, Node.js version, etc.)
  • Privacy: No code or file paths collected, only for product improvement

Set CLOUDBASE_MCP_TELEMETRY_DISABLED=true to disable telemetry.

🤝 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!

Star History Chart

Alt

About

为AI驱动的IDE工具提供CloudBase开发提示词,通过MCP协议连接AI Agent 到CloudBase,实现智能化云开发体验。Prompts for working with CloudBase using AI-powered IDE tools. Connect your AI tools to CloudBase using MCP for seamless cloud development experience. https://tcb.cloud.tencent.com/