CloudBase AI ToolKit

CloudBase MCP

🪐 Programação com IA, deploy com um clique
Conecte seu AI IDE ao Tencent Cloud CloudBase, a ponte de deploy que coloca seu aplicativo de IA no ar instantaneamente
^{💡 Como Vercel + Supabase, mas totalmente orientado por IA — do prompt direto para produção}

English · 简体中文 · Documentação · Registro de alterações · Reportar problemas

⭐ Gostou deste projeto? Dê uma estrela e receba notificações quando novas versões forem lançadas～

Descobri uma ferramenta incrível que permite deploy de IA com um clique, recomendo para quem está programando com IA

^{O caminho mais curto do prompt de IA ao aplicativo em produção}

Por que você precisa do CloudBase MCP?

Ferramentas de programação com IA (como OpenClaw, Cursor, CodeBuddy) resolvem o problema da geração de código.

Mas, entre "gerar código" e "colocar o aplicativo no ar" (deploy, configurar banco de dados, CDN, domínio), ainda existe um abismo.

O CloudBase MCP (anteriormente CloudBase AI ToolKit) preenche essa lacuna.

Você não precisa mais de:

• ❌ Configurações complicadas de DevOps e arquivos YAML
• ❌ Configurar manualmente funções em nuvem e bancos de dados
• ❌ Alternar constantemente entre o IDE e o console de nuvem

Você só precisa usar linguagem natural no seu AI IDE para ir da "ideia" ao "ar" em um processo completo.

🚀 Início rápido

Uma linha de configuração, uso imediato

Adicione qualquer uma das configurações abaixo no seu AI IDE compatível com MCP (Cursor, WindSurf, CodeBuddy, etc.). Existem duas formas de conexão:

Opção 1: Modo local (recomendado)

Significado: O serviço MCP é iniciado na sua máquina local via npx, rodando na mesma máquina que o IDE. Vantagens: Funcionalidade mais completa (inclui capacidades que dependem do sistema de arquivos local, como upload/download e instalação de templates). Requisitos: Node.js instalado na máquina local e capacidade de executar npx.

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

Opção 2: Modo hospedado

Significado: O serviço MCP roda na nuvem da Tencent, o IDE se conecta ao serviço em nuvem via HTTP, sem necessidade de instalar ou executar Node localmente. Vantagens: Não depende do ambiente da máquina local, basta configurar as chaves de API para usar. Limitações: Algumas funcionalidades que dependem do sistema de arquivos local não estão disponíveis (como upload de arquivos locais, download de templates para a máquina local, etc.).

Substitua <env_id>, <腾讯云 Secret ID>, <腾讯云 Secret Key> na configuração abaixo pelo seu ID de ambiente e chaves de API da Tencent Cloud:

{
  "mcpServers": {
    "cloudbase": {
      "type": "http",
      "url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<env_id>",
      "headers": {
        "X-TencentCloud-SecretId": "<腾讯云 Secret ID>",
        "X-TencentCloud-SecretKey": "<腾讯云 Secret Key>"
      }
    }
  }
}

Opção 3: Implantação em servidor próprio (Modo Nuvem)

Significado: Executa o serviço MCP em seu próprio servidor, habilitando o modo nuvem através da variável de ambiente CLOUDBASE_MCP_CLOUD_MODE=true. Cenário de uso: Quando você precisa implantar o servidor MCP em um servidor remoto por conta própria, fornecendo uma interface HTTP Streamable externamente. Mecanismo de segurança: Com o Modo Nuvem habilitado, todas as ferramentas que envolvem leitura/escrita no sistema de arquivos local e inicialização de processos locais serão automaticamente desabilitadas, garantindo que chamadores remotos não possam operar recursos locais do servidor.

# 启用云端模式的环境变量（二选一）
export CLOUDBASE_MCP_CLOUD_MODE=true
# 或
export MCP_CLOUD_MODE=true

As ferramentas desabilitadas no Modo Nuvem incluem: downloadRemoteFile, downloadTemplate, manageCloudRun (execução local), manageApps (deploy de código local), manageStorage (upload/download de arquivos locais), createFunction (upload de código local) e outras operações que envolvem I/O de arquivos locais.

[!IMPORTANT] Recomendações para escolha do modo de implantação:

• Desenvolvimento individual: Use o modo local (npx), funcionalidade mais completa
• Colaboração em equipe / Serviço remoto: Use o modo hospedado na Tencent Cloud (Opção 2), sem necessidade de manutenção
• Servidor próprio: Certifique-se de definir CLOUDBASE_MCP_CLOUD_MODE=true, desabilitando ferramentas de manipulação de arquivos locais

Modo hospedado opcional: Controle de escopo de plugins via URL

No url, você pode controlar o escopo de plugins habilitados através de parâmetros de consulta (query):

• enable_plugins: Habilita apenas os plugins especificados, separados por vírgula, por exemplo, habilitar apenas env e database
• disable_plugins: Desabilita plugins especificados do conjunto padrão, separados por vírgula, por exemplo, desabilitar rag e env

# 只启用指定插件
https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&enable_plugins=env,database

# 禁用指定插件
https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&disable_plugins=rag,env

Os nomes de plugins configuráveis atualmente são baseados em mcp/src/server.ts, recomenda-se usar os nomes canônicos: env, database, functions, hosting, storage, setup, rag, download, gateway, cloudrun, app-auth, permissions, logs, agents, invite-code, capi, apps.

[!TIP] Recomendamos o uso do CloudBase AI CLI

