brainCloud MCP Helper

com.braincloudservers由 braincloudservers.com 發布v6.0.0更新於 Oct 24, 2026

Helper for brainCloud MCP that gives it local file access, enabling easy git sync of cloud code.

發布方自己的服務:BrainDog

已驗證STDIO僅桌面檔案與儲存開發者工具

概覽

AI 產生的概覽

一個本機 stdio MCP 伺服器,為 AI 用戶端提供檔案系統存取,用來將 brainCloud 雲端程式碼腳本與本機資料夾和 git 同步。

可以做什麼
檢查同步狀態:以試執行方式將每個腳本分類為已同步、拉取、推送、衝突、新增或刪除,不寫入任何內容(status)。拉取變更:對無衝突腳本套用 brainCloud 到本機的更新,僅在設定 allowDeletes 時執行本機刪除。推送變更:透過一次批次匯入,將無衝突腳本的本機更新套用到 brainCloud。完整同步:雙向拉取與推送,對兩側都改動的腳本進行三方合併,在本機寫入 git 風格衝突標記並回報。所有工具都接收本機同步資料夾、短期票據和選用分支名稱。
適用情境
當你把 brainCloud 雲端程式碼腳本保存在本機 git 儲存庫,並希望 AI 助理在不把大量腳本資料送進模型上下文的情況下,對照 brainCloud 檢查、拉取、推送或合併這些腳本時使用。
執行需求
透過 stdio 在本機執行,通常以 npx 從 npm 套件啟動,因此需要 Node.js。需要一個本機同步資料夾,以及從託管版 braincloud-mcp 的 getSyncTicket 工具取得的短期、限定應用程式的票據;讀取票據用於 status 和 pull,寫入票據用於 push 和 sync。設計上需與該託管伺服器搭配使用。
安裝前請注意
push 和 sync 會寫入 brainCloud,可能變更或刪除雲端程式碼腳本;任一方向的刪除都只在設定 allowDeletes 時發生,除非確有需要,否則不要開啟。sync 會把 git 風格衝突標記寫入本機檔案。此助手本身不儲存憑證,但會處理由 AI 傳入的票據,應視為機密。批次腳本資料直接送往 Builder API,不經過模型。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 brainCloud MCP Helper,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@braincloud/mcp-helper

A local stdio MCP server that gives AI clients (Claude Code, Cursor, Codex, …) filesystem access for brainCloud cloud-code sync.

It is deliberately trustless: it never authenticates to brainCloud on its own and stores no credential. Every Builder API call is driven by a short-lived, app-scoped ticket the AI obtains from the hosted braincloud-mcp's getSyncTicket tool and passes in. Bulk script data flows helper → Builder API directly — never through the AI's context.

Format and sync logic come from @braincloud/cloudsync-core; this package is the Node filesystem + MCP shell around it.

Tools

ToolTicketWhat it does
statusreadDry-run: classify every script (in-sync / pull / push / conflict / new / delete). No writes.
pullreadApply brainCloud → local for non-conflicting changes. Local deletes only with allowDeletes.
pushwriteApply local → brainCloud for non-conflicting changes via one bulk import (addAndUpdateOnly).
syncwriteFull two-way sync: pull + push + 3-way merge for scripts changed on both sides (merge base recovered from brainCloud version history). Clean merges are applied + pushed; real conflicts get git-style <<<<<<< markers written locally and reported in conflicted. Deletes both ways only with allowDeletes.

All take rootDir (the local sync folder), ticket (from getSyncTicket), and an optional branch (defaults to the current git branch from .git/HEAD). pull/status work with a read ticket; push/sync need a write ticket. In pull/push, conflicts and opposite-direction changes are never auto-applied — only sync reconciles both directions and merges.

Configure as an MCP server

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

npx @latest keeps the helper current on each launch; pin a version for CI. Pair it with the hosted braincloud-mcp (which vends the tickets and runs the live-lock policy).

Develop

bash
npm installnpm run build --workspace @braincloud/cloudsync-core   # helper depends on the built corenpm test  --workspace @braincloud/mcp-helpernpm run build --workspace @braincloud/mcp-helper

來源:packages/mcp-helper/README.md,提交 921d3a3

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v6.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Brain 整合