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 集成