@brrainy/mcp

Official Model Context Protocol (MCP) bridge & 1-click auto-installer for the Brrainy AI Knowledge Platform.

Connect Claude Desktop, Cursor IDE, Windsurf, Cline, Roo Code, and Continue.dev seamlessly to your Brrainy personal knowledge graph.

⚡ Quick Start (Zero Config)

Run this single command in your terminal:

npx -y @brrainy/mcp

What happens automatically:

1. 🔍 Auto-Detects AI Agents: Scans your system for installed AI coding and productivity assistants (Claude Desktop, Cursor, Windsurf, Cline, etc.).
2. 🛡️ Safe Configuration: Safely injects the Brrainy MCP server block while preserving all pre-existing MCP tools and taking automatic .bak backups.
3. 🔑 1-Click OAuth Login: Opens your default browser to authorize Brrainy via PKCE.
4. 🎉 Ready to Use: Simply restart your AI applications!

💻 Manual Setup / Integration Token Mode

If you already have a Personal Integration Token from Space Settings → Integrations:

npx -y @brrainy/mcp --token=YOUR_PERSONAL_INTEGRATION_TOKEN

Or set the environment variable:

export BRRAINY_API_KEY="YOUR_PERSONAL_INTEGRATION_TOKEN"
npx -y @brrainy/mcp

🛠️ CLI Options & Safety Commands

npx @brrainy/mcp [options]

  (no args)             Auto-detect AI agents, configure configs, and authenticate.
  --install             Explicitly run auto-configuration installer.
  --dry-run             Preview all changes without writing anything to disk.
  --uninstall           Safely remove Brrainy MCP configuration from all AI agents.
  --token=<token>       Pass an integration token directly (bypasses browser OAuth).
  --url=<url>           Override default Brrainy MCP backend endpoint URL.
  --version, -v         Show CLI version.
  --help, -h            Show CLI help manual.

🛡️ Safety & Privacy Guarantees

• Zero Lock-in & Clean Uninstall: Run npx @brrainy/mcp --uninstall anytime to cleanly restore your original configuration files.
• Automatic Backups: Before editing any config file, a .bak backup copy is saved alongside your original file.
• Atomic File Writes: Config updates use atomic temporary file replacement to prevent file corruption.
• Non-Destructive Merge: Never overwrites existing MCP servers (PostgreSQL, GitHub, Brave Search, etc.).
• 100% Open & Auditable: Published package contains only dist/cli.js (under 60 KB compressed). Zero telemetry or background daemon processes.

🌐 Supported Clients

| AI Assistant / Client | Supported | Transport | | :--- | :---: | :--- | | Claude Desktop | ✅ | Stdio Bridge (Auto) / Streamable HTTP | | Cursor IDE | ✅ | Native Streamable HTTP / Stdio Bridge | | Windsurf (Codeium) | ✅ | Native Streamable HTTP / Stdio Bridge | | Cline / Roo Code | ✅ | Stdio Bridge / Native SSE | | Continue.dev | ✅ | Stdio Bridge |

📄 License

MIT © Brrainy