CloudBase AI ToolKit

CloudBase AI Toolkit

AIがコードを書き、CloudBaseがバックエンドを動かす。

AIコーディングツールのためのCloudBase統合レイヤー: Pluginはスタックをインストールし、Skillsはコードの書き方を導き、MCPはデータベース・関数・ストレージを操作し、チャットからデプロイまで行います。

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

最近の更新

v2.34.x (2026-09)

• i18n / IDE: インスタンスレベルのlangによる完全なツールコピーのローカライズに加え、auth site / regionパラメータを追加し、国際サイトのログインとリージョンルーティングが正しく解決されるようにしました
• Cloud API: callCloudApiサービスの許可リストを57に拡大し、組み込みのバージョンマッピングを追加(tke / mongodb / vodなどのマルチバージョンサービスでは明示的なversionが必要)
• Deploy / Env: ホスティングビルドの中和を備えた新しいappBuildツールを追加。queryEnvは実際に適用されたリージョンを報告し、domainsは渡されたenvIdを尊重します
• Skills / Docs: スキルのフォールバック読み取りは、参照アドレスリストを持つ公式配布リポジトリを指すようになりました。cloudrun用のSDKファーストのデータベース決定ゲート。サイトドキュメントのリンクは現在のMarkdownアドレスに移動。エキスパートパックとデプロイスキルで、デプロイ後に共有を提供(オプトイン、編集済み、最大1回)
• Deploy / Apps: クラウドアップロードチャネルがエンドツーエンドで完了するようになりました(deployAppはgetUploadUrlが返すタイムスタンプを受け入れ、getBuildLogはデプロイが返すビルドIDを受け入れます)。ゲートウェイルート作成は、書き込む前にアップストリームの存在を検証します
• Skills / Context: 新しいPostgreSQLアクセスパターンのベストプラクティススキル(バッチ処理、インデックス、RLSロールゲーティング、起動容量)。searchKnowledgeBaseのインラインスキル / OpenAPIカタログはオンデマンドで読み込まれるようになり、毎回のtools/listで43ツールのサーフェスが9.1%削減されます
• Runtime / Hosting: CloudRun FunctionモードはPORTをバインドしてはならず(関数フレームワークがバインドします)、CLOUDBASE_APIKEYを指定する資格情報決定ゲートを取得します。ホスティングのパスとプレフィックスは正規化され、先頭のスラッシュが空のディレクトリとして読み取られることはなくなりました
• Connectors: 国際サイトのWorkBuddyコネクタ(cloudbase-intl)は、国内版と同じconfig/source/**コーパスから構築されています — ローカルのstdioではなく標準のMCP OAuthを使用したリモートstreamableHttpで、中国サイトのホストは国際版に書き換えられます

v2.33.x (2026-09)

• Functions / Apps: 非同期ステータスクエリを備えたクラウド関数用のカスタムコンテナイメージデプロイ。クラウドアップロードチャネル(getUploadUrl + deployApp cosTimestamp)
• Env binding: envId / region / siteのフィールドレベルのフォールバックとしてのcloudbaserc.json(リテラル + {{env.KEY}})
• Errors / Skills: 構造化されたCodeによる一元化されたエラーガイダンス。仮想決済リファレンス。CodeBuddy IDE MCPアップグレードスキル。WorkBuddyエキスパート
• Cloud API / Deploy: callCloudApiがモニタリングとpostgresサービスを開きます。deployPlan / deployApplyによる宣言的デプロイ。cloud-api-operationsスキル

Releases · Star · Watch → Releases

これは何か

AI IDE(Cursor、Claude Code、Codex、CodeBuddyなど)はコード生成に優れています。通常、あなたを妨げるのはバックエンドです: スキーマ、権限、関数、ストレージ、環境、リリース。

CloudBaseは、Tencent CloudのAIネイティブなオールインワンバックエンドです(データベース、ストレージ、認証、クラウド関数、Cloud Runなど)。このリポジトリは、そのバックエンドをAIツールに接続するToolkitです:

このリポジトリは、npmパッケージ@cloudbase/cloudbase-mcp、Skills、AIプラグインを提供します。

独自のCloudBase環境は引き続き必要であり、AIが提案する機密性の高い操作は確認する必要があります。Toolkitは能力と経路を提供します — 判断は提供しません。

関連リポジトリ

公開および同期リポジトリはTencentCloudBaseの下にあります。このToolkitに直接関連するもの:

フルスタックにはPluginを、知識の制約のみが必要な場合はSkills単独を推奨します。マーケットプレイスIDEにはこのリポジトリを使用してください — 同じツールでnpx plugins addを同時に実行しないでください。

クイックスタート

最速の開始方法

このAIプロンプトをAI IDEにコピーしてください。エージェントがskill.mdを読み取り、セットアップを完了します:

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

最初のプロンプト

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とドキュメントDB、データモデル、CRUD、権限とセキュリティルール
• コンピューティング: クラウド関数 / Cloud Runの作成、デプロイ、呼び出し、デバッグ
• 認証とストレージ: ログイン方法、オブジェクトストレージ、データとの権限連携
• リリースと運用: 静的ホスティング / ミニプログラム公開。ログの検査と再デプロイ

Web、WeChatミニプログラム、バックエンドサービスに対応。プラットフォーム概要: CloudBaseドキュメント。

評価

管理された条件下で、同じTodoアプリケーションの概要とフロントエンドスキャフォールドを使用して、2つのバックエンドパスを比較しました: 従来のクラウドVM(自己管理のランタイム、プロセス、ネットワーク公開)とCloudBase(管理されたデータベース、匿名認証、関連するバックエンドサービス)。AIエージェントがエンドツーエンドの開発と検証を実行しました。モデルとタスク設定を考慮すると、CloudBaseパスは完了レイテンシ、トークン使用量、ツール呼び出し回数でより有利でした。これらの結果はモデル、エージェントフレームワーク、タスク定義に依存しており、その範囲を超えて一般化すべきではありません。

方法、データ、制限: 同一タスク評価: クラウド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接続モード

リモート(推奨): IDEはHTTP経由でTencent Cloud MCPに接続します。ローカルNodeは不要で、対話型クライアントはブラウザで認証を完了します。

環境が存在するサイトに一致するエンドポイントを選択してください — 2つのサイトは別々のアカウント、コンソール、資格情報を使用します。

ローカル: マシン上でnpx @cloudbase/cloudbase-mcp@latestを実行 — ローカルファイルシステムのアップロードやテンプレートのダウンロードを含む完全な機能。

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

リモート認証には2つのパスのいずれかがあります:

• OAuth（対話型、推奨）: URLのみを追加してください。IDEがブラウザを開いてログインと同意を行います。設定ファイルにキーは不要です。
• 静的認証情報（CI/CD）: 上記のenv_idヘッダーとともにX-TencentCloud-*を追加してください。

リモート利用のトレードオフ: ローカルファイルシステム機能（アップロード、テンプレートダウンロード）は利用できず、国際サイトではNoSQLツールはまだ公開されていません。

リモートURLはsite（domestic / intl、ap-singaporeの中国サイト環境でリージョンが曖昧な場合にのみ必要）も受け入れます。さらに、ツールを絞り込むためのenable_plugins / disable_pluginsも受け入れます。正規名はmcp/src/server.tsにあります。

リモートMCP E2E（公式SDKクライアント）: npm run test:hosted-mcp:e2e — apikey/OAuthモード、TLS非セキュアなステージング、環境変数についてはtests/hosted-mcp-e2e/README.mdを参照してください。認証情報がない場合はスキップされます（終了コード0）。

セルフホスト型クラウドモード: リモート呼び出し元に対してローカルファイルおよびプロセスツールを無効にするには、CLOUDBASE_MCP_CLOUD_MODE=true（またはMCP_CLOUD_MODE=true）を設定してください。

例

オンライン五目並べ: ニーズを説明し、Web + クラウドデータベース / リアルタイムを取得してデプロイします。
デモ: 五目並べ · 詳細: チュートリアル

ドキュメント

• MCPツール（tools.json）
• はじめに
• IDEセットアップ
• AIプラグイン
• テンプレート
• FAQ

FAQ

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

コミュニティ

アクティビティ

コントリビューター

MIT · TencentCloudBase