CloudBase AI ToolKit

@cloudbase/cloudbase-mcp

Tencent CloudBase 用 MCP サーバーです。 CloudBase AI Toolkit の一部です。

Model Context Protocol を介して、AI コーディングツールから CloudBase を操作できます。ログイン、データベース、関数、ストレージ、ホスティング、ログに対応しています。

英語 · 简体中文 · Toolkit の README · ドキュメント · 変更履歴 · 問題

このパッケージについて

@cloudbase/cloudbase-mcp は、CloudBase MCP サーバーの npm 配布パッケージです。Toolkit を構成する要素の 1 つです。

IDE が対応している場合は、プラグインを使用してください。MCP 設定のみが必要な場合は、このパッケージ単体を使用してください。

Toolkit の全体像、関連リポジトリ、IDE 対応状況については、リポジトリの README をご覧ください。

クイックスタート

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

CloudBase 環境が必要です。また、AI が提案する機密性の高い操作は、実行前に確認してください。

その他のインストール方法

接続モード

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

環境が存在するサイトに対応するエンドポイントを選択してください。2つのサイトではアカウントと認証情報が別々です。

OAuth（対話型、推奨）：URL だけで設定できます。IDE がログインと同意のためにブラウザーを開き、そこで環境を選択します。キーが設定ファイルに保存されることはなく、ローテーションも不要です。

{
  "mcpServers": {
    "cloudbase": {
      "type": "http",
      "url": "https://tcb-api.cloud.tencent.com/mcp/v1"
    }
  }
}

静的認証情報（OAuth に対応していないクライアントや CI/CD 向け）：エンドポイントと同じサイトで作成した env_id とキーのペアを追加します。

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

静的なキーのペアは、ローテーションまたは削除するまで有効です。OAuth セッションはログアウトすると終了します。ブラウザーでのフローを利用できない場合に限り静的な形式を使い、リポジトリには含めないでください。

ローカル：マシン上で npx @cloudbase/cloudbase-mcp@latest を実行します。ローカルファイルシステムへのアップロードやテンプレートのダウンロードを含む、すべての機能を利用できます。Node.js v18.15.0 以降が必要です。

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

リモート URL で site が使えるのは、サイトが曖昧になる中国サイトの ap-singapore 環境だけです。また、enable_plugins / disable_plugins（カンマ区切り）も指定できます。正式なプラグイン名については、このパッケージの src/server.ts を参照してください（例：env、database、functions、hosting、storage、pg_database、cloudrun、logs、feedback）。

セルフホスト Cloud モード：CLOUDBASE_MCP_CLOUD_MODE=true（または MCP_CLOUD_MODE=true）を設定すると、リモートの呼び出し元に対するローカルファイルおよびプロセスのツールが無効になります。

サイトとリージョン

ログイン／認証情報のサイトを選択するには TCB_SITE（domestic / intl）を設定し、API ルーティングには TCB_REGION を設定します。国内サイトと国際サイトは別々のアカウントシステムです。ap-singapore は両方のサイトに存在するため、国内サイトのシンガポールユーザーは TCB_SITE=domestic を設定する必要があります。設定しない場合、デフォルトは intl になります。プロジェクト単位の .cloudbase/project.json（{ site, region, envId }）にも対応しています。

リモートモードでは、サイトはエンドポイントのホスト自体で決まります。tcb-api.cloud.tencent.com は中国サイト、tcb-api.tencentcloud.com は国際サイトです。設定するための site クエリパラメーターはありません。これは中国サイトの ap-singapore 環境でも同じです。引き続き中国サイトのエンドポイントを使用してください。セルフホスト Cloud モードのデプロイでは、引き続き TCB_SITE 環境変数を使用できます。

実験的機能：MCP Apps パネル（デフォルトではオフ）

auth、queryEnv およびデプロイツールは、対応するホストで MCP Apps パネル（ui://cloudbase/*）を表示できます。この機能は実験的で、デフォルトではオフです。環境変数が設定されていない場合、ui:// リソースは登録されず、どのツールにも _meta.ui が付与されないため、ホストには通常の MCP サーバーとして認識され、結果はプレーンな JSON テキストのままです。

有効にするには CLOUDBASE_MCP_UI=on を設定します（1 / true / yes / enabled も使用できます）。それ以外（off、0、false、no、disabled、またはタイプミス）はオフのままになります。ツールの動作はどちらの場合も同じです。このフラグはパネルを提供するかどうかだけを決定します。

機能

お使いの環境で一般的に行うバックエンド作業（重要な手順は確認してください）：

• データベース：PostgreSQL とドキュメント DB、データモデル、CRUD、権限
• コンピューティング：クラウド関数／Cloud Run の作成、デプロイ、呼び出し、デバッグ
• 認証とストレージ：ログイン方法、オブジェクトストレージ、権限の連携
• リリースと運用：静的ホスティング／ミニプログラムの公開、ログの確認と再デプロイ

ツールカタログ：MCP ツール · tools.json

破壊的な呼び出しの前に確認

