BANCS-Norway/claude_session_coordinator

Claude Session Coordinator

A flexible MCP server enabling multiple Claude AI sessions to coordinate work across machines through shared state management.

⚠️ Important Disclaimers

No Affiliation: Claude Session Coordinator (CSC) and BANCS AS are not affiliated with, employed by, endorsed by, or sponsored by Anthropic PBC. We receive no compensation or support from Anthropic. This is an independent community project.

Use at Your Own Risk: This software is provided "as is" without warranty of any kind. Users assume all risks associated with using this tool.

No Official Support: Anthropic has not reviewed, approved, or endorsed this tool. Anthropic is not responsible for this tool's functionality or support.

Overview

Claude Session Coordinator provides a storage adapter-based MCP server that enables multiple Claude sessions to:

• Share state and coordinate work
• Avoid conflicts when working in parallel
• Track progress across sessions
• Support multiple workflow patterns

Core Philosophy: Flexible primitives over opinionated workflows. The server provides simple, universal building blocks that support any coordination pattern.

Project Structure

This is a monorepo containing:

• packages/mcp-server/ - Python MCP server with storage adapters
• packages/homepage/ - Public documentation site (for Phase 2+ launch)
• docs/ - Shared architectural and implementation documentation

Quick Start

For Contributors/Development

Prerequisites:

• Python 3.10+
• Node.js 18+
• npm (comes with Node.js)

Setup:

# 1. Clone the repository
git clone https://github.com/BANCS-Norway/claude_session_coordinator.git
cd claude_session_coordinator

# 2. Install git hooks (automatic linting on commit)
npm install

# 3. Install Python MCP server package
cd packages/mcp-server
pip install -e ".[dev]"

See for detailed development guidelines.

For Users (Phase 1 - Development)

cd packages/mcp-server
pip install -e .

Quick Start with Claude Code

1. Install the MCP server:

   cd packages/mcp-server
   pip install -e ".[dev]"
   

2. Configure Claude Code:

   # Copy the template
   cp .mcp.json.template .mcp.json
   
   # Edit with your paths
   nano .mcp.json
   

3. Update .mcp.json with your actual paths:

   {
     "mcpServers": {
       "claude-session-coordinator": {
         "command": "/path/to/your/python3",
         "args": [
           "-m",
           "claude_session_coordinator"
         ],
         "env": {},
         "cwd": "/path/to/claude_session_coordinator"
       }
     }
   }
   

4. Restart Claude Code - the session coordinator will be available automatically!

Features

Storage Adapters

• Local File Adapter (Phase 1) - Simple JSON file storage
• Redis Adapter (Phase 2+) - Cross-machine coordination
• Custom Adapters - Implement your own backend

MCP Tools

• sign_on() - Claim an instance and establish session identity
• store_data() - Store data in scoped contexts
• retrieve_data() - Retrieve stored data
• list_keys() - Discover available keys in a scope
• list_scopes() - List all scopes with optional filtering
• delete_data() - Remove specific data
• delete_scope() - Remove entire scope
• sign_off() - Release session instance

MCP Resources

• session://context - Current session state and available instances
• session://state/{id} - Read other sessions' state (coordination)

MCP Prompts

• startup - Guides Claude through sign-on process
• sign-off - Guides proper session release

Development Status

Phase 1 (Current): MCP Server Core Implementation

• Storage adapter architecture
• Local file adapter
• Core MCP tools, resources, and prompts
• Internal testing and iteration

Phase 2 (Future): Public Launch

• Homepage and documentation site
• PyPI publishing
• Community announcement

Phase 3+ (Future): Ecosystem

• VS Code extension
• CLI tools
• Web dashboard
• Additional adapters

Documentation

Contributing

See for guidelines.

License

MIT License - See for details.

Support

This is a community project. For issues and feature requests, please use GitHub Issues.

Built by the community, for the community 🚀