JSPM

  • Created
  • Published
  • Downloads 548
  • Score
    100M100P100Q111467F
  • License MIT

腾讯云开发 MCP Server,支持静态托管/环境查询/

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@cloudbase/cloudbase-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    🌟 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

    • 🎯 Flexible Workflow - Support for /spec and /no_spec commands, intelligently choose development mode based on task complexity

    [!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
    • Spec workflow is built into CloudBase AI rules, download the latest template or let AI download CloudBase AI rules in the current project to get it

    🚩 Get Started with CloudBase AI ToolKit

    CloudBase AI CLI is a unified command-line tool that integrates multiple mainstream AI programming tools, supporting built-in models and custom models. It allows you to use Claude Code, OpenAI Codex, aider, Qwen Code, and other AI programming assistants with a simple command, while built-in CloudBase AI Toolkit supports the complete workflow from development to deployment, and can run in any environment.

    Core Advantages:

    • 🏗️ Unified Management - One command to manage multiple AI programming CLI tools, no need to switch between tools
    • 🤖 Multi-Model Support - Support for built-in and custom large models, including Kimi K2, Zhipu GLM-4.5, etc.
    • 🚀 One-Click Development & Deployment - Complete workflow from code generation to cloud deployment, supporting Web apps, mini-programs, and backend services
    • 🌍 Everywhere - Can run in any environment, including mini-program developer tools, VS Code, GitHub Actions, etc.

    One-Click Installation

    # Mac/Linux/Windows WSL
    curl https://static.cloudbase.net/cli/install/install.sh -fsS | bash
    
    # Windows PowerShell
    irm https://static.cloudbase.net/cli/install/install.ps1 | iex

    Start Using

    tcb ai

    On first launch, the configuration wizard will guide you through AI tool selection and configuration. After configuration, you can start using AI tools for assisted development. You can run tcb ai --setup later to switch tools and models.

    👉 View complete usage documentation | Try Now | Full-Stack Mini-Program Development Case Tutorial

    🛠️ Other IDE Configuration Methods

    If you use other AI IDEs, please refer to the configuration guides below:


    🚀 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.

    If you only want to download specific IDE config files to avoid project file confusion, you can specify the IDE type:

    Download CloudBase AI rules in the current project, only include Cursor config
    Download CloudBase AI rules in the current project, only include WindSurf config
    Download CloudBase AI rules in the current project, only include Claude Code config

    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:

    Tool Platform Guide
    CloudBase AI CLI CLI Guide
    Cursor Standalone IDE Guide
    WindSurf Standalone IDE, VSCode, JetBrains Guide
    CodeBuddy Standalone IDE (CloudBase built-in), VS Code, JetBrains, WeChat DevTools Guide
    CLINE VS Code Guide
    GitHub Copilot VS Code Guide
    Trae Standalone IDE Guide
    Tongyi Lingma Standalone IDE, VS Code, JetBrains Guide
    RooCode VS Code Guide
    Baidu Comate VS Code, JetBrains Guide
    Augment Code VS Code, JetBrains Guide
    Claude Code CLI Guide
    Gemini CLI CLI Guide
    OpenAI Codex CLI CLI Guide
    OpenCode CLI Guide
    Qwen Code CLI Guide

    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

    🚀 CloudBase AI CLI Case Studies

    🌐 Full-Stack Web Apps

    📱 Full-Stack Mini-Programs

    📱 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
    Development Final Result
    Dev Screenshot 1 Gomoku Game Result
    Dev Screenshot 2 Supports 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

    Platform Link Description
    Docs 📖 Docs Full CloudBase docs
    Issue Feedback 🐛 Submit Issue Bug 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

    Category Count Main Features
    🌍 Env Mgmt 4 Login, env info, domain mgmt
    🗄️ Database 11 Collection mgmt, CRUD, indexes, data models
    Cloud Functions 9 Create, update, invoke, logs, triggers
    🌐 Hosting 5 File upload, domain config, site deploy
    📁 File Ops 2 Remote download, cloud storage upload
    📱 Mini-Program 7 Upload, preview, build, config, debug, QA
    🛠️ Tool Support 4 Templates, knowledge search, web search, dialogs
    🔌 HTTP Access 1 HTTP function access

    🌟 Tool Highlights

    Type Name Highlights
    🔐 Auth login / logout One-click CloudBase login, auto env selection
    📊 Env Query envQuery 🔄 Merged Tool - env list, info, domain in one
    🗄️ Database collectionQuery 🔄 Merged Tool - existence, detail, list mgmt
    Cloud Functions createFunction Full config, auto deps install, trigger setup
    🌐 Hosting uploadFiles Batch upload, smart ignore, CDN acceleration
    🧠 AI Enhanced searchKnowledgeBase Vector 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

    graph TD
        A[Developer] --> B[AI IDE]
        B -->|Use| C[CloudBase AI Rules]
        C --> D[Generate Code]
        B -->|Call| E[CloudBase MCP]
        E --> F{Deploy Check}
        F -->|Success| G[CloudBase Platform]
        F -->|Fail| H[Return Logs]
        H --> I[AI Fix]
        I --> E
        G --> J[Online App]
        J --> K[Web/Mini-Program/API]

    🔒 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