brainCloud MCP Helper
Helper for brainCloud MCP that gives it local file access, enabling easy git sync of cloud code.
Links
README
From the repo.
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 | The MCP server itself — status / pull / push / sync tools, installable via npx -y @braincloud/mcp-helper@latest. |
@braincloud/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
Develop
npm install
npm run build # builds all workspaces
npm test # tests all workspaces
See RELEASING.md for the release process.
Config for your environment
Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.
Tool
OS
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "{MCP_ENDPOINT_URL}"
}
}
}Paste into mcpServers in the config file. Restart Cursor after saving.
If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.