CloudBase AI ToolKit

oficial

Ve de un prompt de IA a una aplicación en vivo con un solo clic. CloudBase AI ToolKit es el puente que conecta tu IDE de IA (Cursor, Copilot, etc.) directamente con Tencent CloudBase.

¿Qué puedes hacer con Cloud Base AI Tool Kit MCP?

  • Inicia sesión en tu entorno de CloudBase — pide a la IA que se autentique y seleccione un entorno para que las operaciones posteriores apunten a tu propio backend.
  • Consulta y modifica registros de la base de datos — usa las herramientas de database para realizar operaciones CRUD en las bases de datos de documentos o PostgreSQL de CloudBase.
  • Despliega funciones en la nube y alojamiento estático — indica a la IA que cree, despliegue e invoque funciones en la nube o publique activos de frontend en el alojamiento estático.
  • Gestiona autenticación y almacenamiento — configura métodos de inicio de sesión, establece permisos de almacenamiento de objetos y vincula reglas de acceso a tus modelos de datos.
  • Inspecciona registros y vuelve a desplegar servicios — lee los registros de ejecución para depurar problemas y activa el redespliegue de servicios o funciones de CloudRun.

Documentación

CloudBase AI Toolkit

CloudBase AI Toolkit

La IA escribe el código. CloudBase ejecuta el backend.

La capa de integración de CloudBase para herramientas de codificación con IA: el Plugin instala la pila, las Skills orientan cómo se escribe el código, MCP opera bases de datos, funciones, almacenamiento y despliega desde el chat.

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

Actualizaciones recientes

v2.25.x (2026-07)

  • CloudRun / Gateway: guía de VPC al usar bases de datos TCP; Dominio/Ruta con upstreamResourceType y transmisión de ruta
  • CloudRun / Gateway: conserva la configuración remota de VPC y entorno al redesplegar; prefiere URLs de acceso de dominio personalizado después del despliegue
  • Plugin: instalación más fácil mediante Open Plugin / empaquetado de marketplace

Releases · Star · Watch → Releases

Qué es

Los IDEs de IA (Cursor, Claude Code, Codex, CodeBuddy y otros) son muy buenos generando código. Lo que normalmente te bloquea es el backend: esquemas, permisos, funciones, almacenamiento, entornos y lanzamiento.

CloudBase es el backend integral nativo de IA de Tencent Cloud (base de datos, almacenamiento, autenticación, funciones en la nube, Cloud Run y más). Este repositorio es el Toolkit que conecta ese backend con las herramientas de IA:

PiezaRol
PluginInstala MCP Server, Agent Skills y Hooks juntos—menos configuración por IDE
Agent SkillsSkills de escenarios (Web / Mini Program / base de datos / autenticación / funciones, etc.) hacia prácticas viables de CloudBase
MCPIniciar sesión, consultar y modificar datos, gestionar funciones y hosting, leer registros—desde la conversación

Este repositorio incluye el paquete npm @cloudbase/cloudbase-mcp, Skills y plugins de IA.

Aún necesitas tu propio entorno de CloudBase, y debes confirmar las acciones sensibles que la IA proponga. El Toolkit proporciona capacidad y camino—no juicio.

Repositorios relacionados

Los repositorios de publicación y sincronización viven bajo TencentCloudBase. Directamente relacionados con este Toolkit:

RepositorioContenidoEntrada típica
CloudBase-AI-Toolkit (este repositorio)Código fuente de MCP Server; fuente de marketplace para Claude Code / Codexnpx @cloudbase/cloudbase-mcp@latest
cloudbase-pluginRepositorio de publicación de Open Plugin Spec (sincronizado por CI): MCP + Skills + Hooksnpx plugins add TencentCloudBase/cloudbase-plugin · Respaldo CNB: npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-plugin.git
cloudbase-sites-pluginPlugin de sitios: creación y despliegue de Vite Webnpx plugins add TencentCloudBase/cloudbase-sites-plugin · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-sites-plugin.git
cloudbase-skillsColección de Agent Skillsnpx skills add TencentCloudBase/cloudbase-skills · CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills.git
skillsCatálogo de instalación por skill (también en skills.sh)npx skills add tencentcloudbase/skills --skill <name>
awesome-cloudbase-examplesEjemplos y casos de estudio de CloudBaseExplorar / clonar ejemplos
OpenVibeCodingPlantilla de vibecoding en CloudBaseUsar como iniciador de proyecto

Prefiere Plugin para la pila completa; Skills solas cuando solo necesitas restricciones de conocimiento. Para IDEs de marketplace usa este repositorio—no ejecutes también npx plugins add en la misma herramienta.

Inicio rápido

Elige una ruta predeterminada para tu herramienta.

Tu herramientaRuta sugerida
Claude Code / Codex (marketplace nativo)Añade este repositorio como marketplace, luego instala el plugin cloudbase (documentación del plugin)
Herramientas de Open Plugin Specnpx plugins add TencentCloudBase/cloudbase-plugin
Prefiere un solo CLI para muchas herramientasCloudBase AI CLI: npm i -g @cloudbase/cli && tcb ai
CodeBuddy / WorkBuddy / ZCode (integrados)Usa el plugin o conector de CloudBase integrado del IDE
Otros IDEs compatibles con MCPSolo configuración de MCP (abajo)

Plugin

npx plugins add TencentCloudBase/cloudbase-plugin

Detalles y diferencias entre IDEs: documentación de plugins de IA.

Solo MCP

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

HTTP alojado, Cloud Mode autoalojado y alcance de plugins: Instalación y conexión.

Primeros prompts

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

Las Skills dan forma a la estructura y las prácticas; MCP gestiona el entorno y los recursos. Deberías poder verificar datos y APIs en tu propio entorno—no solo obtener archivos fuente locales.

