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 faz deploys a partir do chat.

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

Atualizações recentes

v2.34.x (2026-09)

• i18n / IDE: localização completa da cópia de ferramentas com um lang em nível de instância, além dos parâmetros auth site / region para que o login em sites internacionais e o roteamento por região sejam resolvidos corretamente
• Cloud API: a lista de permissões do serviço callCloudApi foi ampliada para 57 com mapeamento de versão integrado (serviços com múltiplas versões, como tke / mongodb / vod, exigem um version explícito)
• Deploy / Env: nova ferramenta appBuild com neutralização de build de hospedagem; queryEnv informa a região efetivamente aplicada e domains respeita um envId passado
• Skills / Docs: as leituras de fallback de skills agora apontam para o repositório oficial de distribuição com uma lista de endereços de referência; porta de decisão de banco de dados SDK-first para cloudrun; links de documentação do site movidos para os endereços Markdown atuais; compartilhamento pós-deploy oferecido após a entrega nos pacotes de especialistas e nas skills de deploy (opt-in, com dados removidos, no máximo uma vez)

v2.33.x (2026-09)

• Functions / Apps: deploy de imagem de contêiner personalizada para cloud functions com consulta assíncrona de status; canal de upload em nuvem (getUploadUrl + deployApp cosTimestamp)
• Env binding: cloudbaserc.json como fallback em nível de campo para envId / region / site (literal + {{env.KEY}})
• Errors / Skills: orientação centralizada de erros por Code estruturado; referência de pagamento virtual; skill de upgrade do MCP para IDE CodeBuddy; especialistas WorkBuddy
• Cloud API / Deploy: callCloudApi abre serviços de monitoramento e postgres; deploy declarativo com deployPlan / deployApply; skill cloud-api-operations

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: schemas, 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 publica 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 vivem sob TencentCloudBase. Diretamente relacionados a este Toolkit:

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

Início rápido

Maneira mais rápida de começar

Copie este prompt de IA para sua IDE de IA. O agente lê skill.md e conclui a configuração:

Set up CloudBase for me:
1. Open https://docs.cloudbase.net/skill.md and complete the setup following its instructions.
2. Tell me when you're done, and suggest the most relevant next step.

npx plugins add TencentCloudBase/cloudbase-plugin

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

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 conseguir verificar dados e APIs no seu próprio ambiente—não apenas obter arquivos-fonte locais.

IDEs de IA suportadas

Configuração completa: Guias de IDE.

Capacidades

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

• Banco de dados: PostgreSQL e banco de dados documental, 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 briefing de aplicativo Todo e scaffold de frontend foram usados para comparar dois caminhos de backend: uma VM tradicional em nuvem (runtime autogerenciado, processo e exposição de rede) 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 de 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 suporta)
   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 da 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/templates de sistema de arquivos local.

Hospedado: a 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 site (domestic / intl) para escolher o site de login (por exemplo, Singapura no site doméstico precisa de site=domestic), além de enable_plugins / disable_plugins para reduzir ferramentas. Nomes canônicos vivem em mcp/src/server.ts.

Hosted MCP E2E (cliente SDK oficial): npm run test:hosted-mcp:e2e — veja tests/hosted-mcp-e2e/README.md para modos apikey/OAuth, staging TLS-inseguro e env vars. Credenciais ausentes são ignoradas (exit 0).

Self-hosted Cloud Mode: 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 deploy.
Demo: Gomoku · Mais: tutoriais

Docs

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

FAQ

{ "site": "domestic", "region": "ap-singapore", "envId": "your-env-id" }

Comunidade

Atividade

Contribuidores

MIT · TencentCloudBase