Repository navigation
SCI Colanode Bridge — REST + MCP for Cursor and agents (v0.0.1) #378
jose290594
started this conversation in
Show and tell
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
SCI Colanode Bridge
A Python REST + MCP service that talks to a self-hosted Colanode server, so Cursor (and other MCP clients) can list spaces, edit pages, manage databases, upload files, and more.
Built around
@colanode/client(Yjs/CRDT mutations, TUS uploads, sync). Pinned to Colanode v0.4.7.Repo: https://github.com/jose290594/sci_colanode_api
Branch:
development· Release:v0.0.1License: Apache License 2.0
What you get
/mcp/(trailing slash)/v1· OpenAPI at/docs/admin— add Colanode accounts, mint/rotatesc_mcp_…keys, copy the MCP snippetEach API key maps to one Colanode login. Docker is a single image with a persistent
/datavolume.Cursor
{ "mcpServers": { "sci-colanode": { "url": "https://your-bridge.example.com/mcp/", "headers": { "Authorization": "Bearer sc_mcp_…" } } } }Use the trailing slash on
/mcp/so theAuthorizationheader is not dropped on redirect.MCP coverage (v0.0.1)
Workspaces · spaces · node tree · folders · pages · files (upload / download) · databases, fields, views · records · channels / messages · collaborators · users.
Uploads wait until the file is Ready on the server. REST is better for downloads over ~5 MB.
Known gaps: record/user search needs a warmed FTS index on a fresh sidecar data dir (list + filter still works). Child order from
list_childrenmay not match a reorder until the list query exposes sort.Run it
Local (Python 3.10+, Node 22+): clone the repo, follow the README (
vendor/colanodeat tagv0.4.7, sidecarnpm install,.envfrom.env.example, thenpython -m sci_colanode_api.main). Openhttp://127.0.0.1:8786/adminand create the first account.Docker
Put HTTPS in front. Set a strong
BRIDGE_SECRET. Treat API keys like passwords.Happy to take feedback if this is useful for agent / MCP workflows.
All reactions