basicdeploy-mcp

BasicDeploy MCP サーバー

エージェントがデプロイする永続ランタイムです。データベース、オブジェクトストレージ、Kafka ブローカー、公開 URL を、MCP の 1 回の呼び出しで利用できます。

AI コーディングエージェント（Claude Code、Cursor、およびあらゆる MCP クライアント）から BasicDeploy のコンテナを直接作成・管理できる MCP（Model Context Protocol） サーバーです。すべてのコンテナには、PostgreSQL データベース、S3 互換オブジェクトストレージ、Kafka ブローカー、環境変数、公開 HTTPS URL が自動的にプロビジョニングされます。エージェントは、コンテナの作成、アプリのデプロイ（Node、Python、Go、または Docker を自動検出）、コマンドの実行、ログの読み取り、Kafka トピックの管理、認証中のアカウントの確認、常時稼働の設定、コンテナの共有や削除を行えます。

• 🌐 サイト：https://basicdeploy.com
• 📦 npm：https://www.npmjs.com/package/basicdeploy-mcp
• 📚 ドキュメント：https://basicdeploy.com/docs

クイックスタート

Node.js ≥ 18 が必要です。インストールは不要です。npx が必要に応じて取得します。

https://basicdeploy.com/api-keys で API キーを取得し（bd_… の形式で、一度だけ表示されます）、以下を MCP クライアントに追加します。

{
  "mcpServers": {
    "basicdeploy": {
      "command": "npx",
      "args": ["-y", "basicdeploy-mcp@latest"],
      "env": {
        "BASICDEPLOY_API_KEY": "bd_your_api_key",
        "BASICDEPLOY_URL": "https://basicdeploy.com"
      }
    }
  }
}

Claude Code：

claude mcp add basicdeploy \
  --env BASICDEPLOY_API_KEY=bd_your_api_key \
  --env BASICDEPLOY_URL=https://basicdeploy.com \
  -- npx -y basicdeploy-mcp@latest

Claude Code プラグイン（このリポジトリはプラグインマーケットプレイスも兼ねています）：

/plugin marketplace add AkaciaNL/basicdeploy-mcp
/plugin install basicdeploy-mcp@basicdeploy

次に、環境に BASICDEPLOY_API_KEY を設定します（プラグインは ${BASICDEPLOY_API_KEY} を介して読み取ります）。

OpenAI Codex CLI：

codex mcp add basicdeploy \
  --env BASICDEPLOY_API_KEY=bd_your_api_key \
  --env BASICDEPLOY_URL=https://basicdeploy.com \
  -- npx -y basicdeploy-mcp@latest

または、~/.codex/config.toml に直接追加します。

[mcp_servers.basicdeploy]
command = "npx"
args = ["-y", "basicdeploy-mcp@latest"]
env = { BASICDEPLOY_API_KEY = "bd_your_api_key", BASICDEPLOY_URL = "https://basicdeploy.com" }

環境変数

変数	必須	説明
BASICDEPLOY_API_KEY	はい	API キー（bd_…）。ツールの呼び出しには必須です（サーバーはキーがなくても起動してツール一覧を表示するため、クライアントから内容を確認できます）。
BASICDEPLOY_URL	いいえ	API のベース URL。デフォルトは https://basicdeploy.com です。

ツール

ツール	引数	説明
list_containers	(none)	コンテナのサブドメイン、ステータス、URL、ID、作成日時を一覧表示します。
create_container	memoryMb? (256/512/1024/2048), alwaysOn?	コンテナを作成します。データベースと S3 バケットは自動的にプロビジョニングされます。大きいサイズには Pro/Scale が必要です。Free で常時稼働を有効にするには、有料アドオンの枠を使用します。
get_container	containerId	URL、ステータス、ポート、データベース名／ユーザー、S3 バケット、ボリュームのパスなど、詳細を取得します。
deploy_app	tarballPath, containerId?	ディスク上の .tar/.tar.gz/.tgz/.zip をデプロイします。/workspace に展開し、ランタイムを自動検出して、アプリを :8080 で起動します。containerId を省略すると新しいコンテナが作成され、既存のコンテナにデプロイする場合は指定します。
exec_command	containerId, command	コンテナ内でシェルコマンドを実行し、出力と終了コードを返します。
get_logs	containerId, tail? (default 200)	コンテナの最近のログを取得します。
set_always_on	containerId, enabled	コンテナの 24 時間 365 日の常時稼働設定をオン／オフにします。
wake_container	containerId	スリープ中のコンテナを起動して、再びトラフィックを処理できるようにします。
sleep_container	containerId	実行中のコンテナをスリープさせてメモリを解放します（次のリクエストで起動します）。
get_account	(none)	プラン、コンテナ上限（プランとアドオンを含む）、選択可能なメモリサイズ、ストレージ上限、アドオンを確認できます。
share_container	containerId, email, expiresInHours?	メールアドレスを使って別のユーザーとコンテナを共有します（相手にはサインインリンクが届きます）。無期限で共有する場合は expiresInHours を省略します。
delete_container	containerId	完全削除：コンテナ、そのデータベース、すべてのファイルを破棄します。
whoami	(none)	この接続で認証されているアカウント（メールアドレスと ID）を確認できます。
get_kafka	(none)	Kafka の接続情報（SASL/SCRAM）：内部／外部ブートストラップ、ユーザー名／パスワード、コンシューマーグループのプレフィックス、トピック、使用状況、上限を確認できます。初回呼び出し時にプロビジョニングされます。
create_topic	label?	Kafka トピックを作成します（プレフィックスに基づく名前空間が自動的に設定され、読みやすいラベルも任意で指定できます）。トピック数またはストレージの上限を超えると失敗します。
purge_topic	name	所有しているトピックを空にします（メッセージを削除し、トピックは保持します）。誤操作の後は処理を再開してください。
delete_topic	name	完全削除：所有しているトピックと、そのすべてのメッセージを削除します。

ランタイム

デプロイしたアプリは、公開 URL が使用するポート 0.0.0.0:8080 でリッスンする必要があります。DATABASE_URL、S3_ENDPOINT / S3_ACCESS_KEY / S3_SECRET_KEY / S3_BUCKET、および KAFKA_BOOTSTRAP / KAFKA_USERNAME / KAFKA_PASSWORD / KAFKA_GROUP_PREFIX は、コンテナ環境にあらかじめ設定されています。起動時の出力は /workspace/deploy.log に記録されます。

プロンプトの例

• 「常時稼働の 1GB コンテナを作成して、./dist/app.tar.gz をデプロイし、URL を教えてください。」
• 「blue-fox コンテナの直近 100 行のログを表示してください。」
• 「現在のプランと、実行できるコンテナ数を教えてください。」
• 「[email protected] とコンテナを 24 時間共有してください。」

ライセンス

MIT。BasicDeploy は Akacia（KVK 99629569、オランダ）の製品です。