Skip to content
This repository was archived by the owner on Aug 9, 2026. It is now read-only.

v1.1.0 - Brainstorm MCP (BUSL-1.1)

Latest
Latest

Choose a tag to compare

View all tags
@TheodorStorm TheodorStorm released this 29 Oct 11:07
· 1 commit to main since this release
v1.1.0
1adcc1f

Release v1.1.0 - Brainstorm MCP

Multi-agent collaboration server enabling multiple Claude Code instances to communicate and collaborate on the same computer.

📜 License

Business Source License 1.1 (BUSL-1.1)

Terms:

  • ✅ Non-production use permitted - Development, testing, and research are freely allowed
  • ⚠️ Production use requires commercial license - Contact licensor for production deployments
  • ⏰ Future open source - Automatic conversion to Apache License 2.0 on October 29, 2029

Scope:

  • Applies to v1.1.0 and all later versions

Why BSL? We chose BSL 1.1 to keep the code public and transparent while protecting the ability to develop commercial offerings. The code will automatically become fully open source (Apache 2.0) within 4 years.

✨ Features

Core Capabilities

  • Project-based collaboration between multiple Claude Code instances
  • Direct and broadcast messaging between agents
  • Resource sharing with granular permission controls
  • File-based storage with atomic operations
  • Session management with working directory persistence
  • Long-polling support for real-time updates

Security

  • Path traversal protection
  • Deny-by-default permission model
  • Input validation and sanitization
  • Race condition prevention

Developer Experience

  • MCP prompts for guided workflows
  • Context-aware command suggestions
  • Comprehensive error messaging
  • Auto-configuration scripts

🏗️ Architecture

Three-Layer Design

  1. MCP Protocol Layer (src/server.ts) - Exposes 14 tools and 8 prompts
  2. Storage Abstraction Layer (src/storage.ts) - File system with atomic operations
  3. Type System (src/types.ts) - Versioned data models

Migration-ready - All operations designed to map directly to SQL transactions for future database backend.

✅ Testing

All 57 tests pass, covering:

  • Security (path traversal, authorization, error sanitization)
  • Core functionality (projects, agents, messages, resources)
  • Edge cases (concurrency, invalid input, race conditions)

💡 What This Means for You

For Developers:

Use Brainstorm freely for:

  • Development environments
  • Testing and QA
  • Research and experimentation
  • Learning and experimentation

For Production:

Contact the licensor for commercial licensing options if you need to deploy Brainstorm in production.

Future Open Source:

On October 29, 2029, this code automatically becomes Apache 2.0 licensed (fully open source with no restrictions).

📖 Documentation

  • README.md - Quick start and overview
  • CLAUDE.md - Development guide for Claude Code
  • CONTRIBUTING.md - Contribution guidelines and license information
  • PROMPTS.md - MCP prompt documentation
  • CONCURRENCY.md - Concurrency patterns and best practices

🚀 Getting Started

# Install dependencies
npm install

# Build
npm run build

# Configure for Claude Code
npm run config

# Run tests
npm test

📞 Questions?

Licensing questions? Reach out via GitHub Issues

Want to contribute? See CONTRIBUTING.md

Full license terms: See LICENSE

Assets 2
Loading