クラウド関数、コレクション、その中のドキュメント、保存済みファイル、CloudRun サービス、または MySQL インスタンスを削除する場合、対象を明示したダイアログ（「クラウド関数 hello（環境 env-abc）を削除しようとしています」など）に回答するまで、呼び出しは一時停止します。単に「本当によろしいですか？」と尋ねることはありません。callCloudApi として呼び出された場合も同様に一時停止しますが、対象となるのは明示的な service と Action の組み合わせに限られます。具体的には、tcb または scf の DeleteFunction、tcb.DeleteTable、tcb.DeleteItem、tcb.DestroyEnv、tcb.DestroyPlatformEnv、tcb.DestroyMySQL、tcbr.DeleteCloudRunServer、および IsDeleteServer が true の場合の tcbr.DeleteCloudRunVersions です。Delete で始まる名前でも、その他のクラウド API は確認の対象になりません。クラウドストレージの削除は callCloudApi を経由しません。PostgreSQL の execute／applyMigration が一時停止するのは、SQL 自体が DELETE、DROP、TRUNCATE、または ALTER … DROP の場合に限られます。INSERT、UPDATE、CREATE TABLE では一時停止しません。この機能は MCP のフォームによる引き出し機能を利用しているため、クライアントがその機能を宣言し、かつ実際にユーザーに確認を求める場合にのみ表示されます。

呼び出しの拒否は失敗ではありません。ツールは「実行されませんでした」と、代わりに行うべきことを返します。動作を変更する環境変数は2つありますが、どちらも認証、権限、読み取り専用の制限を回避するものではありません。変更するのは確認を求めるかどうかだけです。

クライアント独自のツール実行許可プロンプトは、この確認とは異なります。尋ねるのは「このツールを実行してもよいですか？」であり、「削除するリソースはこれでよいですか？」ではありません。

認証情報の形式に似た引数：書き込み前に実際の確認を1回実施

呼び出しの引数に認証情報のような形式の値（3つの部分からなるJWT、またはcb_secret_…／cb_publishable_… キー）が含まれている場合、サーバーは書き込み前にクライアントへ1回確認を求めます。値を元のソースと照合して確認してください。メッセージに平文は一切含まれません。含まれるのは全体の長さ、各セグメントの長さ（JWTの場合）、フィンガープリント（sha256の先頭12文字の16進数）のみです。これだけで、コピーや転記の際に値が変わったことに気付くには十分であり、会話やログにシークレットが残ることはありません。

この仕組みで行わないこと。 認証情報が有効かどうかは判定しません。署名検証も、certs／JWKSの検索も、いかなるネットワークリクエストも、サーバー側での照合も行いません。サーバーは最初に貼り付けた値を受け取らないため、照合できるのはクライアントだけです。これは書き込み時に実際の確認を求めるものであり、有効性のチェックではありません。

適用範囲。 引数に実際に認証情報の形式に似た文字列が含まれる場合にのみ適用されます（それ以外の場合、呼び出しに変更はありません。浅いスキャンを1回行うだけで、ネットワーク通信はありません）。クライアントがインタラクティブなフォームによる要求に対応している場合にのみ適用されます。確認を求められないクライアントは従来どおり処理を続けるため、無人クライアントがブロックされることはありません。また、数百ミリ秒以内に返された確認は「誰も確認していない」とみなされます。削除確認では、クライアントが自動で応答すると「確認を求められていない」と扱われ、呼び出しが続行されますが、認証情報の書き込みは実行されません。誰も照合していない値こそ、この仕組みで防ごうとしているケースだからです。ガードによって実行が拒否された場合、結果にはエラーとしてマークせず、**「実行されませんでした」**と表示されるため、モデルがむやみに再試行することはありません。

MCP Apps のスタートガイドパネル

クライアントがio.modelcontextprotocol/ui拡張を宣言している場合、authは読み取り専用の小さなパネル（ui://cloudbase/get-started）も開きます。このパネルは、auth呼び出しがすでに返した構造化された結果を利用し、接続状況をわかりやすい言葉で表示します。表示内容は、場所（サイトとリージョン。例：「上海（中国）」）、アクセス範囲、環境IDで、現在の状態に応じた主要なアクションが1つ表示されます（サインアウト状態ならサインイン、環境が未設定なら環境の選択、準備が整っていればサンプルプロジェクトの設定）。パネルが行う呼び出しは、読み取り専用のauth(status)のみで、「再確認」を押すと実行されます。それ以外のアクションは、会話に文を渡すだけです。生のレスポンスは「生のレスポンスを表示」に折りたたまれています。

MCP Appsを表示しないクライアントには影響しません。authのタイトル、説明、引数、出力は従来どおりで、resources/listも空のままのため、リソースブラウザーに新しい項目が表示されることはありません。

IDE 設定スニペット

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

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

その他：IDE のセットアップ。

ドキュメント

• ツールキットのREADME
• はじめに
• AIプラグイン
• よくある質問
• 変更履歴

License

MIT · TencentCloudBase