CloudBase AI ToolKit

CloudBase AI Toolkit

A IA escreve o código. O CloudBase executa o backend.

A camada de integração do CloudBase para ferramentas de codificação com IA: o Plugin instala a stack, as Skills orientam como o código é escrito, o MCP opera bancos de dados, funções, armazenamento e implantações a partir do chat.

English · 简体中文 · Docs · Changelog · Issues

Atualizações recentes

v2.25.x (2026-07)

• CloudRun / Gateway: orientação de VPC ao usar bancos de dados TCP; Domínio/Rota com upstreamResourceType e transmissão de caminho
• CloudRun / Gateway: preservar VPC remota e configuração de ambiente ao reimplantar; preferir URLs de acesso de domínio personalizado após a implantação
• Plugin: instalação mais fácil via Open Plugin / empacotamento de marketplace

Releases · Star · Watch → Releases

O que é

IDEs de IA (Cursor, Claude Code, Codex, CodeBuddy e outros) são fortes na geração de código. O que geralmente bloqueia você é o backend: esquemas, permissões, funções, armazenamento, ambientes e release.

CloudBase é o backend all-in-one nativo de IA da Tencent Cloud (banco de dados, armazenamento, autenticação, cloud functions, Cloud Run e muito mais). Este repositório é o Toolkit que conecta esse backend às ferramentas de IA:

Este repositório fornece o pacote npm @cloudbase/cloudbase-mcp, Skills e plugins de IA.

Você ainda precisa do seu próprio ambiente CloudBase e deve confirmar ações sensíveis que a IA propõe. O Toolkit fornece capacidade e caminho—não julgamento.

Repositórios relacionados

Repositórios de publicação e sincronização estão sob TencentCloudBase. Diretamente relacionados a este Toolkit:

Prefira o Plugin para a stack completa; Skills sozinhas quando você só precisa de restrições de conhecimento. Para IDEs de marketplace, use este repositório—não execute também npx plugins add na mesma ferramenta.

Início rápido

Escolha um caminho padrão para sua ferramenta.

Plugin

npx plugins add TencentCloudBase/cloudbase-plugin

Detalhes e diferenças entre IDEs: docs do plugin de IA.

Somente MCP

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

HTTP hospedado, Cloud Mode auto-hospedado e escopo de plugin: Instalar e conectar.

Primeiros prompts

Login to CloudBase

Use CloudBase Skills to build a todo app with login, database and permissions, then deploy

As Skills moldam estrutura e prática; o MCP lida com ambiente e recursos. Você deve ser capaz de verificar dados e APIs no seu próprio ambiente—não apenas obter arquivos-fonte locais.

IDEs de IA suportados

Configuração completa: Guias de IDE.

Capacidades

Após a configuração, a IA pode realizar trabalho típico de backend no seu ambiente (confirme etapas críticas):

• Banco de dados: PostgreSQL e banco de dados de documentos, modelos de dados, CRUD, permissões e regras de segurança
• Computação: criar, implantar, invocar e depurar cloud functions / Cloud Run
• Autenticação e armazenamento: métodos de login, armazenamento de objetos, vinculação de permissões com dados
• Release e operações: hospedagem estática / publicação de Mini Program; inspecionar logs e reimplantar

Adequado para Web, WeChat Mini Programs e serviços de backend. Visão geral da plataforma: docs do CloudBase.

Avaliação

Sob condições controladas, o mesmo resumo de aplicativo Todo e scaffold de frontend foram usados para comparar dois caminhos de backend: uma VM tradicional em nuvem (runtime, processo e exposição de rede autogerenciados) e CloudBase (banco de dados gerenciado, autenticação anônima e serviços de backend relacionados). Um agente de IA realizou desenvolvimento e verificação de ponta a ponta. Dado o modelo e a configuração da tarefa, o caminho CloudBase foi mais favorável em latência de conclusão, uso de tokens e contagem de chamadas de ferramentas. Esses resultados são condicionados ao modelo, framework do agente e definição da tarefa, e não devem ser generalizados além desse escopo.

Métodos, dados e limites: Avaliação de mesma tarefa: VM em nuvem vs CloudBase

Instalar e conectar

Pré-requisitos

• Node.js v18.15.0+
• Um ambiente CloudBase
• Uma ferramenta de IA que suporte Plugin / Skills / MCP

Opções de configuração

1. Plugin (quando a ferramenta suportar)
   npx plugins add TencentCloudBase/cloudbase-plugin
2. CloudBase AI CLI
   npm i -g @cloudbase/cli && tcb ai
3. MCP manual (escrever o arquivo de configuração do IDE)

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

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

Outros: guia de configuração de IDE.

Modos de conexão MCP

Local (padrão): npx na sua máquina—recursos completos, incluindo upload de arquivos locais / templates.

Hospedado: o IDE conecta via HTTP ao MCP da Tencent Cloud; sem Node local. Alguns recursos de arquivos locais não estão disponíveis.

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

URLs hospedadas podem usar enable_plugins / disable_plugins. Nomes canônicos vivem em mcp/src/server.ts.

Cloud Mode auto-hospedado: defina CLOUDBASE_MCP_CLOUD_MODE=true (ou MCP_CLOUD_MODE=true) para que ferramentas de arquivos e processos locais sejam desabilitadas para chamadores remotos.

Exemplo

Gomoku online: descreva a necessidade; obtenha Web + banco de dados em nuvem / tempo real e implante.
Demo: Gomoku · Mais: tutoriais

Docs

• Ferramentas MCP (tools.json)
• Introdução
• Configuração de IDE
• Plugins de IA
• Templates
• FAQ

FAQ

Comunidade

Atividade

Contribuidores

MIT · TencentCloudBase