Instalação com um clique, configuração automática, compatível com várias ferramentas de programação com IA:

npm install @cloudbase/cli@latest -g

Após a instalação, execute tcb ai para começar a usar

Ver documentação completa | Tutoriais detalhados de casos

Primeiro uso

1. Login no CloudBase

   登录云开发
   

   A IA abrirá automaticamente a interface de login e guiará a seleção do ambiente

2. Começar a desenvolver

   做一个双人在线对战五子棋网站，支持联机对战，最后进行部署
   

   A IA gerará código automaticamente, fará o deploy na nuvem e retornará o link de acesso

AI IDEs compatíveis

✨ Como alcançar o "deploy com um clique" na programação com IA?

1. Nativo em IA (AI-Native)

Não somos um simples "código de cola". A base de regras integrada é projetada para programação com IA, permitindo que a IA gere diretamente código "implantável" seguindo as melhores práticas do CloudBase.

提示词：生成一个用户登录功能
- AI 自动生成符合云开发规范的代码
- 自动配置数据库、云函数、安全规则
- 一键部署到云端

2. Deploy com um clique (One-Click Deploy)

Fluxo de deploy MCP automatizado por IA, a IA cuida de todas as configurações de recursos na nuvem, desde funções em nuvem e bancos de dados até sites estáticos.

提示词：部署当前项目到云开发
- 自动检测项目类型（Web/小程序/后端）
- 智能配置部署参数
- 实时显示部署进度
- 自动返回访问链接

3. Depuração inteligente (Smart Debugging)

Erro no deploy? Não se preocupe. A IA lerá automaticamente os logs, ajudará a analisar e corrigir problemas, realizando verdadeiramente o ciclo fechado de desenvolvimento-deploy-depuração.

提示词：报错了，错误是 xxxx
- AI 自动查看云函数日志
- 分析错误原因
- 生成修复代码
- 自动重新部署

4. Suporte full-stack (Full-Stack Ready)

Seja uma aplicação Web, um Mini Programa ou um serviço de backend, a IA pode lidar com isso para você, permitindo que você se concentre apenas na lógica de negócio.

5. Pesquisa de conhecimento (Knowledge Search)

Pesquisa vetorial inteligente integrada com bases de conhecimento especializadas, como CloudBase e Mini Programas WeChat, tornando a IA mais familiarizada com o desenvolvimento em nuvem.

提示词：如何使用云数据库实现实时数据同步？
- 智能检索云开发知识库
- 返回相关文档和最佳实践
- 提供代码示例

6. Fluxo de trabalho flexível (Flexible Workflow)

Suporta comandos /spec e /no_spec, com seleção inteligente baseada na complexidade da tarefa.

/spec - 完整工作流（需求→设计→任务→实现）
/no_spec - 快速迭代（直接实现）

📦 Instalação e configuração

Pré-requisitos

• ✅ Node.js v18.15.0 ou superior
• ✅ Ter um ambiente Tencent CloudBase ativo
• ✅ Instalar um AI IDE compatível com MCP (Ver IDEs compatíveis)

Métodos de configuração

Opção 1: CloudBase AI CLI (recomendado)

# 安装
npm install @cloudbase/cli@latest -g

# 使用
tcb ai

Opção 2: Configuração manual do MCP

Adicione a configuração MCP de acordo com o AI IDE que você usa:

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

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

🎯 Casos de uso

Caso 1: Jogo de Gomoku (Cinco em Linha) multijogador online

Processo de desenvolvimento:

1. Insira o requisito: "Crie um site de Gomoku multijogador online, com suporte a partidas online"
2. IA gera: Aplicação Web + Banco de dados em nuvem + Push de dados em tempo real
3. Deploy automático e obtenção do link de acesso

Link para experimentar: Jogo de Gomoku

Ver capturas de tela do desenvolvimento

Processo de desenvolvimento	Resultado final

Caso 2: Mini Programa de criação de pets com IA

Processo de desenvolvimento:

1. Insira: "Desenvolva um Mini Programa de criação de monstrinhos de bolso, usando IA para interação aprimorada"
2. IA gera: Mini Programa + Banco de dados em nuvem + Função em nuvem de IA
3. Importe para as Ferramentas de Desenvolvedor WeChat para publicar

Caso 3: Diagnóstico inteligente de problemas

Quando um problema surge na aplicação, a IA verifica automaticamente os logs, analisa o erro e gera código de correção.

🧩 Ferramentas MCP

Cobre funcionalidades essenciais como gerenciamento de ambiente, banco de dados, funções em nuvem, hospedagem estática e publicação de Mini Programas.

Ver documentação completa das ferramentas | Especificação das ferramentas em JSON

📚 Mais recursos

Documentação

• Início rápido
• Guia de configuração do IDE
• Templates de projeto
• Guia de desenvolvimento
• Sistema de plugins
• Perguntas frequentes

Artigos recentes

• Uma pessoa é uma equipe: OpenClaw+CloudBase para desenvolvimento e deploy totalmente automatizados
• Experiência prática de Agent Skills: A última milha da programação com IA, não deixe seu código morrer no localhost
• Ver mais vídeos e tutoriais

❓ Perguntas frequentes

💬 Comunidade

Grupo de WeChat

Escaneie o código para entrar no grupo técnico do WeChat

Outras formas de comunicação

Atividade do projeto

Contribuidores

Agradecemos a todos os desenvolvedores que contribuíram para o CloudBase MCP!