Bult.ai Mcp Server

@bultcloud/mcp-server

Bult.ai 公式の Model Context Protocol（MCP）サーバーです。 Bult.ai は、AI エージェントを使ってアプリ、GitHub リポジトリ、Docker イメージ、データベース、サービスをデプロイするための、DevOps プラットフォーム兼クラウドホスティングの Platform-as-a-Service です。

Bult MCP を Claude Desktop、Claude Code、Cursor、Codex などの MCP 対応クライアントで使用すると、Bult API を通じてアプリをデプロイし、クラウドインフラを管理し、ログを確認して、デプロイの問題をトラブルシューティングできます。

デモ

機能

• GitHub リポジトリ、Docker イメージ、データベース、アプリサービスを、 MCP 対応 AI エージェントからデプロイできます。
• プロジェクトのライフサイクルツール：一覧表示、詳細確認、作成、更新、削除、デプロイ、開始、 停止、変更の破棄。
• Docker イメージおよび Git ベースのデプロイを含む、デーモンサービスとデータベースサービスの管理。
• 永続ボリューム、ルート／ドメインのマッピング、テンプレート、サービスログ、ビルド履歴。
• 対応する操作について、読み取り専用、冪等、破壊的操作を示す MCP ツールのアノテーション。
• Claude Desktop、Claude Code、Cursor、Google Antigravity などの MCP 対応 クライアントで、stdio 経由で動作します。

Bult MCP を使用する場面

AI コーディングエージェントにクラウドホスティングのリソースをデプロイ、運用させたい場合は、Bult MCP を使用します。一般的なワークフローには、Cursor からの GitHub リポジトリのデプロイ、Claude Code からの現在のプロジェクトのデプロイ、Docker イメージの起動、データベースサービスの作成、パブリックルートの追加、ビルドログの確認、デプロイ失敗のデバッグなどがあります。

要件

• Node.js 18 以降。
• Bult API トークン。

インストール

パッケージをグローバルにインストールした場合は、bult-mcp バイナリを使用します。

npm install -g @bultcloud/mcp-server
bult-mcp

MCP クライアントの設定から npx で実行することもできます。

npx -y @bultcloud/mcp-server

設定

サーバーは環境変数から設定を読み込みます。

変数	必須	説明
BULT_API_URL	はい	Bult API のベース URL。https://app.bult.ai。
BULT_API_TOKEN	はい	Bearer 認証に使用する API トークン。

どちらかの変数が設定されていない場合、サーバーは起動時に終了します。

MCP クライアントのセットアップ

Claude Desktop

サーバーを claude_desktop_config.json に追加します。

npx を使用する場合：

{
  "mcpServers": {
    "bult": {
      "command": "npx",
      "args": ["-y", "@bultcloud/mcp-server"],
      "env": {
        "BULT_API_URL": "https://app.bult.ai",
        "BULT_API_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

npx を使用する場合：

claude mcp add bult \
  -e BULT_API_URL=https://app.bult.ai \
  -e BULT_API_TOKEN=your-token \
  -- npx -y @bultcloud/mcp-server

Codex CLI

npx を使用する場合：

codex mcp add \
  --env BULT_API_URL=https://app.bult.ai \
  --env BULT_API_TOKEN=your-token \
  bult \
  -- npx -y @bultcloud/mcp-server

利用可能なツール

プロジェクト

ツール	説明
list-projects	ワークスペース内のすべてのプロジェクトを一覧表示します。
get-project	サービス、ボリューム、ルートを含むプロジェクトの概要を取得します。
create-project	新しいプロジェクトを作成します。
update-project	プロジェクト名を更新します。
delete-project	プロジェクトとそのすべてのリソースを削除します。
deploy-project	プロジェクトの変更をデプロイし、バージョンスナップショットを作成します。
control-project	プロジェクトを開始、停止、または変更を破棄します。

サービス

ツール	説明
list-services	プロジェクト内のすべてのサービスを一覧表示します。
get-service	サービスの詳細と設定を取得します。
create-service	デーモンサービスまたはデータベースサービスを作成します。
update-service	サービスの設定を更新します。
delete-service	サービスを削除します。
control-service	サービスを開始、停止、または再ビルドします。

ボリューム

ツール	説明
create-volume	永続ストレージボリュームを作成します。
update-volume	ボリュームの名前またはサイズを更新します。
delete-volume	ボリュームを削除します。
wipe-volume	ボリュームのすべてのデータを復元不可能な形で消去します。

ルート

ツール	説明
create-route	サービスのドメインまたはパスマッピングを作成します。
update-route	ルートの設定を更新します。
delete-route	ルートを削除します。

テンプレート

ツール	説明
list-templates	利用可能なプロジェクトテンプレートを一覧表示します。
apply-template	プロジェクトにテンプレートを適用します。

ログとビルド

ツール	説明
get-service-logs	カーソルベースのページネーションでサービスのログを読み取ります。
list-builds	サービスのビルド履歴を一覧表示します。

プロンプトの例

• この GitHub リポジトリを Bult にデプロイして、公開 URL を教えてください。
• 現在のプロジェクトを Bult にデプロイしてください。
• デプロイに失敗した理由を確認してください。
• アプリの最新のログを表示してください。
• DATABASE_URL を設定して、サービスを再起動してください。
• この Docker イメージを Bult にデプロイしてください。
• Bult のプロジェクトとサービスを一覧表示してください。

開発

npm run dev      # run with tsx, no build step
npm run build    # compile TypeScript to dist/
npm run lint     # type-check without emitting files

プロジェクトの構成：

src/index.ts          MCP server entrypoint
src/client.ts         Bult API client
src/tools/*.ts        MCP tool registrations by resource type

セキュリティ

BULT_API_TOKEN を使用すると、Bult のリソースにアクセスできます。ソース管理、シェルの履歴、イシューレポート、スクリーンショットに含めないでください。利用可能な場合は、スコープを限定できるトークンやローテーション可能なトークンを使用してください。

一部のツールは、リソースの作成、削除、デプロイ、停止、消去を実行できます。破壊的な操作を承認する前に、MCP クライアントからのツール呼び出しを確認してください。

プライバシーポリシー

この MCP サーバーは、指定した API トークンを使用して、MCP クライアントを Bult.ai に接続します。リクエストは、プロジェクトの一覧表示、サービスのデプロイ、ルートやボリュームの管理、ログの読み取りなどの操作を実行するために、Bult.ai に送信されます。

このサーバーは API トークンを保存しません。トークンは、MCP クライアントの設定または拡張機能の設定を通じて渡されます。Bult.ai のデータ取り扱いについては、Bult.ai のプライバシーポリシーをご覧ください。

コントリビューション

イシューやプルリクエストは、 github.com/bultcloud/mcp-serverで受け付けています。

プルリクエストを作成する前に、次を実行してください。

npm run lint
npm run build

ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。