https://github.com/TencentCloudBase/CloudBase-MCP

CloudBase MCP - Connect CloudBase to your AI Agent. Go from AI prompt to live app.
https://github.com/TencentCloudBase/CloudBase-MCP

ai aicoding cloudbase cursor mcp miniprogram serverless supabase tencent vibe-coding web

Last synced: 8 days ago
JSON representation

CloudBase MCP - Connect CloudBase to your AI Agent. Go from AI prompt to live app.

• Host: GitHub
• URL: https://github.com/TencentCloudBase/CloudBase-MCP
• Owner: TencentCloudBase
• License: mit
• Created: 2025-05-23T08:31:26.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2025-12-31T13:46:56.000Z (16 days ago)
• Last Synced: 2026-01-04T01:20:46.417Z (13 days ago)
• Topics: ai, aicoding, cloudbase, cursor, mcp, miniprogram, serverless, supabase, tencent, vibe-coding, web
• Language: TypeScript
• Homepage: https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/
• Size: 67.4 MB
• Stars: 910
• Watchers: 14
• Forks: 102
• Open Issues: 2
• Metadata Files:
  • Readme: README-EN.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-mcp - TencentCloudBase/CloudBase-MCP

README

          




![](scripts/assets/toolkit-better.gif)

CloudBase MCP


**🪐 Go from AI prompt to live app in one click**


The bridge that connects your AI IDE (Cursor, Copilot, etc.) directly to Tencent CloudBase

**Languages:** [中文](README-ZH.md) | **English** · [Documentation][docs] · [Changelog][changelog] · [Report Issues][github-issues-link]

[![][npm-version-shield]][npm-link]

[![][npm-downloads-shield]][npm-link]

[![][github-stars-shield]][github-stars-link]

[![][github-forks-shield]][github-forks-link]

[![][github-issues-shield]][github-issues-link]

![][github-license-shield]

[![][github-contributors-shield]][github-contributors-link]

[![][cnb-shield]][cnb-link]

[![][deepwiki-shield]][deepwiki-link]

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

[![][share-x-shield]][share-x-link]

[![][share-telegram-shield]][share-telegram-link]

[![][share-weibo-shield]][share-weibo-link]

The shortest path from AI prompt to live application

[![][github-trending-shield]](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit)

[](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/tutorials)



## Why You Need CloudBase MCP

AI programming tools (like Cursor, Copilot) 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](#quick-start)

- [Core Features](#core-features)

- [Installation & Configuration](#installation--configuration)

- [Use Cases](#use-cases)

- [MCP Tools](#mcp-tools)

- [More Resources](#more-resources)

## Quick Start

### One-Line Configuration, Start Using Immediately

In AI IDEs that support MCP (Cursor, WindSurf, CodeBuddy, etc.), just add one line of configuration:

```json

{

  "mcpServers": {

    "cloudbase": {

      "command": "npx",

      "args": ["@cloudbase/cloudbase-mcp@latest"]

    }

  }

}

```

> [!TIP]

> **Recommended: CloudBase AI CLI**

> 

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

> 

> ```bash

> npm install @cloudbase/cli@latest -g

> ```

> 

> After installation, run `tcb ai` to start using

> 

> [View complete documentation](https://docs.cloudbase.net/cli-v1/ai/introduce) | [Detailed case tutorial](https://docs.cloudbase.net/practices/ai-cli-mini-program)

### 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

| Tool | Supported Platform | Guide |

|------|----------|----------|

| [CloudBase AI CLI](https://docs.cloudbase.net/cli-v1/ai/introduce) | CLI | [Guide](https://docs.cloudbase.net/cli-v1/ai/introduce) |

| [Cursor](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cursor) | Standalone IDE| [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cursor) |

| [WindSurf](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/windsurf) | Standalone IDE, VSCode, JetBrains Plugin | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/windsurf) |

| [CodeBuddy](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/codebuddy) | Standalone IDE (CloudBase built-in), VS Code, JetBrains, WeChat DevTools| [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/codebuddy) |

| [CLINE](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cline) | VS Code Plugin | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/cline) |

| [GitHub Copilot](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/github-copilot) | VS Code Plugin | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/github-copilot) |

| [Trae](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/trae) | Standalone IDE | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/trae) |

| [Tongyi Lingma](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/tongyi-lingma) | Standalone IDE, VS Code, JetBrains Plugin | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/tongyi-lingma) |

| [RooCode](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/roocode) | VS Code Plugin | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/roocode) |

| [Baidu Comate](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/baidu-comate) | VS Code, JetBrains Plugin| [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/baidu-comate) |

| [Augment Code](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/augment-code) | VS Code, JetBrains Plugin | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/augment-code) |

| [Claude Code](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/claude-code) | CLI | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/claude-code) |

| [Gemini CLI](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/gemini-cli) | CLI | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/gemini-cli) |

| [OpenAI Codex CLI](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openai-codex-cli) | CLI | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/openai-codex-cli) |

