mcpField
B
brainCloud MCP Helper

brainCloud MCP Helper

ローカル
github.com/getbraincloud開発ツール116 週間前に更新
リポジトリ

brainCloud MCP Helper について

brainCloud MCP Helper は、AI クライアントにファイルシステムへのアクセスを提供し、brainCloud のクラウドコードを同期するローカル stdio MCP サーバーです。ホスト型 braincloud-mcp の短期チケットを使い、双方向同期と三者マージに対応します。

主な機能

  1. 01書き込みなしで同期状態を分類
  2. 02競合しない変更の取得または送信
  3. 03三者マージによる双方向同期
  4. 04Git 形式の競合マーカー

活用シーン

  1. 01適用前のクラウドコード変更の確認
  2. 02ローカルスクリプトと brainCloud の同期
  3. 03クラウドスクリプトの同時編集の調整

MCP 対応

ローカル stdio MCP サーバーとして status、pull、push、sync ツールを提供します。Builder API 呼び出しに必要な短期チケットを発行するホスト型 `braincloud-mcp` と連携します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "com-braincloudservers-braincloud-mcp-helper": {
      "command": "npx",
      "args": [
        "-y",
        "@braincloud/mcp-helper"
      ]
    }
  }
}
起動コマンドnpx -y @braincloud/mcp-helper

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@braincloud/mcp-helper6.0.0

ツール

4

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
branchstringいいえ同期する Git ブランチ。.git/HEAD の現在のブランチがデフォルトです。フォルダーが Git リポジトリでない場合は、予約済みの no-branch キーが使用され、後から実際のブランチに移行できます。
ticketobjectはいホスト型 MCP の getSyncTicket ツールから取得した短期間有効なチケット。
ticket.appNamestringはい対象アプリ名（getSyncTicket から取得）。
ticket.baseUrlstringはいアプリ固有の Builder ベース URL（getSyncTicket から取得）。
ticket.expiresAtstringいいえチケットの有効期限（ISO-8601 形式、getSyncTicket から取得）。
ticket.authorizationstringはいAuthorization ヘッダー値（getSyncTicket から取得）。
rootDirstringいいえローカルの cloud-code 同期フォルダー（.ccjs ツリーと .bcsync）への絶対パス。省略可能です。省略した場合、ヘルパーは作業ディレクトリおよびその上位ディレクトリで最も近い .bcsync フォルダーを検出します。新規フォルダーでは、初回同期の前に明示的に指定してください。
confirmAppNamestringいいえ安全確認。以前に同期したフォルダーにコミット済みの .bcsync アプリマッピングがない場合にのみ必要です（古いヘルパーで同期した場合など）。このフォルダーをそのアプリと同期する意図があることを確認するため、チケットの appName を設定してください。.bcsync が存在すれば不要です。
adoptNoGitBranchbooleanいいえno-git の同期状態とアプリマッピングを現在の Git ブランチに移行することを確認します（no-branch エントリーを削除）。Git なしで初回同期したフォルダーが実際のブランチ上にある場合に、一度だけ必要です。以前の状態が取り残されないよう、ツールが確認を求めます。

詳細

@braincloud/mcp-helper

AI クライアント（Claude Code、Cursor、Codex、…）に、brainCloud のクラウドコード同期用のファイルシステムアクセスを提供するローカル stdio MCP サーバーです。

意図的に信頼を必要としない設計になっており、brainCloud に独自に認証することも、認証情報を保存することもありません。すべての Builder API 呼び出しは、AI がホスト型の braincloud-mcp の getSyncTicket ツールから取得して渡す、短時間有効なアプリ単位のチケットによって実行されます。スクリプトの一括データはヘルパーから Builder API へ直接送られ、AI のコンテキストを経由することはありません。

フォーマットと同期ロジックは @braincloud/cloudsync-core にあり、このパッケージはその周囲に Node ファイルシステムと MCP のシェルを提供します。

ツール

ツールチケット説明
status読み取りドライラン：すべてのスクリプトを分類します（同期済み／プル／プッシュ／競合／新規／削除）。書き込みは行いません。
pull読み取り競合のない変更について、brainCloud からローカルに適用します。ローカルでの削除は allowDeletes がある場合に限ります。
push書き込み競合のない変更について、単一の一括インポート（addAndUpdateOnly）でローカルから brainCloud に適用します。
sync書き込み完全な双方向同期：プル＋プッシュに加え、両側で変更されたスクリプトを3 ウェイマージします（マージベースは brainCloud のバージョン履歴から復元されます）。競合のないマージは適用してプッシュされ、実際の競合では git 形式の <<<<<<< マーカーがローカルに書き込まれ、conflicted で報告されます。双方向の削除は allowDeletes がある場合に限ります。

すべてのツールは rootDir（ローカル同期フォルダー）、ticket（getSyncTicket から取得）、および任意の branch（デフォルトでは .git/HEAD から取得した現在の git ブランチ）を受け取ります。pull／status は read チケットで動作し、push／sync には write チケットが必要です。pull／push では、競合や逆方向の変更は自動適用されません。両方向を調整してマージするのは sync のみです。

MCP サーバーとして設定する

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

npx @latest を使うと起動のたびにヘルパーが最新の状態に保たれます。CI ではバージョンを固定してください。チケットを提供し、ライブロックポリシーを実行するホスト型の braincloud-mcp と組み合わせてください。

開発する

npm install
npm run build --workspace @braincloud/cloudsync-core   # helper depends on the built core
npm test  --workspace @braincloud/mcp-helper
npm run build --workspace @braincloud/mcp-helper

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。