CloudBase AI ToolKit

CloudBase AI Toolkit

AI 寫程式碼。CloudBase 運行後端。

CloudBase 與 AI 編碼工具的整合層：Plugin 安裝整套堆疊，Skills 引導程式碼撰寫方式，MCP 操作資料庫、函數、儲存，並可從對話中部署。

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

近期更新

v2.25.x (2026-07)

• CloudRun / Gateway：使用 TCP 資料庫時的 VPC 指引；Domain/Route 支援 upstreamResourceType 與路徑傳遞
• CloudRun / Gateway：重新部署時保留遠端 VPC 與環境設定；部署後優先使用自訂網域存取 URL
• Plugin：透過 Open Plugin / marketplace 打包簡化安裝

Releases · Star · Watch → Releases

這是什麼

AI IDE（Cursor、Claude Code、Codex、CodeBuddy 等）擅長產生程式碼。通常阻礙你的是後端：schema、權限、函數、儲存、環境與發布。

CloudBase 是騰訊雲的 AI 原生全方位後端（資料庫、儲存、認證、雲函數、Cloud Run 等）。這個 repo 是將該後端連接到 AI 工具的 Toolkit：

此 repo 發布 npm 套件 @cloudbase/cloudbase-mcp、Skills 與 AI plugins。

你仍需要自己的 CloudBase 環境，且應確認 AI 提出的敏感操作。Toolkit 提供能力與路徑——而非判斷。

相關 repositories

發布與同步 repos 位於 TencentCloudBase 之下。與此 Toolkit 直接相關的：

完整堆疊建議使用 Plugin；只需知識約束時單獨使用 Skills。對於 marketplace IDE 使用此 repo——不要在同一工具上同時執行 npx plugins add。

快速開始

為你的工具選擇一個預設路徑。

Plugin

npx plugins add TencentCloudBase/cloudbase-plugin

詳細資訊與 IDE 差異：AI plugin 文件。

僅 MCP

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

託管 HTTP、自架 Cloud Mode 與 plugin 範圍：安裝與連線。

第一個提示詞

Login to CloudBase

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

Skills 塑造結構與實作；MCP 處理環境與資源。你應該能在自己的環境中驗證資料與 API——而不只是取得本機原始檔。

支援的 AI IDE

完整設定：IDE 指南。

功能

設定完成後，AI 可以在你的環境中執行典型的後端工作（確認關鍵步驟）：

• 資料庫：PostgreSQL 與文件資料庫、資料模型、CRUD、權限與安全規則
• 運算：撰寫、部署、呼叫與除錯雲函數 / Cloud Run
• 認證與儲存：登入方式、物件儲存、與資料的權限連結
• 發布與維運：靜態託管 / 小程式發布；檢查日誌並重新部署

適用於 Web、微信小程式與後端服務。平台總覽：CloudBase 文件。

評估

在受控條件下，使用相同的 Todo 應用程式需求與前端 scaffold 比較兩條後端路徑：傳統雲端 VM（自行管理 runtime、process 與網路暴露）與 CloudBase（受管資料庫、匿名認證與相關後端服務）。AI agent 執行端到端開發與驗證。在給定的模型與任務設定下，CloudBase 路徑在完成延遲、token 用量與工具呼叫次數上較為有利。這些結果取決於模型、agent 框架與任務定義，不應推廣至該範圍之外。

方法、資料與限制：相同任務評估：雲端 VM vs CloudBase

安裝與連線

前置需求

• Node.js v18.15.0+
• 一個 CloudBase 環境
• 支援 Plugin / Skills / MCP 的 AI 工具

設定選項

1. Plugin（當工具支援時）
   npx plugins add TencentCloudBase/cloudbase-plugin
2. CloudBase AI CLI
   npm i -g @cloudbase/cli && tcb ai
3. 手動 MCP（撰寫 IDE 設定檔）

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

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

其他：IDE 設定指南。

MCP 連線模式

本機（預設）：npx 在你的機器上——完整功能，包括本機檔案上傳/範本。

託管：IDE 透過 HTTP 連線到騰訊雲 MCP；不需要本機 Node。部分本機檔案功能不可用。

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

託管 URL 可使用 enable_plugins / disable_plugins。正式名稱位於 mcp/src/server.ts。

自架 Cloud Mode：設定 CLOUDBASE_MCP_CLOUD_MODE=true（或 MCP_CLOUD_MODE=true），讓遠端呼叫者停用本機檔案與 process 工具。

範例

線上五子棋：描述需求；取得 Web + 雲端資料庫 / 即時功能並部署。
Demo：Gomoku · 更多：教學

文件

• MCP 工具（tools.json）
• 開始使用
• IDE 設定
• AI plugins
• 範本
• FAQ

FAQ

社群

活動

貢獻者

MIT · TencentCloudBase