| [OpenCode](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/opencode) | CLI | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/opencode) |

| [Qwen Code](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/qwen-code) | CLI | [Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/qwen-code) |

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

```markdown

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

```



### 2. One-Click Deploy

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

```markdown

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

```



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

```markdown

Prompt: There's an error: xxxx

- AI automatically views cloud function logs

- Analyze error causes

- Generate fix code

- Auto redeploy

```



### 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 Type | Tech Stack | Deployment Method |

|---------|--------|---------|

| **Web Apps** | React/Vue/Next.js | Static Hosting + CDN |

| **WeChat Mini-Programs** | Native/UniApp | Mini-program Publishing |

| **Backend Services** | Node.js/Python | Cloud Functions/Cloud Run |



### 5. Knowledge Search

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

```markdown

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

```



### 6. Flexible Workflow

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

```markdown

/spec - Complete workflow (Requirements → Design → Tasks → Implementation)

/no_spec - Fast iteration (Direct implementation)

```



## Installation & Configuration

### Prerequisites

- Node.js v18.15.0 or above

- Enabled [Tencent CloudBase Environment](https://tcb.cloud.tencent.com/dev)

- Installed AI IDE that supports MCP ([View supported IDEs](#supported-ai-ides))

### Configuration Methods

#### Method 1: CloudBase AI CLI (Recommended)

```bash

# 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`:

```json

{

  "mcpServers": {

    "cloudbase": {

      "command": "npx",

      "args": ["@cloudbase/cloudbase-mcp@latest"]

    }

  }

}

```

WindSurf

Add to `.windsurf/settings.json`:

```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](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/) 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](https://cloud1-5g39elugeec5ba0f-1300855855.tcloudbaseapp.com/gobang/#/)

View development screenshots

| Development Process | Final Result |

|---------|---------|

| ![][image-case1-dev] | ![][image-case1-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

![][image-case2]

### Case 3: Smart Issue Diagnosis

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

View smart diagnosis process

![][image-case3]

## MCP Tools

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

| Category | Tools | Core Features |

|------|------|----------|

| **Environment** | 4 | Login authentication, environment query, domain management |

| **Database** | 11 | Collection management, document CRUD, indexes, data models |

| **Cloud Functions** | 9 | Create, update, invoke, logs, triggers |

| **Static Hosting** | 5 | File upload, domain configuration, website deployment |

| **Mini-Program** | 7 | Upload, preview, build, configuration, debugging |

| **Tool Support** | 4 | Templates, knowledge base search, web search, interactive dialogs |

[View complete tool documentation](doc/mcp-tools.md) | [Tool specification JSON](scripts/tools.json)

## More Resources

### Documentation

- [Quick Start](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/getting-started)

- [IDE Configuration Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/ide-setup/)

- [Project Templates](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/templates)

- [Development Guide](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/development)

- [Plugin System](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/plugins)

- [FAQ](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/faq)

### Tutorials

#### Articles

- [Develop a Neighborhood Item Recycling Mini-Program with CloudBase AI CLI](https://docs.cloudbase.net/practices/ai-cli-mini-program)

- [One-stop development of card flip game with CodeBuddy IDE + CloudBase](https://mp.weixin.qq.com/s/2EM3RBzdQUCdfld2CglWgg)

- [Develop a WeChat mini-game in 1 hour](https://cloud.tencent.com/developer/article/2532595)

- [More tutorials...](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/tutorials)

#### Videos

- [CloudBase: Use AI to develop an Overcooked game](https://www.bilibili.com/video/BV1v5KAzwEf9/)

- [Software 3.0: Best AI Programming Partner](https://www.bilibili.com/video/BV15gKdz1E5N/)

- [More videos...](https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/tutorials)

### Project Cases

- [Gomoku Online Game](https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/web/gomoku-game)

- [Overcooked Co-op Game](https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/web/overcooked-game)

- [E-commerce Admin Panel](https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/web/ecommerce-management-backend)

- [More cases...](https://github.com/TencentCloudBase/awesome-cloudbase-examples)

## Community

### WeChat Group








Scan to join WeChat tech exchange group



### Other Communication Channels

| Platform | Link | Description |

|------|------|------|

| **Official Documentation** | [View Documentation](https://docs.cloudbase.net/) | Complete CloudBase documentation |

| **Issue Feedback** | [Submit Issue](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues) | Bug reports and feature requests |

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=TencentCloudBase/CloudBase-AI-ToolKit&type=Timeline)](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit)

## Contributors

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

[![Contributors](https://contrib.rocks/image?repo=TencentCloudBase/CloudBase-AI-ToolKit)](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/graphs/contributors)

---



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

[![][github-stars-shield]][github-stars-link]

[MIT](LICENSE) © TencentCloudBase



[image-overview]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/mcp/video-banner.png

[image-ai-native]: https://via.placeholder.com/800x400/3B82F6/FFFFFF?text=AI+Native+Development

[image-deploy]: https://via.placeholder.com/800x400/10B981/FFFFFF?text=One-Click+Deploy

[image-fullstack]: https://via.placeholder.com/800x400/8B5CF6/FFFFFF?text=Full-Stack+Application

[image-agent]: https://via.placeholder.com/800x400/EC4899/FFFFFF?text=AI+Agent+Development

[image-debug]: https://via.placeholder.com/800x400/F59E0B/FFFFFF?text=Smart+Debugging

[image-knowledge]: https://via.placeholder.com/800x400/06B6D4/FFFFFF?text=Knowledge+Search

[image-workflow]: https://via.placeholder.com/800x400/6366F1/FFFFFF?text=Flexible+Workflow

[image-case1-dev]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-001.png

[image-case1-result]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-004.png

[image-case2]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-005.png

[image-case3]: https://7463-tcb-advanced-a656fc-1257967285.tcb.qcloud.la/turbo-deploy/turbo-deploy-009.png

[docs]: https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/

[changelog]: https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/releases

[github-issues-link]: https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues

[github-stars-link]: https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/stargazers

[github-forks-link]: https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/network/members

[github-trending-url]: https://github.com/trending

[npm-link]: https://www.npmjs.com/package/@cloudbase/cloudbase-mcp

[cnb-link]: https://cnb.cool/tencent/cloud/cloudbase/CloudBase-AI-ToolKit

[deepwiki-link]: https://deepwiki.com/TencentCloudBase/CloudBase-AI-ToolKit

[npm-version-shield]: https://img.shields.io/npm/v/@cloudbase/cloudbase-mcp?color=3B82F6&label=npm&logo=npm&style=flat-square

[npm-downloads-shield]: https://img.shields.io/npm/dw/@cloudbase/cloudbase-mcp?color=10B981&label=downloads&logo=npm&style=flat-square

[github-stars-shield]: https://img.shields.io/github/stars/TencentCloudBase/CloudBase-AI-ToolKit?color=F59E0B&label=stars&logo=github&style=flat-square

[github-forks-shield]: https://img.shields.io/github/forks/TencentCloudBase/CloudBase-AI-ToolKit?color=8B5CF6&label=forks&logo=github&style=flat-square

[github-issues-shield]: https://img.shields.io/github/issues/TencentCloudBase/CloudBase-AI-ToolKit?color=EC4899&label=issues&logo=github&style=flat-square

[github-license-shield]: https://img.shields.io/badge/license-MIT-6366F1?logo=github&style=flat-square

[github-contributors-shield]: https://img.shields.io/github/contributors/TencentCloudBase/CloudBase-AI-ToolKit?color=06B6D4&label=contributors&logo=github&style=flat-square

[github-contributors-link]: https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/graphs/contributors

[cnb-shield]: https://img.shields.io/badge/CNB-CloudBase--AI--ToolKit-3B82F6?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHZpZXdCb3g9IjAgMCAxMiAxMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cmVjdCB3aWR0aD0iMTIiIGhlaWdodD0iMTIiIHJ4PSIyIiBmaWxsPSIjM0I4MkY2Ii8+PHBhdGggZD0iTTUgM0g3VjVINSIgc3Ryb2tlPSJ3aGl0ZSIgc3Ryb2tlLXdpZHRoPSIxLjUiLz48cGF0aCBkPSJNNSA3SDdWOUg1IiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjEuNSIvPjwvc3ZnPg==&style=flat-square

[deepwiki-shield]: https://deepwiki.com/badge.svg

[github-trending-shield]: https://img.shields.io/github/stars/TencentCloudBase/CloudBase-AI-ToolKit?style=social

[share-x-link]: https://x.com/intent/tweet?hashtags=cloudbase,ai,devtools&text=Go%20from%20AI%20prompt%20to%20live%20app%20in%20one%20click!%20No%20DevOps%20config%20needed%20🚀&url=https://github.com/TencentCloudBase/CloudBase-AI-ToolKit

[share-x-shield]: https://img.shields.io/badge/-share%20on%20x-black?labelColor=black&logo=x&logoColor=white&style=flat-square

[share-telegram-shield]: https://img.shields.io/badge/-share%20on%20telegram-black?labelColor=black&logo=telegram&logoColor=white&style=flat-square

[share-telegram-link]: https://t.me/share/url?url=https://github.com/TencentCloudBase/CloudBase-AI-ToolKit&text=Go%20from%20AI%20prompt%20to%20live%20app%20in%20one%20click!%20No%20DevOps%20config%20needed%20🚀

[share-weibo-link]: http://service.weibo.com/share/share.php?sharesource=weibo&title=Go%20from%20AI%20prompt%20to%20live%20app%20in%20one%20click!%20No%20DevOps%20config%20needed%20🚀&url=https://github.com/TencentCloudBase/CloudBase-AI-ToolKit

[share-weibo-shield]: https://img.shields.io/badge/-share%20on%20weibo-black?labelColor=black&logo=sinaweibo&logoColor=white&style=flat-square