Back to the catalog

brainCloud MCP Helper

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

Open source Open in the app JSON README (API)

About

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

Details

Kind
MCP servers
Topic
Files & documents
Publisher
com.braincloudservers
Origin
official
Category
ferramentas
Transport
local
Version
6.0.0
Stars
1
Forks
1
Last push
2026-07-10T18:46:29Z
Repository state
ativo
Language
TypeScript
License
Apache-2.0
Added
2026-08-29 03:01:01
Updated
2026-08-29 03:01:01
Origin id
com.braincloudservers/braincloud-mcp-helper

README

# braincloud-mcp-helper

A local, trustless MCP server that lets AI coding assistants (Claude Code, Cursor, Codex, …) sync
brainCloud cloud-code scripts to and from your filesystem and git repo.

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

## Packages

This is an npm workspace with two packages:

| Package | What it is |
|---|---|
| [`@braincloud/mcp-helper`](packages/mcp-helper) | The MCP server itself — `status` / `pull` / `push` / `sync` tools, installable via `npx -y @braincloud/mcp-helper@latest`. |
| [`@braincloud/cloudsync-core`](packages/cloudsync-core) | Host-agnostic sync/format logic (the `.ccjs` / `.bcsync` / `.bcsync.local` on-disk contract) shared with the VS Code extension. |

See each package's README for tool details, configuration, and the on-disk format.

## Learn more

Full setup and usage guide: [Syncing cloud code to local files with the brainCloud MCP helper](https://help.getbraincloud.com/en/articles/15695153-syncing-cloud-code-to-local-files-with-the-braincloud-mcp-helper)

## Develop

```bash
npm install
npm run build   # builds all workspaces
npm test        # tests all workspaces
```

See [RELEASING.md](RELEASING.md) for the release process.

More