IDEs de IA compatibles

Supported AI IDEs
HerramientaPlataformaGuía
CloudBase AI CLICLIGuía
OpenClawCLIGuía
WorkBuddyIDE independienteGuía
ZCodeIDE independiente (≥ 3.4.1 integrado)Guía
Codex AppAppGuía
CursorIDE independienteGuía
WindSurfIDE / pluginsGuía
CodeBuddyIDE independiente (integrado)Guía
CLINEPlugin de VS CodeGuía
GitHub CopilotPlugin de VS CodeGuía
TraeIDE independienteGuía
Tongyi LingmaIDE / pluginsGuía
RooCodePlugin de VS CodeGuía
Baidu ComatePluginsGuía
Augment CodePluginsGuía
Claude CodeCLIGuía
Gemini CLICLIGuía
Codex CLICLIGuía
OpenCodeCLIGuía
Qwen CodeCLIGuía

Configuración completa: Guías de IDE.

Capacidades

Después de la configuración, la IA puede realizar trabajo típico de backend en tu entorno (confirma los pasos críticos):

  • Base de datos: PostgreSQL y base de datos documental, modelos de datos, CRUD, permisos y reglas de seguridad
  • Computación: crear, desplegar, invocar y depurar funciones en la nube / Cloud Run
  • Autenticación y almacenamiento: métodos de inicio de sesión, almacenamiento de objetos, vinculación de permisos con datos
  • Lanzamiento y operaciones: hosting estático / publicación de Mini Program; inspeccionar registros y redesplegar

Adecuado para Web, WeChat Mini Programs y servicios backend. Resumen de la plataforma: Documentación de CloudBase.

Evaluación

En condiciones controladas, se usó el mismo resumen de aplicación Todo y el mismo andamiaje de frontend para comparar dos rutas de backend: una VM tradicional en la nube (runtime, proceso y exposición de red autogestionados) y CloudBase (base de datos gestionada, autenticación anónima y servicios backend relacionados). Un agente de IA realizó el desarrollo y la verificación de extremo a extremo. Dado el modelo y la configuración de la tarea, la ruta de CloudBase fue más favorable en latencia de finalización, uso de tokens y número de llamadas a herramientas. Estos resultados dependen del modelo, el marco del agente y la definición de la tarea, y no deben generalizarse más allá de ese alcance.

Métodos, datos y límites: Evaluación de misma tarea: VM en la nube vs CloudBase

Instalación y conexión

Requisitos previos

Opciones de configuración

  1. Plugin (cuando la herramienta lo admita)
    npx plugins add TencentCloudBase/cloudbase-plugin
  2. CloudBase AI CLI
    npm i -g @cloudbase/cli && tcb ai
  3. MCP manual (escribe el archivo de configuración del IDE)
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}
WindSurf (.windsurf/settings.json)
{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}
CodeBuddy

CloudBase está integrado (MCP / Skills); normalmente no se necesita configuración manual.

Otros: Guía de configuración de IDE.

Modos de conexión MCP

Local (predeterminado): npx en tu máquina—funciones completas, incluida la carga de archivos locales / plantillas.

Alojado: el IDE se conecta por HTTP al MCP de Tencent Cloud; no se necesita Node local. Algunas funciones de archivos locales no están disponibles.

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

Las URLs alojadas pueden usar enable_plugins / disable_plugins. Los nombres canónicos viven en mcp/src/server.ts.

Cloud Mode autoalojado: establece CLOUDBASE_MCP_CLOUD_MODE=true (o MCP_CLOUD_MODE=true) para que las herramientas de archivos y procesos locales estén deshabilitadas para llamadores remotos.

EscenarioSugerencia
PersonalLocal npx
Equipo / cero operacionesHTTP alojado
MCP autoalojadoCloud Mode requerido

Ejemplo

Gomoku en línea: describe la necesidad; obtén Web + base de datos en la nube / tiempo real y despliega.
Demo: Gomoku · Más: tutoriales

Documentación

FAQ

¿En qué se diferencia esto de Vercel / Netlify?

Esos se centran en publicar frontends o contenedores. CloudBase proporciona bloques de construcción de backend (base de datos, autenticación, funciones). El Toolkit permite que las herramientas de IA los usen en el chat. El despliegue es solo parte del camino.

¿Puedo usar esto sin un IDE gráfico?

Sí. Cualquier herramienta que pueda configurar un MCP Server o instalar el Plugin / Skills correspondiente funciona—incluidos Claude Code, Gemini CLI, OpenCode. Lista de soporte

¿A dónde va mi código?

El despliegue apunta a tu propio entorno de CloudBase. En modo local, MCP se ejecuta en tu máquina; el código no necesita salir hasta que despliegues. El tráfico en la nube usa HTTPS.

¿Es seguro autoalojar el servidor MCP?

Local npx equivale a ejecutar las herramientas tú mismo. Para hosts remotos, establece CLOUDBASE_MCP_CLOUD_MODE=true para deshabilitar las herramientas de archivos/procesos locales. El HTTP alojado de Tencent Cloud incluye esta protección.

¿Costo?

El Toolkit (incluido MCP) es de código abierto bajo MIT. CloudBase tiene cuotas gratuitas; el uso más allá de eso se factura—consulta facturación.

¿El inicio de sesión dice que el entorno no existe?

Confirma que existe un entorno y que está saludable en la consola, luego inicia sesión de nuevo y elige el correcto.

Comunidad

Documentacióndocs.cloudbase.net
ProblemasGitHub Issues
LanzamientosChangelog

Actividad

Repo Activity

Contribuyentes

Contributors


MIT · TencentCloudBase